以不同建構方式建構遊戲應用程式時,很難自動執行遊戲測試 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 <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).
}
}
}
提早結束測試
根據預設,遊戲迴圈測試會持續執行,直到逾時為止
即使已執行所有迴圈也是如此當
逾時,測試就會結束,並取消任何待處理的迴圈。您可以加快
呼叫 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) {}];
}
遊戲迴圈測試會終止目前的迴圈,並執行下一個迴圈。 如果沒有其他可執行的迴圈,測試就會結束。
寫入自訂測試結果
您可以設定遊戲迴圈測試,將自訂測試結果寫入
裝置的檔案系統。如此一來,當測試開始執行時 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:簽署應用程式
確認應用程式中的所有構件皆已簽署。例如您可以用這個方式 也可以指定簽署設定,例如佈建設定檔和身分詳情請參閱 Apple Codesigning。
步驟 4:封裝應用程式以供上傳
為應用程式產生 IPA 檔案 (稍後會用到)。
在顯示的下拉式選單中,按一下「產品」封存檔。 選取最新的封存檔案,然後點選「發布應用程式」。
在隨即顯示的視窗中,按一下 開發 >下一步。
選用:如要加快建構速度,請取消選取 「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