正在准备要上传的 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 而不是 -projectYOUR_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)