Plug-in dell'Assistente Google per Android Studio

Il plug-in Assistente Google verifica le Azioni app in Android Studio. Durante lo sviluppo e il test, utilizza il plug-in per creare un'anteprima delle Azioni app nell'assistente per il tuo Account Google. Puoi quindi testare il modo in cui Azione app gestisce vari parametri prima di inviarla per il deployment.

Come funziona

Il plug-in dell'Assistente Google include lo strumento App Actions Test, una funzionalità analizza il file scorciatoie.xml e crea un'anteprima delle Azioni app per un con un solo Account Google. Queste anteprime consentono all'Assistente Google di riconoscere il tuo Azioni app prima di eseguire il deployment della versione di produzione dell'app nell'account Google in Play Console.

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

Una volta creata un'anteprima, puoi attivare un'Azione app sul dispositivo di test direttamente dalla finestra dello strumento di test. Per gli intent integrati disponibili per l'attivazione da parte degli utenti, puoi usare app name direttamente nell'assistente sul tuo dispositivo per provare l'Azione app. Ad esempio, puoi dire "Hey Google, avvia l'allenamento utilizzando App di esempio" per avviare un'Azione app che utilizza actions.intent.START_EXERCISE intent integrato.

Supporto delle impostazioni internazionali

La creazione di anteprime per impostazioni internazionali specifiche nello strumento di test varia in base all'intent integrato. La pagina di ogni intent integrato nel riferimento dell'intent integrato fornisce informazioni sulle funzionalità disponibili per l'intent integrato, ad esempio se lo strumento di test supporta la creazione di anteprime per una lingua specifica e se le Azioni app sono disponibili per gli 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, consulta la pagina Android Studio.

Per installare il plug-in dell'Assistente Google in Android Studio:

  1. Vai su File > Impostazioni (Android Studio > Preferenze su macOS).
  2. Nella sezione plug-in, 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 di 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 lo stesso account utente in Android Studio, sul dispositivo di test e per Google Play l'accesso alla console.

Prepara l'ambiente di sviluppo con le seguenti configurazioni:

  • Accedi ad Android Studio (versione 4.0 o successive).
  • Con lo stesso account, accedi all'app Google sul 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 dispositivo di test Android e completa la procedura di configurazione iniziale dell'assistente.
  • Attiva la sincronizzazione dei dati del dispositivo sul dispositivo di test.

Limitazioni

Il plug-in Assistente Google presenta le seguenti limitazioni:

  • Azioni app che incorporano l'inventario web e chiamata all'app in primo piano non possono essere testati direttamente nello strumento di test o tramite il bridge di debug Android (adb) tramite comandi SQL. Per testare queste Azioni app, crea prima un'anteprima utilizzando lo strumento di test lo strumento a riga di comando gcloud. Dopodiché, attiva le Azioni app interagendo con l'Assistente Google sul tuo dispositivo fisico.
  • Inventario incorporato per actions.intent.OPEN_APP_FEATURE L'intent integrato può essere testato solo per un periodo di sei ore dopo l'esecuzione di un'anteprima creato o aggiornato. Aggiorna l'anteprima dello strumento di test o creane una nuova per reimpostare il periodo di sei ore.

Aggiungi altri tester

Puoi invitare altri utenti nel tuo progetto in modo che possano testare Integrazione delle Azioni app. Ciò è utile quando vuoi condividere il progetto con gli altri membri del team di sviluppo, in modo che tutti possano eseguire test o condividere il progetto con i tester del controllo qualità (QA) in preparazione lancio in produzione. I tester devono essere aggiunti come tester delle licenze sul Google Play Store e deve essere concesso loro l'accesso di sola lettura a Google Play Console.

Per aggiungere altri tester:

  1. Accedi a Play Console.

  2. Segui le istruzioni riportate in Configurare le licenze dell'applicazione in questo Argomento del Centro assistenza Play Console.

    Aggiungi un tester delle licenze tramite Google Play Console.
    Figura 1. Aggiunta di un tester delle licenze.

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

    1. Seleziona Utente e autorizzazioni > Invita nuovi utenti > Aggiungi app.
    2. In Accesso alle app, assicurati che la casella di controllo Amministratore (tutte le autorizzazioni) sia cancellato.
di Gemini Advanced.

Devi accedere per ogni tester che vuoi abilitare per i test di anteprima separatamente da Android Studio con l'Account Google dell'utente. Una volta effettuato l'accesso, Utilizzare il plug-in dell'Assistente Google per creare un'anteprima per l'utente di test.

Usare il plug-in dell'Assistente Google

Accedi allo strumento di test delle Azioni app in Android Studio da Strumenti > Assistente Google > Strumento di test delle Azioni app. Quando apri lo strumento, la visualizzazione cambia in base al fatto che tu abbia un'anteprima dello strumento di test attiva.

Crea, aggiorna ed elimina le anteprime

Per i test puoi utilizzare una versione di bozza dell'app. Per ulteriori informazioni, consulta Preparare e implementare una release. Testa la tua app in modalità bozza prima del giorno per sottoporlo a revisione.

Lo strumento di test crea anteprime in base al tuo Account Google e al nome del pacchetto dell'app (ID applicazione), in modo da poter 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 lo stesso per creare anteprime separate per l'app in questione.

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

  1. Apri lo strumento di test delle Azioni app.
  2. Se vuoi, inserisci il nome dell'app e le impostazioni internazionali per i test. Il nome e le impostazioni internazionali dell'app predefinite sono test app action e en.
  3. Fai clic su Crea anteprima. Se richiesto, esamina e accetta le Azioni app norme e termini di servizio. Una volta creata l'anteprima, lo strumento di test vengono aggiornate per visualizzare le informazioni sugli intent integrati scorciatoie.xml.

Lo strumento di test utilizza il nome dell'app per creare e simulare query dell'assistente per le tue azioni di app. Le Azioni app implementate utilizzano il nome dell'app Play Store ma puoi utilizzare qualsiasi nome di chiamata nello strumento di test. Tuttavia, ti consigliamo di utilizzare il nome dell'app come nome di chiamata nello strumento di test.

Le impostazioni internazionali fornite devono corrispondere alla lingua dell'Assistente Google sul dispositivo di test e puoi creare un'anteprima in una sola lingua alla volta. Per Ad esempio, se la lingua dell'assistente è l'inglese (USA), puoi inserire en-US, non en-**, en-GB o en-US, en-GB. Puoi usare un'impostazione internazionale principale, ad esempio come 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. Quindi, inserisci il nome e le impostazioni internazionali dell'app prima di creare una nuova anteprima.

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

configura un intent integrato

Dopo aver creato un'anteprima per l'app, puoi testare vari parametri per gli intent integrati nel plug-in. Per ogni intent integrato scorciatoie.xml, il plug-in esegue il rendering di una JSON-LD e fornisce valori parametro predefiniti. Puoi modificarli valori predefiniti per testare le Azioni app con combinazioni di parametri significative e assicurarsi che eseguano le funzioni corrette dell'app.

In genere i parametri e i relativi valori seguono le schema.org o Struttura schema.googleapis.com per strutture e descrizioni. Puoi visualizzare informazioni su qualsiasi parametro degli intent integrati accedendo allo schema descrizioni di un parametro e dei suoi parametri di livello superiore.

Ad esempio, l'intent integrato actions.intent.GET_FOOD_OBSERVATION supporta il parametro di intent foodObservation.forMeal. La schema.googleapis.com pagina per MealType elenca name come proprietà. La proprietà forMeal è una modalità di trasferimento e si aspetta valori (come MealTypeLunch) del tipo enumerato MealType.

Nella strumento di test, puoi fornire una qualsiasi delle enumerazioni come valore foodObservation.forMeal:

  • https://schema.googleapis.com/MealTypeSnack
  • https://schema.googleapis.com/MealTypeBrunch
  • https://schema.googleapis.com/MealTypeLunch
  • https://schema.googleapis.com/MealTypeBreakfast
  • https://schema.googleapis.com/MealTypeDinner
  • https://schema.googleapis.com/MealTypeDesert

Attivare Azioni app

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

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

  1. Connetti il dispositivo di test.
  2. Nella sezione Seleziona dispositivo di destinazione, scegli il dispositivo su cui vuoi 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 visualizzato Android Debug Bridge (adb). Il comando shell adb generato Includa tutti i metadati richiesti dall'app Google per eseguire un intent integrato. Questo approccio riproduce il comportamento dell'Azione app dopo l'assistente estrae informazioni chiave da una query.

Log di Android Studio

I log specifici dello strumento di test sono disponibili in File di log di Android Studio, non come Logcat come output. I processi eseguiti direttamente sulla workstation generano Android Studio logaritmi. Puoi utilizzarle per risolvere i problemi con le operazioni dello strumento di test, come creazione, l'aggiornamento o l'eliminazione di un'anteprima.

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

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

Per recuperare i log delle Azioni app per il tuo dispositivo, segui questi passaggi:

  1. Accedi ai messaggi di log di Logcat facendo clic su Logcat in Android Studio. barra della finestra degli strumenti.
  2. Cerca i log che includono ActivityTaskManager.

Ricevi assistenza e risorse aggiuntive

Il plug-in dell'Assistente Google fornisce link a documentazione, codelab e altre risorse per imparare a utilizzare lo strumento di test e ricevere assistenza.

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

Assistente per lo strumento di test delle Azioni app Figura 2. La sezione della guida del plug-in dell'Assistente Google.