O recurso Jornadas para Android Studio aproveita os recursos de visão e raciocínio da IA para navegar e testar seu app com base nas suas instruções em linguagem natural. Seu conjunto de instruções, chamado de jornada, é convertido em ações que a IA realiza no app. Além disso, você pode escrever e descrever declarações mais complexas, que a IA avalia com base no que vê no dispositivo.
Como o Gemini decide quais ações realizar para atingir as metas, as jornadas são mais resilientes a mudanças sutis no layout ou comportamento do app, resultando em menos testes instáveis ao serem executados em diferentes versões do app e configurações de dispositivos.
É possível escrever e executar jornadas diretamente no Android Studio ou na linha de comando em qualquer dispositivo Android local ou remoto. O ambiente de desenvolvimento integrado oferece uma nova experiência de editor para criar jornadas e resultados avançados que ajudam você a entender melhor o raciocínio e a execução da jornada pelo Gemini.
Escrever uma jornada
O Android Studio oferece um modelo de arquivo e uma nova experiência de editor que facilita a criação e edição de jornadas. As jornadas são escritas usando a sintaxe XML para organizar a descrição e as etapas.
Para criar e começar a editar uma jornada, faça o seguinte:
- No painel Project do Android Studio, clique com o botão direito do mouse no módulo do app para o qual você quer escrever uma jornada.
- Selecione Novo > Teste de jornada.
Na caixa de diálogo que aparece, informe o nome e a descrição da jornada.
Uma caixa de diálogo no Android Studio usada para criar um arquivo de jornada. Clique em Concluir. O Android Studio cria um arquivo XML para sua jornada com o nome escolhido. Use a visualização Code para editar o XML diretamente ou a visualização Design para uma experiência de edição simplificada.
Ao visualizar sua jornada na visualização Design, use o campo de texto para descrever cada etapa. Cada etapa pode incluir ações descritivas que você quer que o Gemini execute ou declarações que você quer que ele avalie.
Pressione Enter no teclado para iniciar uma nova etapa na mesma jornada. Repita esse processo conforme necessário para cada etapa da jornada que você quer definir.
Configurar variantes de build
As jornadas são executadas em variantes de build específicas do app. Quando você cria uma jornada usando o assistente, o conjunto de testes gerado é configurado para ser executado na variante de build ativa no Android Studio.
No entanto, se você mudar a variante de build ativa no Android Studio (por exemplo, para uma variação de produto diferente, como demoDebug) sem atualizar a configuração, a execução da jornada vai falhar. Para corrigir isso, adicione a nova
variante à propriedade targetVariants no bloco testSuites do arquivo
build.gradle.kts (ou build.gradle) no nível do módulo.
Por exemplo, para configurar o pacote journeysTest para a variante demoDebug:
android {
// ...
testSuites {
create("journeysTest") {
// ...
targetVariants += listOf("demoDebug")
}
}
}
Dicas para escrever jornadas
Embora a IA seja capaz de entender a maioria das etapas escritas nos idiomas aceitos, seguir estas dicas para escrever jornadas pode gerar resultados mais precisos e esperados:
- Suponha que o app já esteja em primeiro plano:executar uma jornada inicia o app automaticamente. As etapas da jornada devem começar depois que o app for totalmente iniciado. Ou seja, não é necessário incluir "iniciar app" como uma etapa.
- Use uma linguagem sem ambiguidades:ser preciso minimiza interpretações erradas e melhora a confiabilidade.
| Em vez de | Faça isso |
|---|---|
| "Selecione o botão dispensar" | "Toque em 'Dispensar'" ou apenas "Dispensar" |
| "Digite 'aipo'" | "Digite 'aipo' na barra de pesquisa na parte de cima da tela inicial" |
| "Deslize para dispensar" | "Deslize para a esquerda para dispensar. O card não vai mais aparecer." |
- Inclua os critérios de sucesso como parte da etapa:isso ajuda o Gemini a entender melhor sua intenção e esclarece quando a ação está concluída e a próxima pode começar.
| Em vez de | Faça isso |
|---|---|
| "Selecione o botão de envio" | "Envie o e-mail tocando no botão "Enviar". Isso vai fechar o e-mail e levar você de volta à caixa de entrada." |
| "Ir para o carrinho de compras" | "Toque no ícone de carrinho de compras para acessar a página do carrinho. Verifique se ele contém zero itens" |
| "Clique no primeiro vídeo" | "Clique no primeiro vídeo e aguarde o carregamento completo" |
- Refine sua jornada:se a jornada não estiver sendo executada como esperado, confira os resultados e inspecione "Ação realizada" e o "Raciocínio" correspondente para entender por que o Gemini não executou as etapas como você esperava. Use essas informações para deixar suas instruções mais claras.
- Divida sua jornada em etapas mais específicas:embora a IA possa interpretar etapas de várias ações, às vezes, etapas discretas mais granulares podem melhorar a precisão e a capacidade de reprodução da jornada.
- "Erro: não foi possível concluir a ação na tentativa máxima permitida": se você encontrar esse erro, tente dividir as etapas com falha em duas ou mais etapas menores. Isso acontece porque esse erro ocorre quando a IA não consegue concluir a ação depois de tentar um número máximo de interações com seu app.
Recursos compatíveis e incompatíveis
Confira uma visão geral dos recursos compatíveis e ainda não totalmente compatíveis ao escrever jornadas. As listas a seguir não estão completas.
As seguintes ações são compatíveis em jornadas:
- Toque nos elementos da interface.
- Digitar para inserir texto em campos de texto.
- Deslize/role a tela em uma determinada direção para navegar na interface.
No momento, os seguintes recursos não são totalmente compatíveis ou podem ter um desempenho inconsistente:
- Gestos com vários dedos (por exemplo, pinçar para ampliar): interações que exigem dois ou mais pontos de contato na tela simultaneamente, como pinçar para ampliar ou reduzir o zoom ou deslizar com dois dedos.
- Tocar e manter pressionado: pressionar e manter um dedo pressionado por um período maior do que um toque padrão.
- Toque duas vezes: tocar rapidamente no mesmo local da tela duas vezes em rápida sucessão.
- Rotação/dobra da tela: processamento de mudanças na orientação do dispositivo (por exemplo, entre retrato e paisagem) ou no estado físico de dispositivos dobráveis (por exemplo, abertura ou fechamento).
- Memória: retenção e recuperação de informações, contexto ou entradas do usuário específicas em interações ou etapas anteriores.
- Contagem: rastreamento preciso de quantidades, frequências ou progresso.
- Instruções condicionais: execução de ações com base no atendimento de outras condições especificadas.
Os recursos e as funcionalidades estão sempre melhorando. Recomendamos que você confira esta página depois para saber mais sobre outros recursos e funcionalidades. Para ajudar a melhorar os programas, compartilhe seu feedback.
Executar sua jornada
Você pode executar a jornada em qualquer dispositivo local ou remoto disponível, assim como qualquer outro teste instrumentado, e o Android Studio gera resultados avançados que ajudam você a entender a execução da jornada.
Para testar uma jornada, faça o seguinte:
- Selecione um dispositivo de destino na barra de ferramentas principal, como faria ao executar um teste instrumentado.
- Navegue até o arquivo XML da jornada que você quer testar e abra-o no editor.
- No editor, faça o seguinte:
- Se você estiver na visualização Design, clique em
Executar jornada. - Se você estiver na visualização Código, clique em
Executar "teste" na margem
ao lado de onde o nome da jornada é definido no XML.
- Se você estiver na visualização Design, clique em
O Android Studio cria uma configuração Teste de trajetos para você e a executa no dispositivo de destino. Durante a execução, o Android Studio cria e implanta seu app, e se conecta ao Gemini para determinar quais ações realizar em cada etapa da jornada.
Executar jornadas em qualquer app pré-instalado
Você pode executar uma jornada em um app pré-instalado no dispositivo de teste. Isso é útil se você quiser testar uma versão de produção do app ou se ainda não atualizou o app para o Plug-in do Android para Gradle 9.0.0 ou mais recente.
- Abra ou crie um projeto atualizado para o Plug-in do Android para Gradle 9.0.0 ou mais recente.
- Escreva uma jornada.
- Edite a configuração de execução para a
jornada e adicione as seguintes variáveis de ambiente. Uma configuração de execução é
criada automaticamente quando você tenta executar uma jornada no Android Studio.
- Defina
JOURNEYS_CUSTOM_APP_IDcomo o ID do pacote do app de destino.
- Defina
- Execute a jornada que você editou. O Android Studio vai executar as etapas da jornada no app de destino especificado.
Executar uma jornada na linha de comando
Para executar o recurso Jornadas na linha de comando, use a CLI do Android.
Ver resultados
Quando o Android Studio concluir o teste da sua jornada, o painel de resultados do teste vai aparecer automaticamente para mostrar os resultados.
Em comparação com outros testes instrumentados que você pode executar no Android Studio, há algumas diferenças na forma como os resultados das jornadas são exibidos.
- O painel Testes divide a jornada em etapas discretas. Clique em cada etapa para saber mais sobre como o Gemini a executou.
- O painel Resultados mostra informações detalhadas para ajudar você a entender como o Gemini entendeu e raciocinou sobre sua jornada e como ela foi executada.
- As capturas de tela enviadas ao Gemini são mostradas como auxílio visual em cada ação da etapa.
- Cada ação realizada e o raciocínio do Gemini para isso são descritos ao lado de cada captura de tela.
- Cada ação na etapa é numerada.
Problemas conhecidos
- Ao testar uma jornada, todas as permissões do app são concedidas por padrão.
- Ao testar uma jornada em um dispositivo com o Android 15 (nível 35 da API), talvez você veja um aviso no dispositivo informando que o App não seguro foi bloqueado para AndroidX Crawler. Clique em Instalar mesmo assim para ignorar essa verificação. Também é possível Configurar opções do desenvolvedor no dispositivo e desativar a opção Verificar apps por USB.