Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

Comece a testar com sistemas de integração contínua (CI)

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Você pode usar o Firebase Test Lab ao desenvolver seu aplicativo usando qualquer sistema de integração contínua (CI). Os sistemas de integração contínua permitem que você crie e teste automaticamente seu aplicativo sempre que fizer check-in de atualizações no código-fonte do aplicativo.

Usando o Firebase Test Lab com Jenkins CI

Esta seção descreve como usar o Test Lab com Jenkins CI .

Requisitos

Antes de usar o Firebase Test Lab com Jenkins, você precisa concluir as seguintes etapas:

  1. Configure gcloud. Siga as instruções de Como usar o Firebase Test Lab na linha de comando gcloud para criar um projeto do Firebase e configurar seu ambiente local do Google Cloud SDK.

  2. Crie e autorize uma conta de serviço. As contas de serviço não estão sujeitas a verificações de spam ou solicitações de captcha, que poderiam bloquear suas compilações de CI. Crie uma conta de serviço com função de editor no Google Cloud Console e ative-a (consulte a documentação gcloud auth activate-service-account para saber como).

  3. Ative as APIs necessárias. Depois de fazer login usando a conta de serviço: Na página Biblioteca de APIs do Google Developers Console , ative a API de teste do Google Cloud e a API de resultados da ferramenta Cloud . Para habilitar essas APIs, digite esses nomes de API na caixa de pesquisa na parte superior do console e clique em Habilitar API na página de visão geral dessa API.

Instalar e configurar o Jenkins

Você pode instalar e configurar o Jenkins CI no Linux ou no Windows. Certos detalhes deste guia são específicos para instalar e executar o Jenkins CI no Linux, incluindo o uso de barras ( / ) em caminhos de arquivo.

Para baixar e instalar o Jenkins em um computador com Linux ou Windows, siga as instruções em Instalando o Jenkins . Depois de instalar o Jenkins, siga as instruções em Iniciando e acessando o Jenkins para concluir a configuração e acessar o painel do Jenkins.

Definir configurações globais de segurança

Jenkins não tem autenticação de usuário e controle de acesso configurado quando é instalado pela primeira vez. Antes de usar o Jenkins com o Firebase Test Lab, defina as configurações de segurança global para aplicar o controle de acesso e autenticar usuários.

Para definir as configurações de segurança global

  1. Navegue até o painel do Jenkins em seu servidor. Para fazer isso, navegue até http://<servername>:8080 , onde <servername> é o nome do computador onde você instalou o Jenkins.
  2. No painel do Jenkins, clique em Gerenciar Jenkins e, em seguida, clique em Configurar segurança global .
  3. Na página Configurar segurança global , clique em Ativar segurança e, em seguida, clique em Salvar .

Para obter mais informações sobre como definir configurações de segurança para Jenkins, consulte Segurança rápida e simples , Configuração de segurança padrão e Protegendo Jenkins .

Criar um projeto Jenkins

Em seguida, crie um projeto para executar o teste de integração contínua do seu aplicativo com o Firebase Test Lab.

Para criar um projeto Jenkins

  1. Navegue até o painel do Jenkins em seu servidor. Para fazer isso, navegue até http://<servername>:8080 , onde <servername> é o nome do computador onde você instalou o Jenkins.
  2. No painel do Jenkins, clique em Novo item .
  3. Digite um nome para seu projeto no campo Nome do item :
    • Escolha Projeto Freestyle para criar um projeto que usa uma única configuração de construção.
    • Escolha Construir projeto de configuração múltipla para criar um projeto executado em várias configurações de compilação diferentes. Se você planeja criar seu aplicativo com uma variedade de configurações de compilação (várias localidades, vários níveis de API do Android etc.), um projeto de várias configurações é a melhor escolha.
  4. Clique em Salvar .

Depois que seu projeto é criado, seu navegador da Web exibe a página principal de seu projeto.

Adicionar controle de revisão e etapas de compilação do Gradle

Esta seção descreve como integrar o Jenkins com sistemas de controle de revisão, como o GitHub, e como adicionar etapas de compilação Gradle para criar pacotes APK a partir do código-fonte.

Integração com o GitHub e outros sistemas de controle de revisão

Se você usar o GitHub ou outro sistema de controle de revisão para gerenciar o código-fonte do seu aplicativo, poderá configurar o Jenkins para executar compilações automatizadas e executar testes sempre que as atualizações do seu aplicativo forem verificadas. Você também pode configurar o Jenkins para executar compilações periodicamente.

Para saber como configurar compilações no Jenkins, consulte Configurando compilações automáticas .

Adicionando etapas de compilação Gradle para recriar pacotes APK

Se você usar um sistema de controle de revisão para gerenciar o código-fonte do seu aplicativo, precisará incluir uma etapa de compilação do Gradle para criar novos binários do APK sempre que o Jenkins baixar o código-fonte de seu sistema de controle de revisão.

  1. Adicione uma etapa de compilação para executar os seguintes comandos no diretório principal de seu aplicativo:

    ./gradlew :app:assembleDebug
    ./gradlew :app:assembleDebugAndroidTest
    

  2. Adicione uma etapa de compilação para usar os pacotes APK criados pelo Gradle ao testar com o Test Lab. Você pode usar este caminho como o <local_server_path> no exemplo de script de shell fornecido abaixo, onde <AppFolder> é a pasta do projeto do Android Studio para seu aplicativo:

    <AppFolder>/app/build/outputs/apk
    

Adicionar etapas de compilação do Test Lab ao Jenkins

Agora você está pronto para adicionar uma etapa de compilação ao Jenkins para executar o Test Lab usando a linha de comando gcloud.

Para adicionar uma etapa de compilação do gcloud

  1. Na página principal do seu projeto, clique em Configurar .
  2. Na página de configuração do projeto , role para baixo até a seção Build e escolha Execute shell no menu Add build step .

  3. Na janela de comando Jenkins Execute shell , insira o seguinte, substituindo <local_server_path> pelo caminho para o aplicativo de amostra no servidor, <app_apk> pelo APK do seu aplicativo e <app_test_apk> pelo APK de teste do seu aplicativo:

    gcloud firebase test android run --app <local_server_path>/<app_apk>.apk
    --test <local_server_path>/<app_test_apk>.apk
    

Analisar os resultados do teste

Depois que o Test Lab concluir o teste de seu aplicativo, você poderá revisar os resultados do teste no console do Firebase ou em um bucket do Google Cloud Storage em seu projeto. Você também pode adicionar um comando gsutil ao comando shell mostrado acima para copiar os dados dos resultados do teste para o computador local. Para saber mais, consulte Analisando os resultados do laboratório de teste do Firebase .

Integração contínua com outros sistemas de CI

Para saber como usar o Firebase Test Lab com outros sistemas de CI, confira os documentos: