Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
O Firebase Test Lab oferece infraestrutura baseada na nuvem para testar
apps Android. Este documento descreve como começar a usar o Test Lab com o
console do Firebase.
Test Lab permite executar os seguintes tipos de testes:
Teste de instrumentação:
um teste escrito por você que permite conduzir a IU do seu app com as ações que
você especificar. Esse teste também pode fazer afirmações explícitas sobre
o estado do seu app para verificar a funcionalidade usando
AndroidJUnitRunnerAPIs. Test Lab oferece suporte
a frameworks de teste de instrumentação de
Espresso
e
UI Automator.
Teste Robo:
um teste que analisa a interface do app e a explora automaticamente
ao simular as atividades do usuário.
Teste de loop de jogo: um teste
que usa um "modo de demonstração" para simular ações de jogadores em apps de jogos.
Acesse o Console do Firebase
e crie um novo projeto caso ainda não tenha feito isso.
Etapa 2. Executar um teste
Teste de instrumentação
Na barra de navegação do console do Firebase,
clique em Test Lab e, depois, em Primeiros passos -> Executar um teste de
instrumentação.
Clique em Procurar, selecione o APK ou AAB do seu app e teste o APK ou
AAB antes de clicar em Continuar.
Selecione em quais dispositivos, níveis de API do Android,
orientações na tela e locais você quer testar o app para definir a matriz de teste. Só é possível
selecionar as combinações de dispositivo e nível de API do Android que você quer
usar para o teste.
(Opcional) Clique em Mostrar opções avançadas para alterar o Tempo limite do teste,
que determina a duração máxima de cada execução do teste.
(Opcional) Para ajudar a identificar e localizar as matrizes de teste no
Console do Firebase, adicione um identificador à matriz de teste. Para isso, insira um
nome no campo Identificador da matriz de teste (opcional).
Clique em Iniciar N testes, em que "N" é o número de configurações de teste
válidas da matriz de teste definida na tela. Cada
teste pendente aparece com um ícone de relógio azul enquanto aguarda a execução.
O ícone muda para um símbolo de verificação verde quando o teste é concluído.
Feito isso, clique no dispositivo listado na coluna
"Execução de teste" para ver os resultados do teste, como casos de teste, registros, capturas de tela e
vídeos.
Teste Robo
Na barra de navegação do console do Firebase,
clique em Test Lab e, depois, em Primeiros passos -> Executar um Teste Robo.
Clique em Procurar, selecione o APK do seu app e, em seguida, clique em Continuar.
Selecione em quais dispositivos, níveis de API do Android,
orientações na tela e locais você quer testar o app para definir a matriz de teste.
(Opcional) Clique em Mostrar opções avançadas para alterar as seguintes opções:
Tempo limite do teste, que determina a duração máxima de cada execução do teste.
As credenciais da conta de teste, que são usadas para fornecer credenciais a uma
conta de teste.
Os campos adicionais são usados como entrada de texto para outros campos de texto
no app.
(Opcional) Para ajudar a identificar e localizar as matrizes de teste no
Console do Firebase, adicione um identificador à matriz de teste. Para isso, insira
um nome no campo Identificador da matriz de teste (opcional).
Clique em Iniciar N testes, em que "N" é o número de configurações de teste
válidas da matriz de teste definida na tela. Cada
teste pendente aparece com um ícone de relógio azul enquanto aguarda a execução.
O ícone muda para um símbolo de verificação verde quando o teste é concluído.
Feito isso, clique no dispositivo listado na coluna
"Execução de teste" para ver os resultados do teste, como casos de teste, registros,
capturas de tela e vídeos.
Na página Test Lab do console do Firebase, clique em Executar seu primeiro teste > Executar um loop de jogo do Android.
Na seção Enviar app, clique em Procurar e, em seguida, selecione o arquivo
APK do app (caso ainda não tenha feito isso, gere um arquivo IPA para o app).
(Opcional) Para ajudar a identificar e localizar as matrizes de teste no
Console do Firebase, adicione um identificador à matriz de teste. Para isso, insira
um nome no campo Identificador da matriz de teste (opcional).
(Opcional) Para executar vários loops, ou cenários, de uma só vez ou
selecionar loops específicos, insira os números de loop no
campo Cenários.
Por exemplo, quando você insere "1-3, 5", Test Lab executa os loops 1, 2, 3 e 5.
Por padrão (se você não inserir nada no campo Cenários),
Test Lab só executa o loop 1.
Na seção Dispositivos, selecione um ou mais dispositivos físicos em que você
quer testar o app e clique em Iniciar testes.
Etapa 3. Analisar os resultados do teste
Quando o teste inicia, você é redirecionado automaticamente para a página de resultados do teste.
Os testes podem demorar alguns minutos para serem executados, dependendo da quantidade de configurações diferentes que você selecionou e do tempo limite definido para os testes. Uma vez finalizados os testes, analise os resultados. Consulte
Como analisar os resultados de Firebase Test Lab para saber mais
sobre como interpretar os resultados do teste.
[null,null,["Última atualização 2025-08-16 UTC."],[],[],null,["\u003cbr /\u003e\n\nFirebase Test Lab provides cloud-based infrastructure for testing\nAndroid apps. This document describes how to get started with Test Lab using the\nFirebase console.\n\nTest Lab lets you run the following types of tests:\n\n- [Instrumentation test](/docs/test-lab/android/instrumentation-test):\n A test you write that allows you to drive the UI of your app with the actions\n you specify. An instrumentation test can also make explicit assertions about\n the state of your app to verify correct functionality using\n [AndroidJUnitRunnerAPIs](https://developer.android.com/reference/android/support/test/runner/AndroidJUnitRunner). Test Lab supports\n [Espresso](https://developer.android.com/training/testing/espresso)\n and\n [UI Automator](https://developer.android.com/training/testing/other-components/ui-automator) instrumentation test frameworks.\n\n- [Robo test](/docs/test-lab/android/robo-ux-test):\n A test that analyzes your app's interface and then explores it automatically\n by simulating user activities.\n\n- [Game loop test](/docs/test-lab/android/game-loop): A test\n that uses a \"demo mode\" to simulate player actions in game apps.\n\nBefore you begin\n\nYour Firebase project must be on the [pay-as-you-go Blaze pricing plan](/pricing), which means that\nyour project is linked to a Cloud Billing account. You can\n[upgrade to the Blaze pricing plan](//console.firebase.google.com/project/_/overview?purchaseBillingPlan=metered)\nin the Firebase console. You need to be an Owner or Editor for your project\nto link a Cloud Billing account.\n\nStep 1. Create a Firebase project\n\nIf you haven't yet, go to the [Firebase console](https://console.firebase.google.com/)\nand create a new Firebase project.\n| **Note:** If you're working on a shared Firebase project, you'll need to have ownership or edit permissions for the project.\n\nStep 2. Run a test \n\nInstrumentation test**Note:** If you want to run an instrumentation test with [Android Test Orchestrator](https://developer.android.com/training/testing/junit-runner.html#using-android-test-orchestrator), see [Enable Orchestrator](/docs/test-lab/android/instrumentation-test#orchestrator).\n\n1. On the [Firebase console](https://g.co/firebase) navigation bar,\n click **Test Lab** , and then click **Get Started -\\\u003e Run an Instrumentation\n test**.\n\n2. Click **Browse** , and then browse to your app APK or AAB and test APK or\n AAB before clicking **Continue**.\n\n3. Define your test matrix by selecting which devices, Android API levels,\n screen orientations and locales you want to test your app against. You can\n select only those device and Android API level combinations that you want\n to target for testing.\n\n4. (Optional) Click **Show advanced options** to change the Test timeout\n that determines the maximum duration of each test execution.\n\n5. (Optional) To help you identify and locate your test matrices in the\n Firebase console, you can add a label to your test matrix by entering a\n label name in the **Test matrix label (optional)** field.\n\n6. Click **Start *N* Tests**, where \"N\" is the number of valid test\n configurations from the test matrix that you define on this screen. Each\n pending test is shown with a blue clock icon while it is waiting to run,\n and that icon changes to a green check icon when the test has completed.\n\n7. After each test has run, click the device listed in the Test Execution\n column to see test results, including test cases, logs, screenshots and\n videos.\n\nRobo test\n\n1. On the [Firebase console](https://g.co/firebase) navigation bar,\n click **Test Lab** , and then click **Get Started -\\\u003e Run a Robo test**.\n\n2. Click **Browse** , browse to your app APK, and then click **Continue**.\n\n3. Define your test matrix by selecting which devices, Android API levels,\n screen orientations and locales you want to test your app against.\n\n4. (Optional) Click **Show advanced options** to change the following options:\n\n - Test timeout determines the maximum duration of each test execution.\n - Test account credentials are usedis used to provide credentials for a test account.\n\n | **Caution:** Never use this option with real user accounts.\n - Additional fields are used to provide text input for other text fields in your app.\n\n | **Note:** To learn more about Test account credentials and additional fields, see [Test account sign-in and predefined text](/docs/test-lab/robo-ux-test#test_account_sign-in_and_predefined_text_input).\n5. (Optional) To help you identify and locate your test matrices in the\n Firebase console, you can add a label to your test matrix by entering\n a label name in the **Test matrix label (optional)** field.\n\n6. Click **Start *N* Tests**, where \"N\" is the number of valid test\n configurations from the test matrix that you define on this screen. Each\n pending test is shown with a blue clock icon while it is waiting to run,\n and that icon changes to a green check when the test has completed.\n\n7. After each test finishes running, click the device listed in the Test\n Execution column to see test results, including test cases, logs,\n screenshots and videos.\n\nIf you want to create a script to guide the Robo test, see\n[Record a Robo script using Test Lab in Android Studio](/docs/test-lab/android/run-robo-scripts#record-android-studio).\n\nGame Loop test\n\n1. On the Test Lab page of the [Firebase console](https://console.firebase.google.com/project/_/%0Atestlab), click **Run Your First Test \\\u003e Run an Android Game Loop**.\n\n2. In the **Upload App** section, click **Browse** , then select your app's\n APK file (if you haven't already, [generate an APK file](https://firebase.google.com/docs/test-lab/android/game-loop#run-testlab) for your app).\n\n3. (Optional) To help you identify and locate your test matrices in the\n Firebase console, you can add a label to your test matrix by entering\n a label name in the **Test matrix label (optional)** field.\n\n4. (Optional) If you want to run multiple loops or scenarios at a time, or\n select specific loops to run, enter the loop numbers in the\n **Scenarios** field.\n\n For example, when you enter \"1-3, 5\", Test Lab runs loops 1, 2, 3, and 5.\n By default (if you don't enter anything in the **Scenarios** field),\n Test Lab only runs loop 1.\n5. In the **Devices** section, select one or more physical devices you\n want to test your app on, then click **Start Tests**.\n\nStep 3. Investigate your test results\n\nWhen the test starts, you're automatically redirected to the test results page.\nTests can take a number of minutes to run, depending on the number of different\nconfigurations you have selected and the test timeout duration set for your\ntests. After your tests have run, you can review test results. See\n[Analyzing Firebase Test Lab Results](/docs/test-lab/android/analyzing-results) to learn more\nabout how to interpret the test results.\n| **Note:** For all test types, any uncaught exception will cause a test failure."]]
