Percorsi per Android Studio

La creazione di percorsi per Android Studio semplifica la scrittura e la manutenzione dei test end-to-end consentendoti di utilizzare il linguaggio naturale per descrivere i passaggi e le asserzioni per ogni test, chiamato percorso. Sfruttando le capacità di visione e ragionamento di Gemini, i passaggi scritti in linguaggio naturale vengono convertiti in azioni che Gemini esegue sulla tua app, rendendo i tuoi viaggi semplici da scrivere e comprendere. Inoltre, puoi scrivere e descrivere asserzioni più complesse, che Gemini valuta in base a ciò che vede sul dispositivo per determinare se i tuoi percorsi vengono superati o meno.

Poiché Gemini determina le azioni da eseguire per soddisfare gli obiettivi, i percorsi sono più resilienti ai cambiamenti sottili nel layout o nel comportamento dell'app, il che si traduce in un minor numero di test instabili quando vengono eseguiti su versioni diverse dell'app e su configurazioni diverse dei dispositivi.

Scrivi ed esegui percorsi direttamente da Android Studio su qualsiasi dispositivo Android locale o remoto. L'IDE offre una nuova esperienza di editor per creare viaggi, nonché risultati avanzati che ti aiutano a comprendere meglio il ragionamento e l'esecuzione del tuo viaggio da parte di Gemini.

Scrivere un viaggio

Android Studio fornisce un modello di file e una nuova esperienza di editor che semplifica la creazione e la modifica dei percorsi. I viaggi vengono scritti utilizzando la sintassi XML (Extensible Markup Language) per organizzare la descrizione e i passaggi del viaggio.

Per creare e iniziare a modificare un percorso:

1. Nel riquadro Progetto di Android Studio, fai clic con il tasto destro del mouse sul modulo dell'app per cui vuoi scrivere un percorso.
2. Seleziona Nuovo > Test > File del percorso.
3. Nella finestra di dialogo visualizzata, inserisci il nome e la descrizione del percorso.
4. Fai clic su OK. Android Studio crea un file XML per il tuo percorso con il nome che hai scelto. Puoi utilizzare la visualizzazione Codice per modificare direttamente l'XML o la visualizzazione Progettazione per un'esperienza di modifica migliorata.
5. Quando visualizzi il percorso nella visualizzazione Progettazione, utilizza il campo di testo per descrivere ogni passaggio del percorso. Ogni passaggio può includere azioni descrittive che vuoi che Gemini esegua o asserzioni che vuoi che Gemini valuti.
6. Premi Invio sulla tastiera per iniziare un nuovo prompt nello stesso viaggio. Puoi ripetere questa operazione in base alle esigenze per ogni passaggio del percorso che vuoi definire.

Suggerimenti per scrivere i viaggi

Se scrivi i tuoi viaggi in modo dettagliato e organizzato, puoi aumentare la probabilità che Gemini esegua con precisione i viaggi che intendi fare in modo più deterministico. Ecco alcuni suggerimenti per scrivere i tuoi viaggi in modo più efficace:

• Separare le asserzioni dalle azioni: Gemini valuta costantemente lo stato dell'app per determinare se si trova in uno stato "corretto" per continuare il percorso. Tuttavia, potrebbe essere necessario definire asserzioni più complesse come passaggio separato. Inoltre, inizia ogni prompt utilizzando frasi chiave come "Verifica che", "Afferma che" o "Controlla che" per indicare a Gemini che questo passaggio deve essere un'asserzione.
• Interazione diretta con Gemini tramite scorrimento:oltre alle interazioni di base, come toccare o inserire testo con la tastiera, Gemini supporta azioni che richiedono di scorrere lo schermo in determinate direzioni. Ad esempio, per scorrere i contenuti o chiudere alcune UI, descrivi la direzione e lo scopo dell'azione di scorrimento. Per impostazione predefinita, Gemini scorre dal centro dello schermo, ma puoi specificare che deve scorrere su un'altra parte dello schermo del dispositivo.
• Evita interazioni complesse e modifiche alla configurazione: Gemini non supporta tutte le interazioni e le modifiche alla configurazione, ad esempio gesti con più dita, rotazioni dello schermo o azioni di chiusura. Il team sta lavorando per migliorare le funzionalità di Gemini.

Esegui il tuo percorso

Puoi eseguire il percorso su qualsiasi dispositivo locale o remoto disponibile, in modo simile a qualsiasi altro test strumentato, e Android Studio genera risultati avanzati che ti aiutano a comprendere l'esecuzione del percorso.

Per testare un percorso:

1. Seleziona un dispositivo di destinazione dalla barra degli strumenti principale, come faresti quando esegui un test strumentato.
2. Vai al file XML del percorso che vuoi testare e aprilo nell'editor.
3. Nell'editor, esegui una delle seguenti operazioni:
   1. Se ti trovi nella visualizzazione Progettazione, fai clic su Esegui percorso.
   2. Se ti trovi nella visualizzazione Codice, fai clic su Esegui test nel margine accanto alla definizione del nome del percorso nell'XML.

Android Studio crea una configurazione Test di percorsi e la esegue sul dispositivo di destinazione. Durante l'esecuzione, Android Studio crea e implementa la tua app e si connette a Gemini per determinare le azioni da intraprendere per ogni passaggio del tuo percorso.

Passa il mouse sopra la miniatura nell'editor per visualizzare ulteriori informazioni. Questo può essere utile quando iteri i prompt nel tuo percorso.

Visualizza i risultati

Quando Android Studio completa il test del percorso, il riquadro dei risultati del test viene visualizzato automaticamente per mostrare i risultati.

Rispetto ad altri test strumentati che potresti eseguire in Android Studio, esistono alcune differenze nel modo in cui vengono visualizzati i risultati dei viaggi.

• Il riquadro Test suddivide il percorso in passaggi discreti. Puoi fare clic su ogni passaggio per scoprire di più su come è stato eseguito da Gemini.
• Il riquadro Risultati mostra informazioni dettagliate per aiutarti a comprendere l'interpretazione e il ragionamento di Gemini sul tuo viaggio e su come è stato eseguito da Gemini.
• Gli screenshot inviati a Gemini vengono mostrati come ausilio visivo in ogni azione del passaggio.
• Ogni azione intrapresa e il ragionamento di Gemini alla base di questa azione sono descritti accanto a ogni screenshot.
• Ogni azione nel passaggio è numerata.

Problemi noti

• Quando testi un percorso, tutte le autorizzazioni per la tua app vengono concesse per impostazione predefinita.
• Quando testi un percorso su un dispositivo con Android 15 (livello API 35), potresti visualizzare un avviso sul dispositivo che indica "App non sicura bloccata" per "AndroidX Crawler". Puoi fare clic su Installa comunque per ignorare questo controllo. In alternativa, puoi configurare le opzioni sviluppatore sul dispositivo e disattivare l'opzione per verificare le app tramite USB.
• Al momento i file dei viaggi non vengono visualizzati nella visualizzazione Android nel riquadro Progetti. Per visualizzare i file di viaggio nel tuo progetto, utilizza la visualizzazione Progetto.
• Se più azioni all'interno di un percorso condividono esattamente lo stesso prompt, i risultati del test visualizzati nell'editor del percorso potrebbero essere errati. Nello specifico, tutte le azioni con il prompt duplicato mostreranno i risultati del test associati all'istanza aggiornata più di recente del prompt. Per risolvere il problema, assicurati che ogni azione abbia un prompt univoco, ad esempio aggiungendo un prefisso o un suffisso distinto.
• La seconda volta che la tastiera viene caricata su un nuovo emulatore, viene visualizzato un popup dello stilo. Questo popup di solito causa l'esito negativo dei test che interagiscono con i campi di testo. In questo caso, chiudi il popup ed esegui di nuovo il percorso.
• Di tanto in tanto, gli artefatti del crawler delle app potrebbero essere visualizzati nella motivazione dell'agente.
• A volte l'esecuzione del percorso non va a buon fine e viene visualizzato un IllegalStateException. Quando si verifica questo problema, puoi fare clic su Risultati test per visualizzare l'errore completo.

• Se il plug-in Android per Gradle (com.android.application) non è definito nel file build.gradle di primo livello, potresti visualizzare il seguente errore durante l'esecuzione di un viaggio:

  Failed to apply plugin class 'com.android.tools.journeys.JourneysGradlePlugin'
  

  Per risolvere il problema, assicurati che il plug-in sia definito nel file build.gradle di primo livello. Per ulteriori informazioni, consulta Configurare il sistema di build Android.