Jornadas para o Android Studio

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

Criar jornadas para o Android Studio ajuda a facilitar a criação e a manutenção de testes de ponta a ponta, permitindo que você use a linguagem natural para descrever as etapas e asserções de cada teste, chamado de jornada. Ao aproveitar os recursos de visão e raciocínio do Gemini, as etapas escritas em linguagem natural são convertidas em ações que o Gemini executa no seu app, facilitando a escrita e a compreensão das jornadas. Além disso, é possível escrever e descrever declarações mais complexas, que o Gemini avalia com base no que ele encontra no dispositivo para determinar se as jornadas são aprovadas ou não.

Como o Gemini pondera quais ações realizar para atingir as metas, as jornadas são mais resistentes 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.

Crie e execute jornadas diretamente no Android Studio em qualquer dispositivo Android local ou remoto. O IDE oferece uma nova experiência de editor para criar jornadas, bem como resultados aprimorados que ajudam a seguir melhor o raciocínio e a execução da jornada do 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 a edição de jornadas. As jornadas são escritas usando a sintaxe XML para organizar a descrição e as etapas da jornada.

Para criar e começar a editar uma jornada, faça o seguinte:

1. No painel Project do Android Studio, clique com o botão direito do mouse no módulo do app para o qual você quer criar uma jornada.
2. Selecione New > Test > Journey File.
3. Na caixa de diálogo que aparece, informe o nome e a descrição da jornada.
4. Clique em OK. O Android Studio cria um arquivo XML para sua jornada com o nome escolhido. Você pode usar a visualização Code para editar o XML diretamente ou a visualização Design para uma experiência de edição melhorada.
5. Ao visualizar sua jornada na visualização Design, use o campo de texto para descrever cada etapa dela. Cada etapa pode incluir ações descritivas que você quer que o Gemini execute ou declarações que você quer que o Gemini avalie.
6. Pressione Enter no teclado para iniciar um novo comando na mesma jornada. Repita esse processo conforme necessário para cada etapa da jornada que você quer definir.

Dicas para escrever jornadas

Escrever suas jornadas de maneira detalhada e organizada pode aumentar a probabilidade de o Gemini executar as jornadas pretendidas de maneira mais determinística. Confira algumas dicas para escrever suas jornadas de maneira mais eficaz:

• Evitar ações únicas explícitas:o Gemini pode converter cada etapa da sua jornada em várias ações. Evite escrever comandos que sejam ações únicas explícitas, como "clique em X", porque o modelo é treinado para alcançar objetivos complexos.
• Separar declarações de ações:o Gemini avalia constantemente o estado do app para determinar se ele está em um estado "correto" para continuar a jornada. No entanto, talvez seja necessário definir declarações mais complexas como uma etapa separada. Além disso, inicie cada comando usando frases-chave como "Verifique isso", "Declare isso" ou "Verifique isso" para informar ao Gemini que essa etapa é destinada a uma declaração.
• Direcionar o Gemini com deslizamentos:além das interações básicas, como toques ou entradas de teclado, o Gemini oferece suporte a ações que exigem que ele deslize a tela em determinadas direções. Por exemplo, para rolar o conteúdo ou fechar uma interface, basta descrever a direção e a intenção da ação de deslizar. Por padrão, o Gemini desliza do centro da tela, mas você pode orientá-lo para deslizar em uma parte diferente da tela do dispositivo.
• Evite outras interações complexas e mudanças de configuração:o Gemini atualmente não oferece suporte a todas as interações e mudanças de configuração, como gestos com vários dedos, rotações de tela ou ações de dobra. A equipe está trabalhando para melhorar os recursos do Gemini.

Executar sua jornada

Você pode executar a jornada em qualquer dispositivo local ou remoto disponível, semelhante a qualquer outro teste instrumentado, e o Android Studio gera resultados avançados que ajudam a entender a execução da jornada.

Para testar uma jornada, faça o seguinte:

1. Selecione um dispositivo de destino na barra de ferramentas principal, como você faria ao executar um teste instrumentado.
2. Acesse o arquivo XML da jornada que você quer testar e abra-o no editor.
3. No editor, faça uma das seguintes ações:
   1. Se você estiver na visualização Design, clique em Run Journey.
   2. Se você estiver na visualização Code, clique em Run no gutter ao lado de onde o nome da jornada é definido no XML.

O Android Studio cria uma configuração do Journeys Test 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.

Os resultados limitados também são mostrados no editor durante a execução de uma jornada, como as capturas de tela, a ação realizada e o raciocínio durante a execução de cada etapa da jornada. Basta passar o cursor sobre a miniatura no editor para conferir mais informações. Isso pode ser útil ao iterar os comandos na sua jornada.

Ver resultados

Quando o Android Studio conclui o teste da jornada, o painel de resultados do teste é mostrado automaticamente.

Em comparação com outros testes de instrumentação que você pode executar no Android Studio, há algumas diferenças na forma como os resultados das jornadas são mostrados.

• O painel Testes divide a jornada em etapas distintas. É possível clicar em cada etapa para saber mais sobre como o Gemini a executou.
• O painel Results 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 ajuda visual em cada ação da etapa.
• Cada ação realizada e o raciocínio do Gemini sobre por que ela foi realizada 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), pode aparecer um aviso no dispositivo com a mensagem "App não seguro bloqueado" para o "AndroidX Crawler". Clique em Instalar mesmo assim para ignorar essa verificação. Também é possível configurar as opções do desenvolvedor no dispositivo e desativar a opção Verificar apps por USB.
• No momento, os arquivos de jornada não aparecem na visualização Android no painel Projects. Para conferir os arquivos de jornada no projeto, use a visualização Project.
• Se várias ações em uma jornada compartilharem o mesmo comando, os resultados do teste exibidos no editor de jornada podem estar incorretos. Especificamente, todas as ações com o comando duplicado vão mostrar os resultados do teste associados à instância mais recentemente atualizada desse comando. Para contornar esse problema, verifique se cada ação tem uma solicitação exclusiva. Por exemplo, adicione um prefixo ou sufixo distinto.
• Um pop-up de stylus aparece na segunda vez que o teclado é carregado em um emulador novo. Esse pop-up geralmente faz com que os testes que interagem com os campos de texto falhem. Quando isso acontecer, feche o pop-up e execute a jornada novamente.
• Os artefatos do rastreador de apps podem aparecer ocasionalmente no raciocínio do agente.
• A execução da jornada falha ocasionalmente com uma IllegalStateException. Quando isso acontecer, clique em Resultados do teste para conferir o erro completo.

• Se o Plug-in do Android para Gradle (com.android.application) não estiver definido no arquivo build.gradle de nível superior, o seguinte erro poderá aparecer ao executar uma jornada:

  Failed to apply plugin class 'com.android.tools.journeys.JourneysGradlePlugin'
  

  Para resolver isso, verifique se o plug-in está definido no arquivo build.gradle de nível superior. Consulte Configurar o sistema de build do Android para mais informações.