Risoluzione dei problemi

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

Generali

Errore: nella notifica toast viene visualizzato il messaggio "Nessuna app trovata per aprire l'URL"

Controlla l'adempimento urlTemplate in 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 sull'intent, assicurati che l'attività sia configurata correttamente per iniziare a utilizzare i parametri forniti.

Errore: "L'app non è installata"

Questo errore potrebbe significare che l'<intent-filter> nel file AndroidManifest.xml non filtra il link diretto specificato in 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 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 un controllo lint disattivato: 

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

Errore: "Posizione non valida" per il documento 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 rilascio. 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. Per continuare, accetta i Termini di servizio di Actions on Google." 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 delle app tramite Actions on Google e segui le istruzioni.

Il pulsante "Accetta" nel modulo dei Termini di servizio di Google 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 Azioni app all'ultima versione.

Il plug-in dello strumento di test delle 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 dell'Azione app non corrisponde al mio file actions.xml attuale.

L'anteprima non si aggiorna dinamicamente con i contenuti del tuo file actions.xml. Dopo aver modificato manualmente il file actions.xml 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 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, potresti anche eseguire il plug-in su un pacchetto per cui non disponi delle autorizzazioni di esecuzione.

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

  • Dettagli della finestra di dialogo di errore
  • Log di Android Studio. Vai ad Aiuto > Mostra log nel Finder. Qui viene mostrata la posizione di idea.log nel Finder. Cerca "Submit Actions Request Body:" nel file di log e incolla le risposte del server (dovrebbero essere 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 tue Azioni app, consentendoti di testare le integrazioni dell'Assistente Google con un unico 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 la presenza di 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, controlla 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 nulla".

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 a quello dell'applicazione di test.
  5. Nella definizione urlTemplate dell'evasione nell'actions.xml file, assicurati che i valori android:host e android:scheme corrispondano a quelli dichiarati 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 lo strumento Logcat per individuare errori relativi all'evasione per l'Assistente Google. Dovresti visualizzare 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. (Di solito 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 invocazione corrisponda all'anteprima creata dallo strumento di test delle Azioni app.
  12. Prova a utilizzare l'inserimento 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 AAB caricato su Google Play Console. Tieni presente che le proprietà applicationIdSuffix facoltative possono modificare l'applicationId finale delle build per determinate varianti di build e versioni del prodotto. In questo esempio, il applicationId per il gusto del prodotto fittizio è com.example.android.architecture.blueprints.master.mock, anziché com.example.android.architecture.blueprints.
  14. Configura l'anteprima in modo che utilizzi un nome di invocazione 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 una base di codice condivisibile, prova a eseguire l'app di esempio per il fitness Azioni app. Assicurati che l'app per il fitness funzioni end-to-end. Aggiungi poi in modo incrementale altre funzionalità a questa app per vedere se riesci a replicare i problemi.
  16. Se utilizzi account G Suite, assicurati che l'amministratore abbia attivato l'Assistente Google. Ti consigliamo di creare un account di prova non G Suite come soluzione alternativa 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 propria app e testare l'app utilizzando l'account sul proprio dispositivo.
  17. Se hai scaricato l'Assistente Google come app separata, prova a forzarne l'interruzione sul dispositivo. Generalmente è possibile forzare l'interruzione di un'app tramite l'app Impostazioni dello smartphone.
  18. Se nessuno di questi passaggi funziona, segnala un problema nello strumento di monitoraggio dei problemi delle Azioni app.