Risoluzione dei problemi

Durante lo sviluppo di Azioni app, potresti riscontrare problemi con la configurazione o con lo strumento di test Azioni app. In questa pagina vengono descritti alcuni problemi riscontrati di frequente e le relative soluzioni.

Generali

Errore: "Nessuna app trovata per aprire l'URL" in una notifica popup

Controlla il fulfillment urlTemplate in actions.xml per assicurarti che sia configurato correttamente. Se utilizzi gli URL dei link alle app, assicurati di poter attivare manualmente l'URL utilizzando ACTION_VIEW e l'URL. Se utilizzi URL basati su intent, assicurati che la tua attività sia configurata correttamente per iniziare a utilizzare i parametri forniti.

Errore: "L'app non è installata"

Questo errore può significare che <intent-filter> nel file AndroidManifest.xml non filtra il link diretto specificato in actions.xml. Assicurati di controllare questo comportamento prima di segnalare un bug.

Errore: in Android Studio viene visualizzato un riferimento a un set di entità che non contiene né un ID set di entità né un filtro URL.

Questa condizione è causata da un problema noto di linter per il tag <entity-set-reference>. Puoi ignorare questo messaggio. Come soluzione alternativa, puoi disattivare il controllo lint per questo tag aggiungendo l'attributo tools:ignore="ValidActionsXml".

Ecco un esempio di riferimento a un set di entità con controllo lint disabilitato: 

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

Errore: "Posizione non valida" per il documento dello schema delle azioni durante il caricamento dell'APK

Se utilizzi uno strumento di offuscamento o ottimizzazione che influisce sulle risorse dell'APK della release, il caricamento dell'APK potrebbe non riuscire. Strumenti come ProGuard che evitano i file delle risorse non causano questo problema.

Per risolvere il problema, prova a disattivare lo strumento per il file actions.xml dell'app (ad esempio utilizzando una lista consentita).

Errore: "Un APK o Android App Bundle attivo contiene un file actions.xml. Per continuare, accetta i Termini di servizio di Actions on Google." viene visualizzato in Google Play Console

Potresti visualizzare questo errore durante la creazione di una release dell'app in Play Console. Per accettare i Termini di servizio di Actions on Google, segui questi passaggi:

  1. Seleziona la tua app in Play Console.
  2. Vai a Configurazione > Impostazioni avanzate.
  3. Fai clic sulla scheda Actions on Google.
  4. Seleziona la casella Integra i miei servizi con Azioni app utilizzando Actions on Google e segui le istruzioni.

Il pulsante "Accetto" nel modulo dei Termini di servizio di Google Play è disattivato.

Questo potrebbe significare che l'utente che ha eseguito l'accesso non dispone del livello di accesso richiesto per accettare questi termini. Assicurati che il primo invio sia effettuato dall'amministratore del profilo Play Console.

Strumento di test Azioni app

Prima di tentare una delle correzioni seguenti, aggiorna l'installazione dello strumento di test di Azioni app alla versione più recente.

Il plug-in dello strumento di test Azioni app non è in grado di individuare il file actions.xml.

Assicurati di aver aggiunto il tag <meta-data> corretto nel file AndroidManifest.xml.

L'anteprima dell'Azione app non corrisponde al mio file actions.xml corrente.

L'anteprima non si aggiorna in modo dinamico con i contenuti del file actions.xml. Dopo aver modificato il file actions.xml manualmente o dopo aver cambiato le varianti di build in Android Studio, salva il file actions.xml e fai clic su Aggiorna anteprima nello strumento di test.

Il plug-in dello strumento di test Azioni app ha smesso di funzionare o sta generando errori.

Innanzitutto, assicurati di aver aggiornato Android Studio all'ultima versione. Se visualizzi un errore 403, è possibile che il plug-in sia in esecuzione su un pacchetto per il quale non disponi delle autorizzazioni necessarie.

Se l'errore persiste, segnala un bug e invia i seguenti dettagli a Google:

  • Dettagli della finestra di dialogo di errore
  • Log di Android Studio. Vai a Guida > Mostra log nel Finder. Questa colonna mostra la posizione di idea.log nel Finder. Cerca "Invia corpo richiesta azioni:" nel file di log e incolla le risposte del server (dovrebbero essere presenti due risultati per le azioni).

Lo strumento di test Azioni app genera UnknownHostException o altri errori di rete

Lo strumento di test Azioni app crea un'anteprima delle azioni app, consentendoti di testare le integrazioni dell'Assistente Google con un singolo Account Google. Per creare queste anteprime, lo strumento di test richiede una connessione a internet attiva e, se necessario, l'accesso proxy ai domini Google.

Per risolvere i problemi di rete durante l'esecuzione dello strumento di test, verifica questi problemi comuni:

  • Assicurati di avere una connessione a internet attiva prima di generare le anteprime.

  • Se la connessione a internet è attiva e la rete locale utilizza un server proxy, verifica quanto segue:

    • Verifica la configurazione del proxy IDE. Per ulteriori informazioni, consulta le istruzioni di configurazione del proxy per Android Studio o IntelliJ.
    • Se il proxy richiede un elenco di controllo dell'accesso (ACL), aggiorna l'ACL per consentire questo pattern URL: https://actions.googleapis.com/**.

Quando richiami l'Azione app con il plug-in di test, l'assistente dice: "Mi dispiace, non ho trovato quello che cercavo".

A seconda della configurazione, questa risposta potrebbe essere visualizzata per diversi motivi. Prova a svolgere i seguenti passaggi:

  1. Accedi ad Android Studio, a Play Console e al dispositivo di test con lo stesso Account Google.
  2. Attivare la sincronizzazione dei dati del dispositivo.
  3. Imposta la lingua del dispositivo e dell'Assistente Google su en-US.
  4. Verifica che il nome del pacchetto dell'applicazione in Google Play Console corrisponda al nome del pacchetto nell'applicazione di test.
  5. Nella definizione di urlTemplatefulfillment nel file actions.xml, assicurati che i valori android:host e android:scheme corrispondano a quanto dichiarato nel file AndroidManifest.
  6. Rimuovi tutte le installazioni precedenti della tua app dal dispositivo di test e installa una nuova build.
  7. Elimina l'anteprima dallo strumento di test Azioni app e crea di nuovo una nuova anteprima.
  8. Verifica nello strumento Logcat eventuali errori relativi al fulfillment per l'Assistente Google. Dovresti vedere un intent lanciato nella tua app.
  9. Attiva l'impostazione "Informazioni sulle app per i tuoi dispositivi" per l'account.
  10. Apri l'Assistente Google e assicurati di aver completato la configurazione. Di solito, la barra di avanzamento della configurazione appare come una barra blu nella parte inferiore dello schermo, ma in alcuni casi può avere un aspetto diverso.
  11. Quando utilizzi l'Assistente Google per attivare un'Azione app, assicurati che il nome di chiamata corrisponda all'anteprima creata dallo strumento di test Azioni app.
  12. Prova a utilizzare l'input di testo anziché la voce per evitare errori di trascrizione.
  13. Configura la build di test in modo che applicationId corrisponda esattamente a un APK o un AAB caricato in Google Play Console. Tieni presente che le proprietà applicationIdSuffix facoltative possono modificare il valore applicationId finale delle build per determinate varianti di prodotto e build. In questo esempio, il applicationId per il sapore di prodotto fittizio è com.example.android.architecture.blueprints.master.mock, anziché com.example.android.architecture.blueprints.
  14. Configura l'anteprima in modo da utilizzare un nome di chiamata univoco. Prova a usare una parola univoca che riduca le possibilità di collisione con altre app.
  15. Per isolare i problemi durante la risoluzione dei problemi di un codebase condivisibile, prova a eseguire l'app App Actions Fitness di esempio. Assicurati che l'app Fitness funzioni end-to-end. Poi aggiungi in modo incrementale altre funzionalità a questa app per vedere se puoi replicare i problemi.
  16. Se utilizzi account G Suite, assicurati che l'Assistente Google sia attivato dall'amministratore. Ti consigliamo di creare un account di prova non G Suite come soluzione alternativa e di configurarlo come tester autorizzato tramite Play Store. Da questo account, i tester dovrebbero essere in grado di creare anteprime per la loro app ed eseguire correttamente i test sull'utilizzo di tale account sul loro dispositivo.
  17. Se hai scaricato l'Assistente Google come app separata, prova a forzarne l'interruzione sul tuo dispositivo. Generalmente è possibile forzare l'interruzione di un'app tramite l'app Impostazioni del telefono.
  18. Se nessuno di questi passaggi funziona, segnala un problema nello strumento di monitoraggio dei problemi di Azione nell'app.