正在准备要上传的 XCUITest 测试
本指南提供了有关准备 XCUITest 测试以便上传到 App Center 测试的说明。
测试服务要求
- Xcode >= 9.4。1
- iOS >= 9。0
备注
现在可以使用 Xcode 12 和 iOS 14!
测试服务限制
- 只能测试上传的应用,不能通过应用或系统的其余部分进行交互。
用于测试的生成
若要在 App Center 中运行测试,需要生成应用程序和 XCUITest 捆绑包。 从应用程序项目目录的根目录中运行以下两个命令之一:
# How to build a xcodeproj
rm -rf DerivedData
xcrun xcodebuild build-for-testing \
-configuration Debug \
-project YOUR_XCODEPROJ \
-sdk iphoneos \
-scheme YOUR_APP_SCHEME \
-derivedDataPath DerivedData
YOUR_XCODEPROJ 应指向一个 .xcodeproj 文件,该文件可能标题为 PROJECT_NAME.xcodeproj 。 如果使用 .xcworkspace ,请使用 -workspace 而不是 -project 。 YOUR_APP_SCHEME 应该是用于生成应用程序的方案。 默认情况下,它通常是应用程序的名称。
Xcrun 将在目录中生成应用和 XCUITest 捆绑包 DerivedData/Build 。 您的应用程序和 XCUITest 捆绑包将位于 DerivedData/Build/Products/Debug-iphoneos/ 目录中。
xcrun xcodebuild -list
将测试上传到App Center
准备好测试套件后,接下来 设置测试运行 以上传和运行测试。
以下示例演示了如何将 XCUITest 套件上传到 App Center Test。
# Upload your test to App Center
appcenter test run xcuitest \
--app "APP_ID" \
--devices "DEVICE_SET_ID" \
--test-series "main" \
--locale "en_US" \
--build-dir DerivedData/Build/Products/Debug-iphoneos
有关将测试提交到 App Center 的具体示例,请参阅此 shell 脚本,该脚本将测试提交到 App Center。
其他屏幕截图和测试步骤
在每个测试方法结束时,将自动为测试报表拍摄屏幕截图。 每个屏幕截图都作为单独的测试App Center显示在测试 报告中。
活动
可以通过使用 Apple 的 对测试代码进行分组,为测试方法生成其他标签和屏幕截图 Activities 。 有关详细信息,请参阅使用活动 将测试分组 到子步骤中。
用于将测试代码包装在活动中的代码片段
[XCTContext
runActivityNamed:title
block:^(id<XCTActivity> _Nonnull activity) {
// test code
}];
XCTContext.runActivity(named: title) { (activity) in
// test code
}
手动屏幕截图
每个 的末尾都会自动生成测试报表的屏幕截图 Activity 。 通过使用 Activity XCUIScreen拍摄屏幕截图,然后使用 XCTAttachment创建附件,并添加到当前 ,可以在 中的不同点录制屏幕截图 Activity 。 此屏幕截图将显示在"测试App Center中,而不是显示在 末尾的默认屏幕截图 Activity 中。
在活动中生成和附加屏幕截图的代码片段
XCUIScreenshot *screenshot = [[XCUIScreen mainScreen] screenshot];
XCTAttachment *attachment;
attachment = [XCTAttachment attachmentWithScreenshot:screenshot];
[attachment setLifetime:XCTAttachmentLifetimeKeepAlways];
[activity addAttachment:attachment];
let screenshot = XCUIScreen.main.screenshot()
let attachment = XCTAttachment(screenshot: screenshot)
attachment.lifetime = .keepAlways
activity.add(attachment)