Com as Jornadas para Android Studio, você pode descrever fluxos do usuário completos em linguagem natural e executá-los diretamente com o agente de IA em um dispositivo conectado ou emulador. Seu conjunto de instruções, chamado de jornada, é convertido em ações que o agente realiza no app. Além disso, é possível escrever e descrever declarações mais complexas, que o agente avalia com base no que vê no dispositivo.
Como o agente raciocina sobre quais ações realizar para atingir as metas, as jornadas são mais resilientes a mudanças sutis no layout ou no comportamento do app, resultando em menos testes instáveis ao serem executados em diferentes versões do app e diferentes configurações de dispositivo.
É possível escrever e executar jornadas diretamente no Android Studio ou na linha de comando usando qualquer agente. Quando você executa uma jornada, o agente percorre o fluxo, verifica os resultados esperados e gera um relatório com capturas de tela que mostram se cada etapa foi aprovada ou reprovada.
Escrever uma jornada
As jornadas são escritas em XML para organizar a descrição e as etapas.
Os arquivos de jornada usam a extensão .journey.xml e são armazenados no
diretório src/journeysTest/ do módulo do app. O Android Studio oferece um
editor visual que facilita a criação e edição de jornadas. Não é necessário
fazer mudanças nos arquivos de build para usar as jornadas.
Para criar uma jornada, siga um destes procedimentos:
- 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 e selecione New > Journey File. Você também pode selecionar File > New > Journey File no menu principal.
- Na janela Agent, peça ao agente para criar uma jornada para um fluxo do usuário no seu app. Por exemplo, "Crie uma jornada que pesquise um produto, adicione-o ao carrinho e verifique se o carrinho mostra um item".
Para editar uma jornada, abra o arquivo dela. Use a visualização Code para editar o XML diretamente, a visualização Design para uma experiência de edição simplificada ou a visualização Split para ver as duas. Você também pode pedir ao agente para atualizar um arquivo de jornada atual.
Na visualização Design, cada linha é uma etapa da jornada. Digite uma ação que você quer que o agente execute ou uma declaração que você quer que o agente verifique e pressione Enter para adicionar a próxima etapa.
Dicas para escrever jornadas
Embora o agente seja capaz de entender a maioria das etapas escritas nos idiomas compatíveis, seguir estas dicas para escrever jornadas pode levar a resultados mais precisos e esperados:
- Suponha que o app já esteja em primeiro plano: a execução de uma jornada inicia o app automaticamente. As etapas da jornada precisam começar depois que o app for totalmente iniciado. Ou seja, não é necessário incluir "abrir app" como uma etapa.
- Use uma linguagem clara: ser preciso minimiza as interpretações erradas e melhora a confiabilidade.
| Em vez de | Faça isso |
|---|---|
| "Selecionar 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" |
| "Deslizar para dispensar" | "Deslize para a esquerda para dispensar. O card não deve mais estar visível" |
- Inclua os critérios de sucesso como parte da etapa: isso ajuda o agente a entender melhor sua intenção e esclarece quando a ação é 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 de envio. Isso vai fechar o e-mail e retornar à caixa de entrada." |
| "Ir para o carrinho de compras" | "Toque no ícone do carrinho de compras para acessar a página do carrinho. Verifique se ele não contém itens" |
| "Clique no primeiro vídeo" | "Clique no primeiro vídeo e espere até que ele seja totalmente carregado" |
- Refine sua jornada: se a jornada não estiver sendo executada como esperado, confira os resultados para entender por que o agente pode não ter executado as etapas como você esperava. Use essas informações para esclarecer melhor suas instruções.
- Divida sua jornada em etapas mais específicas: embora o agente possa interpretar etapas com várias ações, às vezes etapas discretas mais granulares podem melhorar a precisão e a reprodutibilidade da jornada.
Recursos e limitações compatíveis
Confira uma visão geral dos recursos compatíveis ao escrever jornadas e dos recursos que não são compatíveis ou que podem ter um desempenho inconsistente. As listas a seguir não são completas.
As seguintes ações são compatíveis com as jornadas:
- Toque em elementos da interface.
- Toque e pressione os elementos da interface.
- Digite para inserir texto em campos de texto.
- Deslize/role em uma determinada direção para navegar pela interface.
No momento, os seguintes recursos não são compatíveis:
- Gestos com vários dedos (por exemplo, gesto de pinça para controlar o zoom): interações que exigem dois ou mais pontos de contato na tela simultaneamente, como fazer gesto de pinça para aumentar ou diminuir o zoom ou deslizar com dois dedos.
Os seguintes recursos podem ter um desempenho inconsistente:
- Contagem: rastreamento preciso de quantidades, frequências ou progresso.
Os recursos e as capacidades estão sempre melhorando. Sugerimos que você consulte esta página mais tarde para Aprenda Mais sobre outros recursos e funcionalidades. Para nos ajudar a melhorar as Jornadas, compartilhe seu feedback.
Executar sua jornada
Você executa jornadas com o agente de IA na janela Agente. Quando você executa uma jornada, o agente cria e implanta o app em um dispositivo, realiza cada etapa da jornada e informa se ela foi aprovada ou não.
Para executar uma jornada, siga um destes procedimentos:
- Abra o arquivo de jornada e clique em Executar
na barra de ferramentas do editor. - Na visualização Code ou Split, clique em Run
na medianiz ao lado da tag <journey>. - No painel Projeto, clique com o botão direito do mouse em um arquivo de jornada e selecione Executar jornada com o agente. Para executar várias jornadas, selecione mais de um arquivo de jornada ou uma pasta que contenha arquivos de jornada e selecione Executar jornadas com o agente.
- Na janela Agente, peça para o agente executar uma jornada.
O Android Studio inicia uma nova conversa na janela Agent usando o agente selecionado por último, incluindo outros agentes que você conectou em Settings > Tools > AI > Agents.
O agente executa a jornada no dispositivo selecionado na barra de ferramentas principal. Se nenhum dispositivo estiver em execução, o agente poderá iniciar um emulador para você. Se você executar mais de uma jornada ou selecionar mais de um dispositivo, o agente vai mostrar um resumo dos resultados quando as execuções forem concluídas.
Executar uma jornada na linha de comando
Para executar as Jornadas na linha de comando com qualquer agente, use a CLI do Android.
Ver resultados
Quando o agente conclui uma jornada, ele informa se ela foi aprovada ou reprovada, incluindo qualquer etapa com falha, na janela Agente. Ele também fornece um link para um relatório da jornada. O relatório inclui o seguinte:
- O resultado geral da jornada.
- Se cada etapa foi aprovada ou reprovada.
- Os comandos que o agente executou no dispositivo.
- Os comentários do agente sobre cada etapa.
- Links para as capturas de tela feitas pelo agente.
Executar jornadas como pacotes de teste do AGP
No Android Studio Rabbit 2 e versões anteriores, as Jornadas estão disponíveis como um recurso do Studio Labs que executa jornadas como pacotes de testes do Plug-in do Android para Gradle (AGP). Para usá-lo, faça o seguinte:
- Acesse Studio Labs no menu de configurações e ative as Jornadas.
- Verifique se o projeto usa o AGP 9.0.0 ou uma versão mais recente.
- No painel Project, clique com o botão direito do mouse no módulo do app e selecione New > Journey Test. Se for a primeira vez que você adiciona jornadas ao seu projeto, o Android Studio também vai adicionar suporte ao pacote de testes do AGP.
- Abra o arquivo da jornada e, na visualização Design, clique em Run Journey. O Android Studio cria uma configuração de execução de teste de jornadas, a executa no dispositivo selecionado e mostra os resultados no painel de resultados do teste.
O pacote de testes é executado na variante de build que estava ativa quando você criou
a jornada. Se você mudar para uma variante de build diferente, adicione-a à
propriedade targetVariants no bloco testSuites do arquivo build.gradle.kts
no nível do módulo.