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 percorsi facili 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 viaggi superano o meno il test.

Poiché Gemini ragiona su quali azioni 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 percorsi e risultati avanzati che ti aiutano a seguire meglio il ragionamento di Gemini e l'esecuzione del tuo percorso.

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 percorsi vengono scritti utilizzando la sintassi XML per organizzare la descrizione e i passaggi del percorso.

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 viaggio 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, aumenti la probabilità che Gemini esegua con precisione i viaggi che intendi fare in modo più deterministico. Ecco alcuni suggerimenti per scrivere i tuoi percorsi in modo più efficace: * Separa le asserzioni dalle azioni:Gemini valuta costantemente lo stato della tua app per determinare se è 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 far sapere a Gemini che questo passaggio deve essere un'asserzione. * Usa Gemini con gli swipe:oltre alle interazioni di base, come tocchi o input da tastiera, Gemini supporta azioni che richiedono di scorrere lo schermo in determinate direzioni. Ad esempio, per scorrere i contenuti o chiudere alcune UI, descrivi semplicemente la direzione e lo scopo dello scorrimento. Per impostazione predefinita, Gemini scorre dal centro dello schermo, ma puoi guidarlo a scorrere su un'altra parte dello schermo del dispositivo. * Evita interazioni complesse e modifiche alla configurazione:Gemini attualmente non supporta tutte le interazioni e le modifiche alla configurazione, come 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 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 l'app e si connette a Gemini per determinare quali azioni intraprendere per ogni passaggio del percorso.

Nell'editor vengono visualizzati anche risultati limitati durante l'esecuzione di un percorso, ad esempio gli screenshot, l'azione intrapresa e il ragionamento durante l'esecuzione di ogni passaggio del percorso. Basta passare il mouse sopra la miniatura nell'editor per visualizzare ulteriori informazioni. Questa opzione può essere utile quando esegui l'iterazione dei prompt nel tuo percorso.

Visualizza i risultati

Al termine del test del percorso da parte di Android Studio, il riquadro dei risultati del test viene visualizzato automaticamente per mostrare i risultati.

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

  • 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 capire come Gemini ha compreso e ragionato sul tuo viaggio e come è stato eseguito.
  • 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 dei percorsi 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 percorso:

    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.