获取我们在 Firebase 峰会上发布的所有信息,了解 Firebase 可如何帮助您加快应用开发速度并满怀信心地运行应用。了解详情

开始使用 iOS 的 Game Loop 测试

借助 Game Loop 测试,您可以编写游戏引擎的原生测试,然后在您选择的设备上的测试实验室中运行它们。这样,您无需担心为不同的 UI 或测试框架编写代码。游戏循环测试模拟真实玩家的动作,当您在测试实验室运行它时,它提供了一种快速且可扩展的方式来验证您的游戏是否对用户表现良好。

此页面向您展示如何运行 Game Loop 测试,然后在 Firebase 控制台的测试实验室页面中查看和管理您的测试结果。您还可以使用可选功能进一步自定义测试,例如编写自定义测试结果提前结束测试

什么是游戏循环测试?

循环是您对游戏应用程序的测试的全部或部分运行。您可以在模拟器上本地运行游戏循环测试,也可以在测试实验室中的一组设备上运行游戏循环测试。游戏循环测试可用于:

  • 像最终用户玩游戏一样运行您的游戏。您可以编写用户输入脚本,让用户空闲,或者用 AI 替换用户(例如,如果您在赛车游戏中实现了 AI,则可以让 AI 驱动程序负责用户的输入) .

  • 以最高质量设置运行您的游戏,以了解哪些设备可以支持它。

  • 运行技术测试,例如编译多个着色器、执行它们并检查输出是否符合预期。

第 1 步:注册 Test Lab 的自定义 URL 方案

首先,您必须在您的应用中注册 Firebase 测试实验室的自定义 URL 方案:

  1. 在 Xcode 中,选择一个项目目标。

  2. 单击信息选项卡,然后添加新的URL 类型

  3. URL Schemes字段中,输入firebase-game-loop 。您还可以通过将自定义 URL 方案添加到项目的Info.plist配置文件中<dict>标记内的任何位置来注册它:

    <key>CFBundleURLTypes</key>
     <array>
         <dict>
             <key>CFBundleURLName</key>
             <string></string>
             <key>CFBundleTypeRole</key>
             <string>Editor</string>
             <key>CFBundleURLSchemes</key>
             <array>
                 <string>firebase-game-loop</string>
             </array>
         </dict>
     </array>
    

您的应用现在已配置为使用测试实验室运行测试。

第 2 步(可选):将您的应用配置为运行多个循环

如果您的应用注册了多个自定义 URL 方案,并且您计划在测试中运行多个循环(也称为场景),则您必须在启动时指定要在应用中运行的循环。

在您的应用委托中,覆盖application(_:open:options:)方法:

迅速

func application(_app: UIApplication,
                 open url: URL
                 options: [UIApplication.OpenURLOptionsKey : Any] = [:]) -> Bool {
    let components = URLComponents(url: url, resolvingAgainstBaseURL: true)!
    if components.scheme == "firebase-game-loop" {
        // ...Enter Game Loop Test logic to override application(_:open:options:).
    }
    return true
}

Objective-C

- (BOOL)application:(UIApplication *)app
            openURL:(NSURL *)url
            options:(NSDictionary &lt;UIApplicationOpenURLOptionsKey, id&gt; *)options {
  if ([url.scheme isEqualToString:(@"firebase-game-loop")]) {
      // ...Enter Game Loop Test logic to override application(_:open:options:).
  }
}

当您在测试中运行多个循环时,当前循环将作为参数传递给用于启动应用程序的 URL。您还可以通过解析用于获取自定义 URL 方案的URLComponents对象来获取当前循环编号:

迅速

if components.scheme == "firebase-game-loop" {
    // Iterate over all parameters and find the one with the key "scenario".
    let scenarioNum = Int(components.queryItems!.first(where: { $0.name == "scenario" })!.value!)!
    // ...Write logic specific to the current loop (scenarioNum).
}

Objective-C

if ([url.scheme isEqualToString:(@"firebase-game-loop")]) {
    // Launch the app as part of a game loop.
    NSURLComponents *components = [NSURLComponents componentsWithURL:url
                                             resolvingAgainstBaseURL:YES];
    for (NSURLQueryItem *item in [components queryItems]) {
        if ([item.name isEqualToString:@"scenario"]) {
            NSInteger scenarioNum = [item.value integerValue];
            // ...Write logic specific to the current loop (scenarioNum).
        }
    }
}

第 3 步:创建并运行测试

注册测试实验室的自定义 URL 方案后,您可以在Firebase 控制台或使用gcloud beta CLI运行测试。如果您还没有,请为您的应用程序生成一个 IPA 文件(稍后您需要找到它)。

在 Firebase 控制台中运行测试

  1. 如果您还没有,请打开Firebase 控制台并创建一个项目。

  2. 在 Firebase 控制台的测试实验室页面上,单击运行您的第一个测试 > 运行 iOS 游戏循环

  3. Upload App部分,点击Browse ,然后选择您的应用的 IPA 文件(如果您还没有,请为您的应用生成一个 IPA 文件)。

  4. 可选:如果您想一次运行多个循环(也称为场景)或选择要运行的特定循环,请在场景字段中输入循环编号。

    例如,当您输入“1-3, 5”时,测试实验室运行循环 1、2、3 和 5。默认情况下(如果您未在“场景”字段中输入任何内容),测试实验室仅运行循环 1。

  5. 在“设备”部分中,选择一个或多个要测试应用的物理设备,然后单击“开始测试”。

使用 gcloud beta CLI 运行测试

  1. 如果您还没有,请配置您的本地 gcloud SDK 环境,然后确保安装gcloud beta 组件

  2. 运行gcloud beta firebase test ios run命令并使用以下标志来配置运行:

游戏循环测试的标志
--type

必需:指定要运行的 iOS 测试的类型。您可以输入测试类型xctest (默认)或game-loop

--app

必需:应用的 IPA 文件的绝对路径(Google Cloud Storage 或文件系统)。此标志仅在运行游戏循环测试时有效。

--scenario-numbers

你想在你的应用程序中运行的循环(又名场景)。您可以输入一个循环、一个列表或多个循环或一系列循环。默认循环为 1。

例如, --scenario-numbers=1-3,5运行循环 1、2、3 和 5。

--device-model

您要在其上运行测试的物理设备(找出您可以使用的可用设备)。

--timeout

您希望测试运行的最长持续时间。您可以输入一个整数来表示以秒为单位的持续时间,或者输入一个整数和枚举来将持续时间表示为更长的时间单位。

例如:

  • --timeout=200强制您的测试在运行到 200 秒时终止。
  • --timeout=1h强制您的测试在运行一小时后终止。

例如,以下命令运行一个游戏循环测试,该测试在 iPhone 8 Plus 上执行循环 1、4、6、7 和 8:

gcloud beta firebase test ios run
 --type game-loop --app path/to/my/App.ipa --scenario-numbers 1,4,6-8
 --device-model=iphone8plus

有关 gcloud CLI 的更多信息,请参阅参考文档

在本地运行测试

要在本地运行测试,请在模拟器中加载您的游戏应用程序并运行:

xcrun simctl openurl SIMULATOR_UDID firebase-game-loop://
  • 您可以通过运行instruments -s devices命令找到您的模拟器的 UDID。

  • 如果只有一个模拟器在运行,输入特殊字符串"booted"代替SIMULATOR_UDID

如果您的测试包含多个循环,您可以通过将循环编号传递给scenario标志来指定要运行的循环。请注意,在本地运行测试时,一次只能运行一个循环。例如,如果要运行循环 1、2 和 5,则必须为每个循环运行单独的命令:

xcrun simctl openurl SIMULATOR_UDID firebase-game-loop://?scenario=1
xcrun simctl openurl SIMULATOR_UDID firebase-game-loop://?scenario=2
xcrun simctl openurl SIMULATOR_UDID firebase-game-loop://?scenario=5

提前结束测试

默认情况下,游戏循环测试会继续运行,直到达到五分钟的超时时间,即使所有循环都已执行。达到超时时,测试结束并取消任何未决循环。您可以通过在应用的 AppDelegate 中调用测试实验室的自定义 URL 方案firebase-game-loop-complete来加快测试或提前结束测试。例如:

迅速

/// End the loop by calling our custom url scheme.
func finishLoop() {
    let url = URL(string: "firebase-game-loop-complete://")!
    UIApplication.shared.open(url)
}

Objective-C

- (void)finishLoop {
  UIApplication *app = [UIApplication sharedApplication];
  [app openURL:[NSURL URLWithString:@"firebase-game-loop-complete://"]
      options:@{}
completionHandler:^(BOOL success) {}];
}

您的游戏循环测试终止当前循环并执行下一个循环。当没有更多循环要运行时,测试结束。

编写自定义测试结果

您可以配置 Game Loop 测试以将自定义测试结果写入设备的文件系统。这样,当测试开始运行时,测试实验室将结果文件存储在测试设备上的GameLoopsResults目录中(您必须自己创建)。测试结束时,测试实验室会将所有文件从GameLoopResults目录移动到项目的存储桶中。设置测试时请记住以下几点:

  • 无论文件类型、大小或数量如何,都会上传所有结果文件。

  • 在您的测试中的所有循环完成运行之前,测试实验室不会处理您的测试结果,因此如果您的测试包含多个写入输出的循环,请确保将它们附加到唯一的结果文件或为每个循环创建一个结果文件。这样,您可以避免覆盖前一个循环的结果。

要设置您的测试以编写自定义测试结果:

  1. 在应用程序的Documents目录中,创建一个名为GameLoopResults的目录。

  2. 从您的应用程序代码中的任何位置(例如,您的应用程序委托),添加以下内容:

    迅速

    /// Write to a results file.
    func writeResults() {
      let text = "Greetings from game loops!"
      let fileName = "results.txt"
      let fileManager = FileManager.default
      do {
    
      let docs = try fileManager.url(for: .documentDirectory,
                                     in: .userDomainMask,
                                     appropriateFor: nil,
                                     create: true)
      let resultsDir = docs.appendingPathComponent("GameLoopResults")
      try fileManager.createDirectory(
          at: resultsDir,
          withIntermediateDirectories: true,
          attributes: nil)
      let fileURL = resultsDir.appendingPathComponent(fileName)
      try text.write(to: fileURL, atomically: false, encoding: .utf8)
      } catch {
        // ...Handle error writing to file.
      }
    }
    

    Objective-C

    /// Write to a results file.
    - (void)writeResults:(NSString *)message {
        // Locate and create the results directory (if it doesn't exist already).
        NSFileManager *manager = [NSFileManager defaultManager];
        NSURL* url = [[manager URLsForDirectory:NSDocumentDirectory
                                      inDomains:NSUserDomainMask] lastObject];
        NSURL* resultsDir = [url URLByAppendingPathComponent:@"GameLoopResults"
                                                 isDirectory:YES];
        [manager createDirectoryAtURL:resultsDir
          withIntermediateDirectories:NO
                           attributes:nil
                                error:nil];
    
        // Write the result message to a text file.
        NSURL* resultFile = [resultsDir URLByAppendingPathComponent:@"result.txt"];
        if ([manager fileExistsAtPath:[resultFile path]]) {
            // Append to the existing file
            NSFileHandle *handle = [NSFileHandle fileHandleForWritingToURL:resultFile
                                                                     error:nil];
            [handle seekToEndOfFile];
            [handle writeData:[message dataUsingEncoding:NSUTF8StringEncoding]];
            [handle closeFile];
        } else {
            // Create and write to the file.
            [message writeToURL:resultFile
                     atomically:NO
                       encoding:NSUTF8StringEncoding error:nil];
        }
    }