Plug-in dell'Assistente Google per Android Studio

Il plug-in dell'Assistente Google verifica la funzionalità Azioni app in Android Studio. Durante lo sviluppo e i test, puoi utilizzare il plug-in per creare un'anteprima delle azioni app nell'assistente per il tuo Account Google. Puoi quindi verificare in che modo l'Azione app gestisce i vari parametri prima di inviarla per il deployment.

Come funziona

Il plug-in dell'Assistente Google include lo strumento di test delle azioni app, una funzionalità che analizza il file shortcuts.xml e crea un'anteprima delle azioni app per un singolo Account Google. Queste anteprime consentono all'Assistente Google di riconoscere le azioni dell'app prima di eseguire il deployment della versione di produzione dell'app in Google Play Console.

Per ogni intent integrato (BII) nel file shortcuts.xml, lo strumento esegue il rendering di un oggetto JSON-LD corrispondente e fornisce i valori dei parametri predefiniti. Successivamente, puoi modificare questi valori per testare le azioni dell'app con combinazioni di parametri significative e assicurarti che eseguano le funzioni dell'app corrette. Le anteprime vengono create, aggiornate ed eliminate nello strumento di test, in modo da poter eseguire l'iterazione e testare le Azioni app in un ambiente sicuro.

Dopo aver creato un'anteprima, puoi attivare un'Azione app sul tuo dispositivo di test direttamente dalla finestra dello strumento di test. Per le BII disponibili per l'attivazione da parte dell'utente, puoi usare app name direttamente nell'assistente sul tuo dispositivo per provare l'Azione app. Ad esempio, puoi dire "Hey Google, avvia il mio allenamento utilizzando App di esempio" per avviare un'Azione app che utilizza lo BII actions.intent.START_EXERCISE.

Supporto delle impostazioni internazionali

La creazione di anteprime per impostazioni internazionali specifiche nello strumento di test varia in base a BII. La pagina di ogni BII nel riferimento per intent integrato fornisce informazioni sulla funzionalità disponibile per tale BII, ad esempio se lo strumento di test supporta la creazione di anteprime per un'impostazione internazionale specifica e se le azioni app sono disponibili per l'attivazione da parte degli utenti.

Scarica il plug-in

Il plug-in dell'Assistente Google è disponibile per Android Studio. Per informazioni sull'installazione e sull'utilizzo di Android Studio, visita la pagina di Android Studio.

Per installare il plug-in dell'Assistente Google in Android Studio, procedi nel seguente modo:

1. Vai a File > Impostazioni (Android Studio > Preferenze su macOS).
2. Nella sezione Plugin, vai a Marketplace e cerca "Plug-in dell'Assistente Google".
3. Installa lo strumento e riavvia Android Studio.

Puoi anche scaricare il plug-in direttamente dal repository pubblico Jetbrains.

Requisiti per la configurazione

L'utilizzo del plug-in dell'Assistente Google richiede una serie di passaggi di configurazione per consentire il test dell'Azione app. In particolare, devi utilizzare lo stesso account utente in Android Studio, sul dispositivo di test e per l'accesso alla console di Google Play.

Prepara l'ambiente di sviluppo con le seguenti configurazioni:

• Accedi ad Android Studio (4.0 o versioni successive).
• Con lo stesso account, accedi all'app Google sul tuo dispositivo di test Android.
• Con lo stesso account, ottieni l'accesso a Play Console al pacchetto dell'app caricato da testare.
• Apri l'app Google sul tuo dispositivo Android di test e completa la procedura iniziale di configurazione dell'assistente.
• Attiva la sincronizzazione dei dati del dispositivo sul dispositivo di test.

Limitazioni

Il plug-in dell'Assistente Google presenta le seguenti limitazioni:

• Le azioni app che incorporano l'inventario web e la chiamata di app in primo piano non possono essere testate direttamente nello strumento di test o con i comandi di Android debug Bridge (adb). Per testare queste azioni app, crea prima un'anteprima utilizzando lo strumento di test. Dopodiché attiva le azioni app interagendo con l'Assistente Google sul tuo dispositivo fisico.
• L'inventario in linea per lo standard BII di actions.intent.OPEN_APP_FEATURE può essere testato solo per un periodo di sei ore dopo la creazione o l'aggiornamento di un'anteprima. Aggiorna l'anteprima dello strumento di test o creane una nuova per reimpostare il periodo di tempo di sei ore.

Aggiungi altri tester

Puoi invitare altri utenti al tuo progetto in modo che possano testare l'integrazione di Azioni app. Questo è utile quando vuoi condividere il progetto con altri membri del tuo team di sviluppo in modo che possano testare tutti o quando condividi il progetto con tester del controllo qualità (QA) in preparazione al lancio della produzione. I tester devono essere aggiunti come tester delle licenze sul Google Play Store e devono essere autorizzati all'accesso di sola lettura a Google Play Console.

Per aggiungere altri tester:

1. Accedi a Play Console.

2. Segui le istruzioni riportate nella sezione Configurare le licenze dell'applicazione di questo argomento del Centro assistenza Play Console.

   

3. Invita l'Account Google del tester delle licenze come utente di sola lettura di Google Play Console.

   1. Seleziona Utenti e autorizzazioni > Invita nuovi utenti > Aggiungi app.
   2. In Accesso alle app, assicurati che la casella di controllo Amministrazione (tutte le autorizzazioni) sia deselezionata.

Per ogni tester che vuoi abilitare per il test dell'anteprima, devi accedere separatamente ad Android Studio con l'Account Google dell'utente in questione. Dopo aver eseguito l'accesso, utilizza il plug-in dell'Assistente Google per creare un'anteprima per l'utente di test.

Utilizzare il plug-in dell'Assistente Google

Per accedere allo strumento di test Azioni app in Android Studio, vai a Strumenti > Assistente Google > Strumento di test Azioni app. Quando apri lo strumento, la vista cambia a seconda che tu abbia un'anteprima attiva dello strumento di test.

Creare, aggiornare ed eliminare le anteprime

Puoi utilizzare una versione bozza dell'app per i test. Per maggiori informazioni, consulta Preparare e implementare una release. Testa l'app in modalità bozza prima di inviarla per la revisione.

Lo strumento di test crea anteprime in base al tuo Account Google e al nome del pacchetto dell'app (ID applicazione), in modo che tu possa testare più app con lo stesso Account Google. Se l'ID applicazione è diverso per ogni app, puoi continuare a utilizzare lo stesso Account Google per la creazione e il test dell'anteprima. Più Account Google con accesso allo stesso pacchetto dell'app possono utilizzare ciascuno lo strumento di test per creare anteprime separate per l'app.

Per creare un'anteprima, procedi nel seguente modo in Android Studio:

1. Apri lo strumento di test di Azioni app.
2. (Facoltativo) Inserisci il nome di un'app e le impostazioni internazionali per i test. Le impostazioni internazionali e il nome predefiniti dell'app sono test app action e en.
3. Fai clic su Crea anteprima. Se richiesto, rivedi e accetta le norme e i termini di servizio di Azioni app. Dopo aver creato l'anteprima, la finestra dello strumento di test si aggiorna per visualizzare le informazioni sui BII trovate nel file shortcuts.xml.

Lo strumento di test utilizza il nome dell'app per creare e simulare query dell'assistente per le azioni app. Le azioni app di cui è stato eseguito il deployment utilizzano il nome dell'app Play Store per la chiamata, ma puoi usare qualsiasi nome di chiamata nello strumento di test. Tuttavia, ti consigliamo di utilizzare il nome della tua app come nome di chiamata nello strumento di test.

Le impostazioni internazionali specificate devono corrispondere alla lingua dell'Assistente Google sul dispositivo di test e puoi creare un'anteprima solo in un'impostazione internazionale alla volta. Ad esempio, se la lingua dell'assistente è inglese (USA), puoi inserire en-US ma non en-**, en-GB o en-US, en-GB. Puoi utilizzare un'impostazione internazionale principale, ad esempio en, per includere sia en-GB sia en-US.

Per modificare il nome dell'app o le impostazioni internazionali selezionate per un'anteprima esistente, fai clic sul pulsante Elimina nello strumento di test. Poi, inserisci il nome e le impostazioni internazionali dell'app desiderati prima di creare una nuova anteprima.

Per aggiornare un'anteprima esistente in modo che corrisponda al file shortcuts.xml, fai clic sul pulsante Aggiorna nello strumento di test. Le informazioni sull'anteprima attuale si trovano nella sezione Testa azione app della finestra dello strumento di test.

Configura uno BII

Dopo aver creato un'anteprima per l'app, puoi testare vari valori parametro per BII nel plug-in. Per ogni BII nel file shortcuts.xml, il plug-in esegue il rendering di un oggetto JSON-LD corrispondente e fornisce i valori dei parametri predefiniti. Puoi modificare questi valori predefiniti per testare le azioni dell'app con combinazioni di parametri significative e assicurarti che eseguano le funzioni dell'app corrette.

I parametri e i relativi valori in genere seguono la struttura schema.org o schema.googleapis.com per le proprietà e le descrizioni. Puoi trovare informazioni su qualsiasi parametro BII accedendo alle descrizioni del tipo di schema di un parametro e dei relativi parametri di livello superiore.

Ad esempio, lo strumento BII di actions.intent.CREATE_MONEY_TRANSFER supporta il parametro intent moneyTransfer.transferMode. La pagina schema.googleapis.com per MoneyTransfer elenca transferMode come proprietà. La proprietà transferMode è una modalità di trasferimento e prevede valori (come SendMoney) del tipo FinancialTransferMode enumerato.

Nello strumento di test, puoi fornire una delle enumerazioni come valore di transferMode:

• http://schema.googleapis.com/SendMoney
• http://schema.googleapis.com/ReceiveMoney

Attiva azioni app

Dopo aver creato un'anteprima e configurato un BII, puoi attivare un'azione app sul tuo dispositivo di test direttamente dalla finestra dello strumento di test.

Per attivare un'Azione app con lo strumento di test:

1. Collega il dispositivo di test.
2. Nella sezione Seleziona dispositivo di destinazione, scegli il dispositivo su cui attivare l'azione app.
3. Nella sezione Testa azione app, fai clic sul pulsante Esegui azione app.

Le azioni app attivate nello strumento di test utilizzano il comando Android Debug Bridge (adb) visualizzato. Il comando shell adb generato include tutti i metadati richiesti dall'app Google per eseguire uno standard BII. Questo approccio imita il comportamento dell'azione app dopo che l'assistente ha estratto informazioni chiave da una query.

Logging di Android Studio

I log specifici per lo strumento di test sono disponibili nei file di log di Android Studio, non come output Logcat. I processi eseguiti direttamente sulla workstation generano log di Android Studio. Puoi utilizzarli per risolvere i problemi delle operazioni dello strumento di test, come la creazione, l'aggiornamento o l'eliminazione di un'anteprima.

Per accedere ai file di log di Android Studio, seleziona Guida > Mostra Esplora log (Guida > Mostra ricerca log su macOS).

I log relativi ad Azioni app per la tua app sono disponibili in Logcat. Logcat acquisisce i log da dispositivi virtuali o fisici connessi ad Android Studio.

Per recuperare i log di Azioni app per il tuo dispositivo, procedi nel seguente modo:

1. Accedi ai messaggi di log di Logcat facendo clic su Logcat nella barra della finestra dello strumento Android Studio.
2. Cerca log che includono ActivityTaskManager.

Ricevi assistenza e risorse aggiuntive

Il plug-in dell'Assistente Google fornisce link a documentazione, codelab e altre risorse per l'apprendimento e l'assistenza per l'utilizzo dello strumento di test.

Puoi aprire l'assistente in Android Studio selezionando Strumenti > Assistente Google > Guida.

Figura 2. La sezione di aiuto del plug-in dell'Assistente Google.