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

Executar um teste de loop de jogo

Pode ser difícil automatizar o teste de jogos quando os aplicativos de jogos são criados em diferentes estruturas de interface do usuário. Os testes do Game Loop permitem integrar seus testes nativos com o Test Lab e executá-los facilmente nos dispositivos que você selecionar. Este guia descreve como preparar um teste de loop de jogo para ser executado usando o Firebase Test Lab.

Sobre os testes de loop de jogo

O que é um teste de loop de jogo?

Um teste de Game Loop simula as ações de um jogador real para verificar se seu jogo tem um bom desempenho para seus usuários de forma rápida e escalável. Um loop é uma execução total ou parcial do seu teste no seu aplicativo de jogos. Você pode executar um teste do Game Loop localmente em um simulador ou em um conjunto de dispositivos no Test Lab. Os testes de loop de jogo podem ser usados ​​para:

  • Execute seu jogo como um usuário final o jogaria. Você pode fazer o script da entrada do usuário, deixar o usuário ocioso ou substituir o usuário por uma IA (por exemplo, se você implementou a IA em um jogo de corrida de carros, pode colocar um motorista de IA responsável pela 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 a saída está conforme o esperado.

Etapa 1 : registrar o esquema de URL personalizado do Test Lab

  1. No Xcode, selecione um destino de projeto.

  2. Clique na guia Informações e adicione um novo tipo de URL .

  3. 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ção Info.plist do 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

Executar vários loops

Se você planeja executar vários loops (também conhecidos como cenários) em seu teste, deve 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 &lt;UIApplicationOpenURLOptionsKey, id&gt; *)options {
  if ([url.scheme isEqualToString:(@"firebase-game-loop")]) {
      // ...Enter Game Loop Test logic to override application(_:open:options:).
  }
}

Quando você executa vários loops em seu teste, o loop atual é passado como um 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 sendo executado até atingir um 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 há mais loops para executar, o teste termina.

Escreva resultados de teste personalizados

Você pode configurar o teste do Game Loop para gravar resultados de teste 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 em 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 de arquivo, tamanho ou quantidade.

  • O Test Lab não processa os resultados do teste até que todos os loops do teste terminem de ser executados, portanto, se o teste incluir vários loops que gravam a saída, certifique-se de anexá-los a um arquivo de resultado exclusivo ou criar um arquivo de resultado para cada loop. Dessa forma, você pode evitar sobrescrever os resultados de um loop anterior.

Para configurar seu teste para gravar resultados de teste personalizados:

  1. No diretório Documents do seu aplicativo, crie um diretório chamado GameLoopResults .

  2. De qualquer lugar no código do seu aplicativo (por exemplo, o 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 : empacotar seu aplicativo para upload

Por fim, gere um arquivo IPA para seu aplicativo (você precisará localizá-lo mais tarde).

  1. No Xcode, selecione um perfil de provisionamento para o aplicativo de destino.

  2. No menu suspenso exibido, clique em Produto > Arquivar . Selecione o arquivo mais recente e clique em Distribuir App .

  3. Na janela exibida, clique em Desenvolvimento > Avançar .

  4. Opcional: para obter uma compilação mais rápida, desmarque a opção Reconstruir do Bitcode e clique em Avançar . O Test Lab não requer afinamento ou reconstrução do seu aplicativo para executar um teste para que você possa desabilitar essa opção com segurança.

  5. Clique em Exportar e insira um diretório no qual deseja baixar o arquivo IPA do seu aplicativo.

Etapa 4 : 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 jogos 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 seu teste contiver vários loops, você poderá especificar qual loop deseja executar passando o número do loop para o sinalizador de scenario . Observe que você só pode executar um loop por vez ao executar seu teste localmente. Por exemplo, se você deseja executar os loops 1, 2 e 5, deve executar um comando separado para cada loop:

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

Próximos passos

Execute seu teste usando o console do Firebase ou a CLI do gcloud .