Plug-in do Google Assistente para o Android Studio
O plug-in do Google Assistente testa as Ações no app no Android Studio.
Durante o desenvolvimento e os testes, você usa o plug-in para criar uma prévia dos seus
Ações no app no Assistente para sua Conta do Google. Depois, você pode testar como as
Ações no app processam vários parâmetros antes de enviar o app para implantação.
Como funciona
O plug-in do Google Assistente inclui a ferramenta de teste de Ações no app, um recurso que
analisa o arquivo Shortcuts.xml e cria uma prévia das Ações no app para um
uma única Conta do Google. Essas prévias permitem que o Google Assistente reconheça as
Ações no app antes de implantar a versão de produção do aplicativo no Google
Play Console.
Para cada intent integrada (BII, na sigla em inglês) no arquivo Shortcuts.xml, a ferramenta renderiza
um objeto JSON-LD correspondente e fornece valores de parâmetro padrão. Você pode
modificar esses valores para testar as Ações no app com combinações de parâmetros
significativas e garantir que elas executem as funções corretas do app. As prévias são
criadas, atualizadas e excluídas na ferramenta de teste, permitindo que você itere e
teste as Ações no app em um ambiente seguro.
Depois de criar uma prévia, você pode acionar uma ação no dispositivo de teste
diretamente da janela de ferramentas de teste. Para BIIs disponíveis
para acionar o usuário, use app name diretamente no Google Assistente usando o
dispositivo para testar a Ação no app. Por exemplo, você pode dizer "Ok Google,
iniciar meu exercício usando o App de exemplo" para iniciar uma Ação no app que usa o
actions.intent.START_EXERCISE BII.
Suporte a localidades
A criação de prévias para localidades específicas na ferramenta de teste varia de acordo com a BII.
Confira a página de cada BII na referência de intents integradas.
informações sobre os recursos disponíveis para essa BII, como
se a ferramenta de teste oferece suporte à criação de visualizações para uma localidade específica e
se as Ações no app estão disponíveis para serem acionadas pelos usuários.
Instalar o plug-in
O plug-in do Google Assistente está disponível para o Android Studio. Para
saber mais sobre como instalar e usar o Android Studio, consulte a página
Android Studio.
Para instalar o plug-in do Google Assistente no Android Studio, siga estas etapas:
Acesse Arquivo > Settings (Android Studio > Preferences no macOS).
Na seção Plugins, acesse Marketplace e pesquise
"Plug-in do Google Assistente."
O uso do plug-in do Google Assistente requer algumas etapas de configuração para
permita que a Ação no app seja testada. É necessário usar a
mesma conta de usuário no Android Studio, no dispositivo de teste e ao acessar o Google Play
Console.
Prepare seu ambiente de desenvolvimento com estas configurações:
Faça login no Android Studio (versão 4.0 ou mais recente).
Com a mesma conta, faça login no Google app no dispositivo Android de teste.
O plug-in do Google Assistente tem as limitações abaixo:
As Ações no app que incorporam inventários da Web
e invocações de aplicativo em primeiro plano
não podem ser testadas diretamente na ferramenta de teste ou pelos comandos do
Android Debug Bridge (adb). Para testar esse tipo de Ações no app, primeiro crie uma prévia usando a ferramenta
de teste. Em seguida, interaja com o Google Assistente
no dispositivo físico para acionar as Ações no app.
O inventário inline da BII actions.intent.OPEN_APP_FEATURE
só pode ser testado por um período de seis horas após criar ou atualizar
uma prévia. Atualize a prévia da ferramenta de teste ou crie uma nova para
redefinir o período de seis horas.
Adicionar mais testadores
É possível convidar outros usuários para o projeto para que eles possam testar a
integração das Ações no app. Isso é útil quando você quer compartilhar o projeto
com outros membros da equipe de desenvolvimento para que eles possam fazer testes ou ao
compartilhar o projeto com testadores de controle de qualidade (QA, na sigla em inglês) quando estiver preparando o app para o
lançamento. Os testadores precisam ser adicionados como testadores de licença na Google
Play Store e receber acesso somente leitura ao Google Play Console.
Para adicionar mais testadores, siga estas etapas:
Em Acesso de apps, confira se a caixa de seleção Administrador (todas as permissões) está
desmarcada.
É necessário fazer login para cada testador que você quiser ativar para testes de visualização
separadamente do Android Studio com a Conta do Google desse usuário. Depois de fazer login,
use o plug-in do Google Assistente para criar uma prévia para o usuário de teste.
Usar o plug-in do Google Assistente
Acesse a ferramenta de teste de Ações no app no Android Studio em Tools > Google Assistant >
App Actions Test Tool. Quando você abre a ferramenta, a visualização pode mudar
se você tiver uma prévia da ferramenta de teste ativa.
Criar, atualizar e excluir prévias
É possível usar uma versão de rascunho do app para testes. Para mais
informações, consulte Preparar e lançar uma versão. Teste o app no modo rascunho antes
de enviá-lo para análise.
A ferramenta de teste cria prévias com base na sua Conta do Google e no nome do pacote do aplicativo
(ID do aplicativo) para que você possa testar vários apps com a mesma
Conta do Google. Desde que o ID do aplicativo seja diferente para cada app, você
pode continuar usando a mesma Conta do Google para criar e testar prévias.
Várias Contas do Google com acesso ao mesmo pacote de apps podem usar a
ferramenta de teste para criar prévias separadas desse app.
Para criar uma prévia, siga estas etapas no Android Studio:
Abra a ferramenta de teste de Ações no app.
Você também pode inserir um nome de app e uma localidade para teste. O nome
e a localidade do app padrão são test app action e en.
Clique em Create preview. Se solicitado, leia e aceite as Ações no app.
e os Termos de Serviço do Google Cloud. Depois que a visualização for criada, a ferramenta de teste
a janela será atualizada para mostrar informações sobre as BIIs encontradas nas
arquivo atalhos.xml.
A ferramenta de teste usa o nome do app para criar e simular consultas do
Google Assistente para Ações no app. As Ações no app implantadas usam o nome do app da Play Store
para invocação, mas é possível usar qualquer nome de invocação na ferramenta de teste.
No entanto, recomendamos usar o nome do app como o nome da invocação na
ferramenta de teste.
A localidade fornecida precisa corresponder ao idioma do Google Assistente do
dispositivo de teste, e só é possível criar uma prévia em uma localidade por vez. Por
exemplo, se o idioma do Assistente é o inglês (EUA), é possível inserir en-US, mas
não en-**, en-GB ou en-US, en-GB. Você pode usar uma localidade raiz, como
como en, para incluir en-GB e en-US.
Para mudar o nome do app ou a localidade selecionada de uma prévia já existente, clique
no botão Delete na ferramenta de teste. Em seguida, insira a localidade
e o nome do app antes de criar uma prévia.
Para atualizar uma prévia já existente para que corresponda ao arquivo shortcuts.xml, clique no botão
Update na ferramenta de teste. As informações sobre a prévia
atual estão na seção Test App Actions da janela da ferramenta de teste.
Configurar a BII
Depois de criar uma visualização do app, você poderá testar diversos valores de parâmetros para BIIs no plug-in. Para cada BII da
Shortcuts.xml, o plug-in renderizará um arquivo
objeto JSON-LD e fornece valores de parâmetro padrão. É possível modificar esses
valores padrão para testar as Ações no app com combinações significativas de parâmetros
e garantir que elas executem as funções corretas do app.
Os parâmetros e os respectivos valores geralmente seguem a estrutura schema.org ou
schema.googleapis.com de propriedades e descrições. Você pode encontrar
informações sobre qualquer parâmetro de BII acessando o esquema
descrições de tipo de um parâmetro e seus parâmetros de nível superior.
Por exemplo, a BII actions.intent.GET_FOOD_OBSERVATION
oferece suporte ao parâmetro de intent foodObservation.forMeal.
A página
schema.googleapis.com de MealType lista name como uma
propriedade.
A propriedade forMeal é um modo de transferência e espera
valores (como MealTypeLunch) do tipo MealType enumerado.
Na
ferramenta de teste, você pode fornecer qualquer uma das enumerações como o valor do
foodObservation.forMeal:
https://schema.googleapis.com/MealTypeSnack
https://schema.googleapis.com/MealTypeBrunch
https://schema.googleapis.com/MealTypeLunch
https://schema.googleapis.com/MealTypeBreakfast
https://schema.googleapis.com/MealTypeDinner
https://schema.googleapis.com/MealTypeDesert
Acionar Ações no app
Depois de criar uma prévia e configurar uma BII, você pode acionar uma
Ação no app no dispositivo diretamente na janela da ferramenta de teste.
Para acionar uma Ação do app com a ferramenta de teste, faça o seguinte:
Conecte o dispositivo de teste.
Na seção Select target device, escolha o dispositivo em que você quer
acionar a ação.
Na seção Test App Action, clique no botão Run App Action.
As Ações no app acionadas na ferramenta de teste usam o comando
Android Debug Bridge (adb) mostrado. O comando adb shell gerado
inclui todos os metadados exigidos pelo Google app para executar uma BII.
Essa abordagem imita o comportamento da Ação no app depois que o Google Assistente
extrai as principais informações de uma consulta.
Geração de registros do Android Studio
Os registros específicos da ferramenta de teste estão disponíveis nos
arquivos de registros do Android Studio (link em inglês), não como saída do
Logcat. Os processos executados diretamente na estação de trabalho geram registros do
Android Studio. Você pode usá-los para resolver problemas de operações da ferramenta de teste, como criação,
atualizar ou excluir uma visualização.
Para conferir os arquivos de registro do Android Studio, acesse Help > Show log in explorer
(Help > Show log in finder no macOS).
Os registros relacionados a Ações no app estão disponíveis no Logcat.
O Logcat captura registros de dispositivos virtuais ou físicos conectados ao Android
Studio.
Para gerar registros de Ações no app para o dispositivo, siga estas etapas:
Para acessar as mensagens de registro do Logcat, clique em Logcat na barra da janela de ferramentas
do Android Studio.
Pesquise registros que incluem ActivityTaskManager.
Suporte e outros recursos
O plug-in do Google Assistente tem links para documentação, codelabs
e outros recursos para aprender e receber ajuda para usar a ferramenta de teste.
Você pode abrir o Google Assistente no Android Studio selecionando
Tools > Google Assistant > Help.
Figura 2. A seção de ajuda do plug-in do Google Assistente.
O conteúdo e os exemplos de código nesta página estão sujeitos às licenças descritas na Licença de conteúdo. Java e OpenJDK são marcas registradas da Oracle e/ou suas afiliadas.
Figura 2. A seção de ajuda do plug-in do Google Assistente.