Risoluzione dei problemi

Durante lo sviluppo di Azioni app, potresti riscontrare problemi con la configurazione o con lo strumento di test di Azioni app. Questa pagina descrive alcuni problemi comuni e le relative soluzioni.

Generali

Errore: "Nessuna app trovata per aprire l'URL" viene visualizzato in una notifica toast

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

Errore: "App non installata"

Questo errore potrebbe indicare che l'elemento <intent-filter> nel file AndroidManifest.xml non filtra il deep link specificato nell'elemento actions.xml. Assicurati di controllare questo aspetto prima di segnalare un bug.

Errore: "È stato trovato un riferimento a un set di entità che non contiene né un ID set di entità né un filtro URL" visualizzato in Android Studio

Questa condizione è causata da un problema noto del 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 un controllo lint disattivato: 

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

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

Il caricamento dell'APK potrebbe non riuscire se utilizzi uno strumento di offuscamento o ottimizzazione che influisce sulle risorse dell'APK di release. Gli strumenti come ProGuard che evitano i file di risorse non causano questo problema.

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

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

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 "Accetta" nel modulo dei Termini di servizio di Play è disattivato.

Ciò potrebbe significare che l'utente che ha eseguito l'accesso non dispone del livello di accesso richiesto per accettare i termini. Assicurati che il primo invio venga eseguito dall'amministratore del profilo Play Console.

Strumento di test delle Azioni app

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

Il plug-in dello strumento di test di Azioni app non riesce a trovare il mio file actions.xml.

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

L'anteprima della mia Azione app non corrisponde al file actions.xml corrente.

L'anteprima non si aggiorna automaticamente con i contenuti del file actions.xml. Dopo aver modificato manualmente il file actions.xml o dopo aver cambiato le varianti di compilazione 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 delle Azioni app ha smesso di funzionare o genera errori.

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

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 in Finder. In questo modo, puoi vedere la posizione di idea.log nel Finder. Cerca "Submit Actions Request Body:" nel file di log e incolla le risposte del server (dovrebbero esserci due risultati per le azioni).

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

Lo strumento di test delle 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 i seguenti 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, controlla quanto segue:

    • Verifica la configurazione del proxy dell'IDE. Per saperne di più, 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 richiamo l'Azione app con il plug-in di test, l'assistente dice "Mi dispiace, non sono riuscito a trovarlo".

A seconda della configurazione, questa risposta potrebbe essere visualizzata per diversi motivi. Prova a seguire questi passaggi:

  1. Accedi ad Android Studio, a Play Console e al tuo dispositivo di test con lo stesso Account Google.
  2. Attiva 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 del fulfillment urlTemplate 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 delle Azioni app e creane una nuova.
  8. Controlla nello strumento Logcat se sono presenti errori relativi al fulfillment per l'Assistente Google. Dovresti vedere un intent avviato nella tua app.
  9. Attiva l'impostazione "Informazioni sulle app dei tuoi dispositivi" per l'account.
  10. Apri l'Assistente Google e assicurati di aver completato la configurazione. (In genere, la barra di avanzamento della configurazione viene visualizzata come una barra blu nella parte inferiore dello schermo, ma in alcuni casi potrebbe 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 delle Azioni app.
  12. Prova a utilizzare l'input di testo anziché quello vocale per evitare errori di trascrizione.
  13. Configura la build di test in modo che applicationId corrisponda esattamente a un APK o un AAB caricato su Google Play Console. Tieni presente che le proprietà applicationIdSuffix facoltative possono modificare il valore applicationId finale delle build per determinate versioni prodotto e varianti di compilazione. In questo esempio, applicationId per la versione prodotto fittizia è com.example.android.architecture.blueprints.master.mock, anziché com.example.android.architecture.blueprints.
  14. Configura l'anteprima in modo che utilizzi un nome di chiamata univoco. Prova a utilizzare 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 di esempio App Actions Fitness App. Assicurati che l'app di fitness funzioni end-to-end. Poi, aggiungi gradualmente altre funzionalità a questa app per vedere se riesci a replicare i problemi.
  16. Se utilizzi account G Suite, assicurati che l'Assistente Google sia attivato dall'amministratore. Come soluzione alternativa, ti consigliamo di creare un account di test non G Suite e di configurarlo come tester con licenza tramite il Play Store. Da questo account, i tester dovrebbero essere in grado di creare anteprime per la loro app e di eseguire test utilizzando l'account sul loro dispositivo.
  17. Se hai scaricato l'Assistente Google come app separata, prova a forzarne l'interruzione sul tuo dispositivo. Di solito puoi forzare l'interruzione di un'app tramite l'app Impostazioni dello smartphone.
  18. Se nessuno di questi passaggi funziona, segnala un problema nell'Issue Tracker di Azioni app.