本頁面由 Cloud Translation API 翻譯而成。

執行遊戲迴圈測試

如果遊戲應用程式是使用不同的 UI 架構建構，就很難自動化遊戲測試。遊戲迴圈測試可讓您將原生測試與 Test Lab，並在所選裝置上輕鬆執行。這個指南說明如何使用 Firebase Test Lab 準備遊戲迴圈測試。

關於遊戲迴圈測試

什麼是遊戲迴圈測試？

遊戲迴圈測試會模擬真實玩家的動作，驗證遊戲能否正常運作快速且可擴充迴圈是指測試遊戲應用程式。您可以在本機模擬工具或 Test Lab 中的一組裝置上執行遊戲迴圈測試。遊戲迴圈測試可用於：

以使用者角度玩遊戲，您可以編寫指令碼的輸入內容將使用者設為閒置狀態，或是將使用者替換為 AI 用途 (例如您導入 AI 技術就可以讓 AI 駕駛人掌握使用者的輸入內容。
以最高品質設定執行遊戲，找出支援這款遊戲的裝置。
執行技術測試 (例如編譯、執行及檢查輸出內容與預期結果相符

步驟 1：註冊 Test Lab 的自訂網址配置

在 Xcode 中選取專案目標。
按一下「資訊」分頁，然後新增網址類型。

在「URL Schemes」(網址配置) 欄位中輸入 firebase-game-loop。您也可以將自訂網址配置新增至專案的 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>

應用程式現已設為使用 Test Lab 執行測試。

步驟 2：視需要設定應用程式

執行多個迴圈

如果您打算在測試中執行多個迴圈 (即情境)，則必須指定您希望在啟動時在應用程式中執行的迴圈。

在應用程式委派作業中，覆寫 application(_:open:options:) 方法：

Swift

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:).
  }
}

在測試中執行多個迴圈時，系統會將目前的迴圈做為參數，藉此啟動應用程式。您也可以取得循環編號用於擷取自訂網址配置的 URLComponents 物件：

Swift

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).
        }
    }
}

提早結束測試

根據預設，即使已執行所有迴圈，遊戲迴圈測試仍會持續執行，直到達到五分鐘的逾時時間為止。當逾時，測試就會結束，並取消任何待處理的迴圈。您可以加快呼叫 Test Lab 的自訂網址通訊協定，即可提前結束測試或提早結束測試 firebase-game-loop-complete。例如：

Swift

/// 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 測試，將自訂測試結果寫入裝置的檔案系統。如此一來，當測試開始執行時Test Lab 將結果檔案儲存在測試的 GameLoopsResults 目錄中裝置 (您必須自行建立)。測試結束時，Test Lab 會移動從 GameLoopResults 目錄到專案值區的所有檔案。保留以下是設定測試時應注意的事項：

無論檔案類型、大小或數量為何，系統都會上傳所有結果檔案。
「Test Lab」在測試已完成，因此如果您的測試包含多個迴圈請務必將其附加至專屬的結果檔案或檔案。如此一來，就能避免覆寫上一個迴圈

如要設定測試以寫入自訂測試結果，請按照下列步驟操作：

在應用程式的 Documents 目錄中，建立名稱為 GameLoopResults。

在應用程式程式碼的任一位置 (例如應用程式委派) 中加入下列內容：

Swift

/// 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];
    }
}

步驟 3：簽署應用程式

確認應用程式中的所有構件皆已簽署。舉例來說，您可以透過 Xcode 指定簽署設定，例如測試群組設定檔和身分。詳情請參閱 Apple Codesigning。

注意：Test Lab 會透過專屬的佈建設定檔和憑證。

步驟 4：封裝應用程式以供上傳

為應用程式產生 IPA 檔案 (稍後會用到)。

在顯示的下拉式選單中，按一下「產品」封存檔。選取最新的封存檔案，然後點選「發布應用程式」。
在隨即顯示的視窗中，依序按一下「Development」>「Next」。
選用：如要加快建構速度，請取消選取「Rebuild from Bitcode」選項，然後點選「Next」。Test Lab 不必精簡或重建應用程式就能進行測試請安全地停用此選項
按一下「匯出」，然後輸入要下載的目錄應用程式的 IPA 檔案。

步驟 5：驗證應用程式簽章

解壓縮 .ipa 檔案，然後在「MyApp」位置執行 codesign --verify --deep --verbose /path/to/MyApp.app，以驗證應用程式簽章是解壓縮資料夾中的應用程式名稱 (依專案而異)。預期的輸出內容為 MyApp.app: valid on disk。

步驟 6：在本機執行測試

您可以在本機執行測試，在執行測試前 Test Lab。如要在本機上測試，請在模擬器中載入遊戲應用程式，然後執行下列指令：

xcrun simctl openurl SIMULATOR_UDID firebase-game-loop://

如要找出模擬器的 UDID，請執行 instruments -s devices 指令。
如果只有一個模擬工具正在執行，請輸入特殊字串 "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

後續步驟

使用 Firebase 控制台執行測試或使用 gcloud CLI