如果遊戲應用程式是使用不同的 UI 架構建構，就很難自動化遊戲測試。遊戲迴圈測試可讓您將原生測試整合至 Test Lab，並輕鬆在所選裝置上執行測試。本指南說明如何準備使用 Firebase Test Lab 執行的遊戲迴圈測試。
關於遊戲迴圈測試
什麼是遊戲迴圈測試？
遊戲循環測試會模擬真實玩家的動作，以快速且可擴充的方式驗證遊戲是否能為使用者提供良好的效能。迴圈是指在遊戲應用程式上執行完整或部分測試。您可以在 Test Lab 中，在本機的模擬器或一組裝置上執行遊戲迴圈測試。遊戲迴圈測試可用於：
- 以使用者角度玩遊戲，您可以為使用者輸入內容編寫指令碼、讓使用者處於閒置狀態，或是以 AI 取代使用者 (例如，如果您在賽車遊戲中實作 AI，可以讓 AI 駕駛人負責處理使用者的輸入內容)。
- 以最高畫質設定執行遊戲，找出哪些裝置可支援。
- 執行技術測試，例如編譯多個著色器、執行這些著色器，並檢查輸出內容是否符合預期。
步驟 1：註冊 Test Lab 的自訂網址配置
在 Xcode 中選取專案目標。
按一下「資訊」分頁，然後新增網址類型。
在「網址配置」欄位中輸入
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 <UIApplicationOpenURLOptionsKey, id> *)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).
}
}
}
提早結束測試
根據預設，即使已執行所有迴圈，遊戲迴圈測試也會持續執行，直到達到五分鐘的逾時時間為止。達到逾時期限時，測試就會結束並取消任何待處理的迴圈。您可以在應用程式的 AppDelegate 中呼叫 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 程式碼簽署」
步驟 4：將應用程式打包以便上傳
為應用程式產生 IPA 檔案 (您稍後需要找出該檔案)。
在隨即顯示的下拉式選單中，依序按一下「產品」>「封存」。選取最新的封存檔，然後按一下「發布應用程式」。
在隨即顯示的視窗中，依序按一下「Development」>「Next」。
選用步驟：如要加快建構速度，請取消選取「從 Bitcode 重新建構」選項，然後按一下「Next」。Test Lab 不需要精簡或重建應用程式即可執行測試，因此您可以放心停用這個選項。
按一下「Export」，然後輸入要下載應用程式 IPA 檔案的目錄。
步驟 5：驗證應用程式簽名
- 如要驗證應用程式簽名，請解壓縮 .ipa 檔案，然後執行
codesign --verify --deep --verbose /path/to/MyApp.app，其中「MyApp」是解壓縮資料夾內的應用程式名稱 (每個專案的名稱皆不同)。預期的輸出內容為MyApp.app: valid on disk。
步驟 6：在本機執行測試
您可以在本機執行測試，檢查其行為，然後再透過 Test Lab 執行測試。如要在本機測試，請在模擬器中載入遊戲應用程式並執行：
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=1xcrun simctl openurl SIMULATOR_UDID firebase-game-loop://?scenario=2xcrun simctl openurl SIMULATOR_UDID firebase-game-loop://?scenario=5
後續步驟
使用 Firebase 控制台或 gcloud CLI 執行測試。