Pode ser difícil automatizar os testes de jogos quando os aplicativos de jogos são criados em diferentes estruturas de UI. Os testes do Game Loop permitem integrar seus testes nativos ao Test Lab e executá-los facilmente nos dispositivos que você selecionar. Este guia descreve como preparar um teste de Game Loop para execução usando o Firebase Test Lab.
Sobre os testes do Game Loop
O que é um teste de Game Loop?
Um teste de Game Loop simula as ações de um jogador real para verificar se o seu jogo tem um bom desempenho para os usuários de forma rápida e escalonável. Um loop é uma execução total ou parcial do teste no aplicativo de jogos. Você pode executar um teste de Game Loop localmente em um simulador ou em um conjunto de dispositivos no Test Lab. Os testes de Game Loop podem ser usados para:
- Execute seu jogo como um usuário final o jogaria. Você pode criar um script para a entrada do usuário, deixá-lo ocioso ou substituí-lo por uma IA (por exemplo, se você implementou a IA em um jogo de corrida de carros, você pode colocar um piloto de IA encarregado da entrada do usuário) .
- Execute seu jogo com a configuração de qualidade mais alta para descobrir quais dispositivos podem suportá-lo.
- Execute um teste técnico, como compilar vários shaders, executá-los e verificar se o resultado é o esperado.
Etapa 1 : registrar o esquema de URL personalizado do Test Lab
No Xcode, selecione um destino de projeto.
Clique na guia Informações e adicione um novo tipo de URL .
No campo Esquemas de URL , insira
firebase-game-loop. Você também pode registrar o esquema de URL personalizado adicionando-o ao arquivo de configuraçãoInfo.plistdo seu projeto em qualquer lugar dentro da tag<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>
Seu aplicativo agora está configurado para executar um teste usando o Test Lab.
Etapa 2 : opcionalmente, configure seu aplicativo
Execute vários loops
Se você planeja executar vários loops (também conhecidos como cenários) em seu teste, deverá especificar quais loops deseja executar em seu aplicativo no momento da inicialização.
No delegado do seu aplicativo, substitua o método application(_:open:options:) :
Rápido
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
}
Objetivo-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:).
}
}
Quando você executa vários loops no teste, o loop atual é passado como parâmetro para a URL usada para iniciar o aplicativo. Você também pode obter o número do loop atual analisando o objeto URLComponents usado para buscar o esquema de URL personalizado:
Rápido
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).
}
Objetivo-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).
}
}
}
Terminar um teste mais cedo
Por padrão, um teste de Game Loop continua em execução até atingir o tempo limite de cinco minutos, mesmo quando todos os loops tiverem sido executados. Quando o tempo limite é atingido, o teste termina e cancela quaisquer loops pendentes. Você pode acelerar seu teste ou encerrá-lo mais cedo chamando o esquema de URL personalizado do Test Lab firebase-game-loop-complete no AppDelegate do seu aplicativo. Por exemplo:
Rápido
/// End the loop by calling our custom url scheme.
func finishLoop() {
let url = URL(string: "firebase-game-loop-complete://")!
UIApplication.shared.open(url)
}
Objetivo-C
- (void)finishLoop {
UIApplication *app = [UIApplication sharedApplication];
[app openURL:[NSURL URLWithString:@"firebase-game-loop-complete://"]
options:@{}
completionHandler:^(BOOL success) {}];
}
Seu teste de Game Loop encerra o loop atual e executa o próximo loop. Quando não houver mais loops para executar, o teste termina.
Escreva resultados de testes personalizados
Você pode configurar o teste do Game Loop para gravar resultados de testes personalizados no sistema de arquivos do seu dispositivo. Dessa forma, quando o teste começa a ser executado, o Test Lab armazena os arquivos de resultados em um diretório GameLoopsResults no seu dispositivo de teste (que você mesmo deve criar). Quando o teste termina, o Test Lab move todos os arquivos do diretório GameLoopResults para o bucket do seu projeto. Lembre-se do seguinte ao configurar seu teste:
Todos os arquivos de resultados são carregados independentemente do tipo, tamanho ou quantidade do arquivo.
O Test Lab não processa os resultados do teste até que todos os loops do teste tenham terminado de ser executados. Portanto, se o teste incluir vários loops que gravam a saída, anexe-os a um arquivo de resultados exclusivo ou crie um arquivo de resultados para cada loop. Dessa forma, você pode evitar a substituição dos resultados de um loop anterior.
Para configurar seu teste para gravar resultados de teste personalizados:
No diretório
Documentsdo seu aplicativo, crie um diretório chamadoGameLoopResults.De qualquer lugar no código do seu aplicativo (por exemplo, no delegado do seu aplicativo), adicione o seguinte:
Rápido
/// 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. } }Objetivo-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]; } }
Etapa 3 : assine seu aplicativo
Certifique-se de que todos os artefatos no aplicativo estejam assinados. Por exemplo, você pode fazer isso por meio do Xcode especificando configurações de assinatura, como perfil de provisionamento e identidade. Para obter mais informações, consulte: Apple Codesigning
Etapa 4 : empacotar seu aplicativo para upload
Gere um arquivo IPA para seu aplicativo (você precisará localizá-lo mais tarde).
No menu suspenso exibido, clique em Produto > Arquivo . Selecione o arquivo mais recente e clique em Distribuir aplicativo .
Na janela que aparece, clique em Desenvolvimento > Próximo .
Opcional: para obter uma compilação mais rápida, desmarque a opção Reconstruir a partir do Bitcode e clique em Avançar . O Test Lab não exige redução ou reconstrução do seu aplicativo para executar um teste, portanto você pode desativar essa opção com segurança.
Clique em Exportar e insira um diretório no qual deseja fazer download do arquivo IPA do seu aplicativo.
Etapa 5 : verifique a assinatura do aplicativo
- Verifique a assinatura do aplicativo descompactando o arquivo .ipa e executando
codesign --verify --deep --verbose /path/to/MyApp.apponde "MyApp" é o nome do aplicativo dentro da pasta descompactada (varia para cada projeto ). A saída esperada éMyApp.app: valid on disk.
Etapa 6 : execute seu teste localmente
Você pode executar seu teste localmente para verificar seu comportamento antes de executá-lo com o Test Lab. Para testar localmente, carregue seu aplicativo de jogo em um simulador e execute:
xcrun simctl openurl SIMULATOR_UDID firebase-game-loop://
Você pode encontrar o UDID do seu simulador executando o comando
instruments -s devices.Se houver apenas um simulador em execução, insira a string especial
"booted"no lugar de SIMULATOR_UDID .
Se o seu teste contiver vários loops, você poderá especificar qual loop deseja executar, passando o número do loop para o sinalizador scenario . Observe que você só pode executar um loop por vez ao executar o teste localmente. Por exemplo, se quiser executar os loops 1, 2 e 5, você deverá executar um comando separado para cada loop:
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
Próximos passos
Execute o teste usando o console do Firebase ou a CLI gcloud .