Criar e testar seu Android App Bundle

Os Android App Bundles são a maneira recomendada de criar, publicar e distribuir apps em várias configurações de dispositivos. Os pacotes de apps também permitem recursos avançados, como envio de recursos do Google Play, Play Asset Delivery e experiências instantâneas. Se você está começando a adotar pacotes de apps ou está desenvolvendo para casos de uso mais avançados, esta página oferece uma visão geral das várias estratégias disponíveis para testar seu app em cada etapa do desenvolvimento.

Se você é novo nos pacotes de apps, leia Sobre os Android App Bundles.

Criar um pacote de apps usando o Android Studio

Se você estiver usando o Android Studio, poderá criar seu projeto como um pacote de apps assinado em apenas alguns cliques. Se você não estiver usando o ambiente de desenvolvimento integrado, poderá criar um pacote de apps na linha de comando. Em seguida, faça upload do pacote de apps no Play Console para testar ou publicar o app.

Para criar pacotes de apps, siga estes passos:

  1. Faça o download do Android Studio 3.2 ou versão mais recente. Essa é a maneira mais fácil de adicionar módulos de recursos e criar pacotes de apps.

  2. Crie um Android App Bundle usando o Android Studio. Você também pode implantar o app em um dispositivo conectado a partir de um pacote de apps modificando sua configuração de execução/depuração e selecionando a opção para implantar o APK do pacote de apps. Lembre-se de que usar essa opção resultará em tempos de build maiores em comparação com a criação e implantação de apenas um APK.

  3. Implante seu Android App Bundle usando-o para gerar APKs implantados em um dispositivo.

  4. Inscreva-se na assinatura de apps do Google Play. Caso contrário, não será possível fazer upload do seu pacote de apps para o Play Console.

  5. Publique seu pacote de apps no Google Play.

Implantar usando pacotes de apps com o Android Studio

É possível criar seu app como um Android App Bundle e implantá-lo em um dispositivo conectado diretamente do ambiente de desenvolvimento integrado. Como o ambiente de desenvolvimento integrado e o Google Play usam as mesmas ferramentas para extrair e instalar APKs em um dispositivo, essa estratégia de teste local ajuda a verificar o seguinte:

  • Você pode criar seu app como um pacote de apps.
  • O IDE pode extrair APKs para uma configuração de dispositivo de destino do pacote de apps.
  • Recursos separados em módulos são compatíveis com o módulo base do app.
  • Seu app funciona no dispositivo de destino como esperado.

Por padrão, quando você implanta seu app do Android Studio em um dispositivo conectado, o IDE cria e implanta APKs para a configuração do dispositivo de destino. Isso ocorre porque criar APKs para uma configuração de dispositivo específica é mais rápido do que criar um pacote de apps para todas as configurações de dispositivos compatíveis com seu app.

Se você quiser testar a criação do app como um pacote e implantar APKs desse pacote no dispositivo conectado, edite a configuração padrão de execução/depuração da seguinte forma:

  1. Selecione Run > Edit Configurations na barra de menus.
  2. Selecione uma configuração de execução/depuração no painel esquerdo.
  3. No painel direito, selecione a guia General.
  4. Selecione APK from app bundle no menu suspenso ao lado de Deploy.
  5. Caso seu app inclua uma experiência de app instantâneo que você queira testar, marque a caixa ao lado de Deploy as an instant app.
  6. Se o app incluir módulos de recursos, você poderá selecionar quais módulos quer implantar marcando a caixa ao lado de cada módulo. Por padrão, o Android Studio implanta todos os módulos de recursos e sempre implanta o módulo básico do app.
  7. Clique em Apply ou OK.

Quando você seleciona Run > Run na barra de menus, o Android Studio cria um pacote de apps e o usa para implantar apenas os APKs exigidos pelo dispositivo conectado e pelos módulos de recursos selecionados.

Criar e testar na linha de comando

As ferramentas que o Android Studio e o Google Play usam para criar seu pacote de apps e convertê-lo em APKs estão disponíveis na linha de comando. Ou seja, você pode invocar essas ferramentas na linha de comando para criar e implantar localmente seu app a partir de um Android App Bundle.

Essas ferramentas de teste local são úteis para:

  • Integrar versões configuráveis de pacotes de apps no servidor de integração contínua (CI) ou em outro ambiente de build personalizado.
  • Automatizar a implantação do seu app de um pacote de apps para um ou mais dispositivos de teste conectados.
  • Emular downloads do app no Google Play para um dispositivo conectado.

Criar um pacote de apps na linha de comando

Se você quiser criar seu pacote de apps na linha de comando, use bundletool ou o Plug-in do Android para Gradle.

Plug-in do Android para Gradle: criado pelo Google, esse plug-in é fornecido com o Android Studio e também está disponível como um repositório Maven. O plug-in define os comandos que podem ser executados na linha de comando para criar um pacote de apps. Embora o plug-in ofereça o método mais fácil de criar seu pacote de apps, você precisa usá-lo por meio de bundletool para implantar o app em um dispositivo de teste.

bundletool: essa ferramenta de linha de comando é usada pelo Plug-in do Android para Gradle e pelo Google Play para criar seu app como um pacote de apps e está disponível no GitHub (link em inglês). Lembre-se de que usar bundletool para criar seu pacote de apps é muito mais complicado do que simplesmente executar uma tarefa do Gradle usando o plug-in. Isso ocorre porque o plug-in automatiza alguns pré-requisitos para criar um pacote de apps. No entanto, essa ferramenta é útil para desenvolvedores que querem gerar artefatos de pacotes de apps no fluxo de trabalho de CI.

Para começar a criar seu pacote de apps com qualquer uma das abordagens, leia Criar seu app na linha de comando.

Implantar o app na linha de comando

Embora o Plug-in do Android para Gradle seja a maneira mais fácil de criar seu pacote de apps na linha de comando, é necessário usar bundletool para implantá-lo a partir de um pacote de apps em um dispositivo conectado. Isso porque o bundletool fornece comandos projetados especificamente para ajudar a testar seu pacote de apps e emular a distribuição por meio do Google Play.

Veja a seguir os diferentes tipos de cenários que podem ser testados usando bundletool:

  • Gere um conjunto de APKs que inclua APKs divididos para todas as configurações de dispositivos compatíveis com seu app. Normalmente, a criação de um conjunto de APKs é necessária para que bundletool implante seu app em um dispositivo conectado.
  • Implante seu app usando um conjunto de APKs em um dispositivo conectado. O bundletool usa o adb para determinar os APKs divididos necessários para cada configuração de dispositivo e implanta apenas esses APKs no dispositivo. Se você tiver vários dispositivos, também poderá passar o código para bundletool a fim de segmentar um dispositivo específico.
  • Teste localmente as opções de envio de recursos. É possível usar bundletool para emular o download e a instalação de módulos de recursos do Google Play, sem publicar seu app no Play Console. Isso será útil se você quiser testar localmente como seu app processa solicitações e falhas de download de módulo on demand.
  • Estime o tamanho de download do seu app para determinada configuração de dispositivo. Isso é útil para entender melhor a experiência do usuário de fazer o download do seu app e verificar se ele atende à restrição de tamanho de download compactado para pacotes de apps ou permite experiências instantâneas.

Testar seu pacote de apps no Google Play

Embora as outras estratégias de teste descritas nesta página não exijam que você faça upload do seu app para o Google Play, o teste usando o Play Console fornece a representação mais precisa da experiência do usuário. Seja para compartilhar seu app com as partes interessadas internas, sua equipe interna de controle de qualidade, um grupo fechado de testadores Alfa ou um público maior de testadores Beta, o Play Console oferece várias estratégias de teste.

Use o Play Console para testar seu app pelos seguintes motivos:

  • Você quer a representação mais precisa da experiência do usuário ao fazer o download do seu app e, opcionalmente, instalar recursos on demand.
  • Você quer fornecer acesso fácil a um grupo de testadores.
  • Você quer selecionar testes para os testadores de controle de qualidade, Alfa e Beta.
  • Você quer acessar um histórico de uploads de app que podem ser testados em um dispositivo. Por exemplo, se você quiser comparar versões para regressões de desempenho.

Compartilhar rapidamente seu app com um URL

Embora as faixas de teste do Play Console forneçam um método de progresso do app por meio de estágios de teste formais, às vezes você quer compartilhá-lo rapidamente com trusted testers em canais menos formais, como e-mail ou mensagem de texto.

Ao fazer upload do seu pacote de apps para a página de compartilhamento rápido do Play Console, você pode gerar um URL que pode ser facilmente compartilhado com outras pessoas. O compartilhamento do app dessa forma oferece os seguintes benefícios:

  • Autorize qualquer pessoa da sua equipe a fazer upload de builds de teste sem conceder acesso ao app no Play Console.
  • Os testadores têm acesso apenas à versão de teste específica do seu app que foi compartilhada com eles.
  • As versões de teste podem ser assinadas com qualquer chave ou não assinadas. Portanto, os usuários que fazem upload também não precisam acessar sua chave de produção ou de upload.
  • Os códigos de versão não precisam ser exclusivos. Portanto, você pode reutilizar um código de versão existente e não precisa incrementá-lo para fazer upload.
  • Teste opções de envio personalizado, como o download de recursos on demand e atualizações no app.
  • Capture dados e registros importantes compartilhando uma versão depurável do seu app.

Quando os usuários clicam no URL do dispositivo Android, o dispositivo abre automaticamente a Google Play Store para fazer o download da versão de teste do app. Para começar, saiba mais sobre os recursos e as restrições dessa estratégia de testes, consulte Compartilhar seu app com um URL ou assista ao vídeo abaixo.

Fazer o download de versões históricas do seu app

Você e seus testadores também podem fazer o download de versões históricas do app que foram enviadas para uma faixa de produção ou teste. Isso pode ser útil se, por exemplo, você quiser testar rapidamente uma versão anterior do app para verificar regressões de desempenho.

Acesse a página Explorador de pacotes de apps do Play Console e navegue até a guia de download de qualquer versão da qual você quer fazer o download para copiar o link de instalação. Como alternativa, se você souber o nome do pacote e o código da versão do app que quer testar, basta acessar o seguinte link no dispositivo de teste:

https://play.google.com/apps/test/package-name/version-code

Fazer upload do app para uma faixa de teste

Ao fazer upload do app e criar uma versão no Play Console, você pode progredir por vários estágios de teste antes de enviar para a produção:

  • Teste interno: crie uma versão de teste interno para distribuir seu app rapidamente para esse tipo de teste e para verificações de controle de qualidade.
  • Fechado: crie uma versão fechada para testar as versões de pré-lançamento do seu app com um conjunto maior de testadores. Depois de testar com um grupo menor de funcionários ou usuários de confiança, você poderá expandir seu teste para uma versão aberta. Na página "Versões de apps", uma faixa Alfa estará disponível como teste fechado inicial. Se necessário, crie e nomeie outras faixas fechadas.
  • Aberta: crie uma versão aberta depois de testar uma versão fechada. Esse tipo de versão pode incluir mais usuários de teste antes que o app seja colocado em produção.

O andamento do app em cada um desses estágios do teste permite que você abra o app para um público maior antes de lançá-lo para produção. Para mais informações sobre as faixas de teste do Play Console, acesse Configurar um teste aberto, fechado ou interno.

Usar relatórios de pré-lançamento para identificar problemas

Ao fazer upload de um APK ou pacote de apps para a faixa de teste aberta ou fechada, você pode identificar problemas em uma grande variedade de dispositivos que usam diferentes versões do Android.

O relatório de pré-lançamento no Play Console ajuda você a identificar possíveis problemas com:

  • Estabilidade
  • Compatibilidade com Android
  • Desempenho
  • Acessibilidade
  • Vulnerabilidades de segurança

Depois de fazer upload do pacote de apps, os dispositivos de teste iniciam e rastreiam seu app automaticamente por vários minutos. O rastreamento realiza ações básicas em intervalos de alguns segundos no seu app, como digitar, tocar e deslizar.

Após a conclusão dos testes, os resultados serão disponibilizados na seção Relatório de pré-lançamento do Play Console. Para saber mais, consulte o tópico de ajuda do Play Console sobre como Usar relatórios de pré-lançamento para identificar problemas.

Procurar e fazer o download de APKs para configurações específicas de dispositivos

Quando você faz upload do pacote de apps, o Play Console gera automaticamente APKs divididos e APKs diversos para todas as configurações de dispositivos compatíveis com seu app. No Play Console, você pode usar o Explorador de pacotes de apps para ver todos os artefatos de APK que o Google Play gera, inspecionar dados como os dispositivos compatíveis e a configuração de entrega do app, além de fazer o download dos APKs gerados para implantar e testar localmente.

Para saber mais, leia o tópico de ajuda do Play Console sobre como Analisar os detalhes do seu pacote de apps.

Testar o pacote de apps com o Firebase App Distribution

O Firebase App Distribution facilita a distribuição das versões de pré-lançamento do app para trusted testers. Assim, você pode receber feedback valioso antes do lançamento.

O App Distribution possibilita gerenciar todos os builds de pré-lançamento em um hub central e oferece a flexibilidade de distribuir esses builds diretamente do console ou usando as ferramentas de linha de comando que já fazem parte do fluxo de trabalho.

Há algumas etapas que você precisa seguir para ativar seu projeto para o Firebase App Distribution. Confira a seção Antes de começar da documentação do Firebase. Após configurar o projeto, escolha como você quer integrar o App Distribution ao seu fluxo de trabalho: