Resolver problemas

Ao desenvolver Ações no app, você pode encontrar problemas com a configuração ou com a ferramenta de teste dessas ações. Confira alguns problemas comuns e as respectivas correções nesta página.

Geral

Erro: a notificação de aviso "Nenhum app encontrado para abrir o URL" aparece

Confira se o fulfillment urlTemplate está no actions.xml e se ele está configurado corretamente. Se estiver usando URLs de links do app, é possível acionar o URL manualmente usando ACTION_VIEW e o URL. Se você estiver usando URLs com base em intents, verifique se a atividade está configurada corretamente para começar a usar os parâmetros fornecidos.

Erro: "O app não está instalado"

Esse erro pode significar que o <intent-filter> no arquivo AndroidManifest.xml não filtra o link direto especificado no actions.xml. Confira o arquivo antes de informar um bug.

Erro: a mensagem "Foi encontrada uma referência de grupo de entidades que não contém um ID nem um filtro de URL" aparece no Android Studio

Essa condição é causada por um problema conhecido de linter da tag <entity-set-reference>. Se for esse o caso, ignore essa mensagem. Como solução alternativa, você pode desativar a verificação do lint para a tag adicionando o atributo tools:ignore="ValidActionsXml" a ela.

Confira este exemplo de referência de conjunto de entidades com uma verificação de lint desativada:

<entity-set-reference entitySetId="example" tools:ignore="ValidActionsXml" />

Erro: "Local inválido" para o documento de esquema de ações ao fazer upload do APK

O upload do APK pode falhar se você usar uma ferramenta de ofuscação ou otimização que afete os recursos do APK de lançamento. Ferramentas como o ProGuard, que evitam arquivos de recursos, não causam esse problema.

Para resolver esse problema, desative a ferramenta no arquivo actions.xml do app, por exemplo, usando uma lista de permissões.

Erro: a mensagem "Um APK ou Android App Bundle ativo contém um arquivo actions.xml. Para continuar, aceite os Termos de Serviço do Actions on Google" aparece no Google Play Console

Esse erro pode ocorre durante a criação de uma versão do app no Play Console. Para aceitar os Termos de Serviço do Actions on Google, siga estas etapas:

  1. Selecione o app no Play Console.
  2. Acesse Configuração > Configurações avançadas.
  3. Clique na guia Actions on Google.
  4. Marque a caixa Integrar meus serviços com Ações no app usando o Actions on Google e siga as instruções.

O botão "Aceitar" no formulário dos Termos de Serviço do Google Play está desativado

Isso pode significar que o usuário que fez login não tem o nível de acesso necessário para aceitar esses termos. Confira se o primeiro envio foi feito pelo administrador do perfil do Play Console.

Ferramenta de teste de Ações no app

Antes de tentar qualquer uma das correções abaixo, atualize a instalação da ferramenta de teste de Ações no app para a versão mais recente.

O plug-in da ferramenta de teste de Ações no app não consegue localizar meu arquivo actions.xml

Verifique se você adicionou a tag <meta-data> correta ao arquivo AndroidManifest.xml.

A prévia das Ações no app não corresponde ao arquivo actions.xml atual

A prévia não é atualizada dinamicamente com o conteúdo do arquivo actions.xml. Depois de mudar o arquivo actions.xml manualmente ou após mudar as variantes de build no Android Studio, salve o arquivo actions.xml e clique em Update Preview na ferramenta de teste.

O plug-in da ferramenta de teste de Ações no app parou de funcionar ou está gerando erros

Primeiro, atualize o Android Studio para a versão mais recente. Se encontrar o erro 403, também é possível que você esteja executando o plug-in em um pacote sem permissões de execução.

Se o erro persistir, registre um bug e envie os detalhes abaixo ao Google:

  • Detalhes da caixa de diálogo de erro.
  • Registros do Android Studio. Acesse Help > Show Log in Finder. Isso mostra a localização do idea.log no Finder. Pesquise "Submit Actions Required Body:" no arquivo de registro e cole as respostas do servidor. Deve haver dois resultados para as ações.

A ferramenta de teste de Ações no app gera uma UnknownHostException ou outros erros de rede

A ferramenta de teste de Ações no app cria uma prévia dessas ações, permitindo que você teste as integrações do Google Assistente com uma única Conta do Google. Para criar essas prévias, a ferramenta de teste exige uma conexão de Internet ativa e, se necessário, acesso de proxy aos domínios do Google.

Para resolver problemas de rede ao executar a ferramenta de teste, verifique estes problemas comuns:

  • Confira se você tem uma conexão de Internet ativa antes de gerar prévias.
  • Se a conexão de Internet estiver ativa, e a rede local usar um servidor proxy, verifique o seguinte:

    • Confira a configuração do proxy do ambiente de desenvolvimento integrado. Para mais informações, consulte as instruções de configuração de proxy do Android Studio ou do IntelliJ (em inglês).
    • Se o proxy exigir uma lista de controle de acesso (Access Control List), atualize a lista para permitir este padrão do URL: https://actions.googleapis.com/**.

Ao invocar Ações no app com o plug-in de teste, o Google Assistente diz: "Não foi possível encontrar isso"

Dependendo da sua configuração, essa resposta pode aparecer por diferentes motivos. Siga estas etapas:

  1. Faça login no Android Studio, no Play Console e no dispositivo de teste com a mesma Conta do Google.
  2. Ative a sincronização de dados do dispositivo.
  3. Defina o idioma do dispositivo e do Google Assistente como en-US.
  4. Confira se o nome do pacote do app no Google Play Console corresponde ao nome do pacote no app de teste.
  5. Na definição urlTemplate de fulfillment no arquivo actions.xml, confira se os valores android:host e android:scheme correspondem ao que está declarado no arquivo AndroidManifest.
  6. Remova todas as instalações anteriores do app do dispositivo de teste e instale um novo build.
  7. Exclua a prévia da ferramenta de teste de Ações no app e crie uma nova.
  8. Confira na ferramenta Logcat se há falhas relacionadas ao fulfillment do Google Assistente. Você vai encontrar uma intent iniciada no app.
  9. Ative a configuração "Informações de apps dos seus dispositivos" para a conta.
  10. Abra o Google Assistente e conclua a configuração. Geralmente, a barra de progresso da configuração aparece como uma barra azul na parte de baixo da tela, mas pode ser diferente em alguns casos.
  11. Ao usar o Google Assistente para acionar uma ação do app, confira se o nome da invocação corresponde à visualização criada pela ferramenta de teste de Ações no app.
  12. Tente usar entradas de texto em vez de voz para evitar erros de transcrição.
  13. Configure seu build de teste para que o applicationId corresponda exatamente a um APK ou AAB enviado ao Google Play Console. As propriedades applicationIdSuffix opcionais podem mudar o applicationId final de builds para algumas variações de produto e variantes de build. Neste exemplo (link em inglês), o applicationId da variação de produto simulada é com.example.android.architecture.blueprints.master.mock, em vez de com.example.android.architecture.blueprints.
  14. Configure a prévia para usar um nome de invocação exclusivo. Tente usar uma palavra exclusiva que reduza as chances de conflitos com outros apps.
  15. Para isolar problemas de uma base de código compartilhável enquanto tenta os solucionar, execute o app fitness de exemplo de Ações no app (em inglês). Verifique se o app fitness funciona de ponta a ponta. Em seguida, adicione outros recursos ao app para conferir se é possível replicar problemas.
  16. Se você estiver usando contas do G Suite, verifique se o Google Assistente foi ativado pelo administrador. Recomendamos que você crie uma conta de teste que não seja do G Suite como solução alternativa e a configure como um testador licenciado pela Play Store. Os testadores vão poder criar prévias para o app com a conta e usá-la para testar no dispositivo.
  17. Se você fez o download do Google Assistente como um app separado, tente forçar o fechamento dele no dispositivo. Geralmente, é possível forçar o fechamento de um app nas Configurações do smartphone
  18. Se nenhuma dessas etapas funcionar, informe um problema no Issue Tracker do Ações no app.