Risoluzione dei problemi

Durante lo sviluppo delle Azioni app, potresti riscontrare problemi relativi alla configurazione o lo strumento di test delle Azioni app. In questa pagina vengono descritti alcuni problemi comuni e le relative correzioni.

Generali

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

Controlla l'evasione degli ordini urlTemplate in actions.xml per verificare 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 usi gli URL basati sull'intent, assicurati la tua attività sia configurata correttamente per iniziare a utilizzare i parametri forniti.

Errore: "L'app non è installata"

Questo errore potrebbe significare che <intent-filter> in AndroidManifest.xml il file non filtra il link diretto specificato in actions.xml. Assicurati di controllare questa opzione 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." viene 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 il metodo tools:ignore="ValidActionsXml".

Ecco un esempio di riferimento a un set di entità con un 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

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

Per risolvere il problema, prova a disattivare lo strumento per 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." viene visualizzato in Google Play Console

Potresti visualizzare questo errore durante la creazione di una release dell'app in Play Console. A accetta 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 Azioni su Google.
  4. Seleziona la casella Integra i miei servizi con Azioni app utilizzando Azioni su Google e segui le istruzioni.

L'opzione "Accetta" il pulsante nel modulo dei Termini di servizio di Google Play sia disabilitato.

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

Strumento di test delle Azioni app

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

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

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

L'anteprima di La mia Azione app non corrisponde al mio file actions.xml corrente.

L'anteprima non si aggiorna automaticamente in base ai contenuti dei tuoi actions.xml. Dopo aver modificato il file actions.xml manualmente o dopo cambiando 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 non funziona più o genera errori.

Innanzitutto, assicurati di aver aggiornato Android Studio all'ultima versione. Se ricevi l'errore 403, è anche possibile che il plug-in sia in esecuzione per il quale non disponi delle autorizzazioni di esecuzione.

Se l'errore persiste, segnala un bug e invia quanto segue a Google:

  • Dettagli della finestra di dialogo di errore
  • Log di Android Studio. Vai su Guida > Mostra Accedi nel Finder. Viene visualizzato la posizione di idea.log nel Finder. Cerca "Invia azioni Corpo della richiesta:" nel file di log e incolla le risposte del server ( dovrebbe essere due risultati per le azioni).

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

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 questi le anteprime, lo strumento di test richiede una connessione a internet attiva e, se 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 problemi:

  • 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 proxy server, controlla quanto segue:

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

Quando richiami l'Azione app con il plug-in di prova, l'assistente dice: "Non ho trovato l'azione".

A seconda della configurazione, questa risposta può essere visualizzata per diversi motivi. Prova segui questi passaggi:

  1. Accedi ad Android Studio, a Play Console e 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 Google Play Console corrisponde al nome del pacchetto nell'applicazione di test.
  5. Nella definizione urlTemplatedi completamento del tuo 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 installare una nuova build.
  7. Elimina l'anteprima dallo strumento di test Azioni app e crea di nuovo una nuova anteprima.
  8. Controlla nello strumento Logcat la presenza di errori relativi al completamento per l'Assistente Google. Dovresti vedere un intent lanciato nella tua app.
  9. Attivare l'opzione "Informazioni sulle app per i tuoi dispositivi" l'ambientazione per l'account.
  10. Apri l'Assistente Google e assicurati di aver completato la configurazione. (di solito la configurazione barra di avanzamento appare come 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 parametro il nome di chiamata corrisponde all'anteprima creata dallo strumento di test delle 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 AAB caricati in Google Play Console. Tieni presente che, applicationIdSuffix proprietà possono modificare applicationId finali di per alcune versioni di prodotto e varianti di prodotto. In questo esempio, applicationId per la simulazione del sapore del prodotto è 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 utilizzare un indirizzo che riduce 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. Assicurati che l'app Fitness funzioni end-to-end. Poi aggiungi in modo incrementale funzionalità aggiuntive per vedere se puoi replicare i problemi.
  16. Se utilizzi account G Suite, assicurati che l'Assistente Google sia attivato tramite Amministratore. 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 devono essere in grado di creare anteprime per la loro app e eseguire il test utilizzando l'account sul dispositivo.
  17. Se hai scaricato l'Assistente Google come app separata, prova a forzarne l'interruzione sul dispositivo. In genere puoi forzare l'interruzione di un'app tramite l'app Impostazioni del telefono.
  18. Se nessuno di questi passaggi funziona, segnala un problema nella Issue Tracker delle Azioni app.