Percorsi per Android Studio

Journeys per Android Studio sfrutta le funzionalità di visione e ragionamento dell'AI per navigare e testare la tua app in base alle tue istruzioni in linguaggio naturale. Il tuo insieme di istruzioni, chiamato percorso, viene convertito in azioni che l'AI esegue sulla tua app. Inoltre, puoi scrivere e descrivere asserzioni più complesse, che l'AI valuta in base a ciò che vede sul dispositivo.

Poiché Gemini ragiona su quali azioni eseguire per soddisfare gli obiettivi, i percorsi sono più resilienti ai cambiamenti sottili del layout o del 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.

Puoi scrivere ed eseguire i percorsi direttamente da Android Studio o dalla riga di comando su qualsiasi dispositivo Android locale o remoto. L'IDE offre una nuova esperienza di editor per creare percorsi, nonché risultati avanzati che ti aiutano a seguire meglio il ragionamento e l'esecuzione del percorso 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 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 del percorso.

3. Nella finestra di dialogo visualizzata, inserisci il nome e la descrizione del percorso.

   

4. Fai clic su Fine. 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 semplificata.

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 passaggio nello stesso percorso. Puoi ripetere questa operazione in base alle esigenze per ogni passaggio del percorso che vuoi definire.

Configurare le varianti di build

I percorsi vengono eseguiti su varianti di compilazione specifiche della tua app. Quando crei per la prima volta un percorso utilizzando la procedura guidata, la suite di test generata è configurata per essere eseguita sulla variante di compilazione attiva in Android Studio.

Tuttavia, se in un secondo momento cambi la variante di compilazione attiva in Android Studio (ad esempio, con un'altra versione prodotto come demoDebug) senza aggiornare la configurazione, l'esecuzione del percorso non andrà a buon fine. Per risolvere il problema, devi aggiungere la nuova variante alla proprietà targetVariants nel blocco testSuites del file build.gradle.kts (o build.gradle) a livello di modulo.

Ad esempio, per configurare la suite journeysTest per la variante demoDebug:

android {
    // ...
    testSuites {
        create("journeysTest") {
            // ...
            targetVariants += listOf("demoDebug")
        }
    }
}

Suggerimenti per scrivere i viaggi

Sebbene l'AI sia in grado di comprendere la maggior parte dei passaggi scritti nelle lingue supportate, seguire questi suggerimenti per scrivere i viaggi può portare a risultati più accurati e previsti:

• Supponiamo che la tua app sia già in primo piano:l'esecuzione di un viaggio avvia automaticamente l'app. I passaggi del viaggio devono iniziare dopo l'avvio completo dell'app. ovvero non è necessario includere "avvia app" come passaggio.
• Utilizza un linguaggio inequivocabile:la precisione riduce al minimo le interpretazioni errate e migliora l'affidabilità.

• Includi i criteri di successo come parte del passaggio:in questo modo Gemini comprende meglio la tua intenzione e chiarisce quando l'azione è completata e quando può iniziare l'azione successiva.

• Perfeziona il tuo viaggio:se il tuo viaggio non viene eseguito come previsto, puoi visualizzare i risultati ed esaminare "Azione intrapresa" e il relativo "Motivazione" per capire perché Gemini potrebbe non aver eseguito i passaggi come previsto. Utilizza queste informazioni per fornire maggiore chiarezza alle tue istruzioni.
• Suddividi il tuo percorso in passaggi più specifici: anche se l'AI può interpretare passaggi multi-azione, a volte passaggi discreti più granulari possono migliorare l'accuratezza e la riproducibilità del percorso.
  • "Errore: impossibile completare l'azione nel numero massimo consentito di tentativi": Se riscontri questo errore, prova a dividere i passaggi non riusciti in due o più passaggi più piccoli. Questo errore si verifica perché l'AI non è in grado di completare l'azione dopo aver tentato un numero massimo di interazioni con la tua app.

Funzionalità supportate e non supportate

Ecco una panoramica delle funzionalità supportate e non ancora completamente supportate quando scrivi i percorsi. I seguenti elenchi non sono esaustivi.

Le seguenti azioni sono supportate all'interno dei percorsi:

• Tocca gli elementi dell'interfaccia utente.
• Digita per inserire il testo nei campi di testo.
• Scorri in una determinata direzione per navigare nell'interfaccia utente.

Le seguenti funzionalità non sono completamente supportate al momento o potrebbero funzionare in modo non uniforme:

• Gesti con più dita (ad esempio, pizzicare per ingrandire): interazioni che richiedono due o più punti di contatto sullo schermo contemporaneamente, ad esempio pizzicare per ingrandire o ridurre lo zoom oppure scorrere con due dita.
• Pressione prolungata: premere e tenere premuto un dito per un periodo di tempo più lungo di un tocco standard.
• Doppio tocco: tocca rapidamente due volte la stessa posizione sullo schermo.
• Rotazione/piegatura dello schermo: gestione delle modifiche all'orientamento del dispositivo (ad esempio, tra verticale e orizzontale) o allo stato fisico dei dispositivi pieghevoli (ad esempio, apertura o chiusura).
• Memoria: conservazione e recupero di informazioni, contesto o input utente specifici in interazioni o passaggi precedenti.
• Conteggio: monitoraggio accurato di quantità, frequenze o progressi.
• Istruzioni condizionali: esecuzione di azioni in base al soddisfacimento di altre condizioni specificate.

Le funzionalità sono in costante miglioramento. Ti consigliamo di controllare questa pagina in un secondo momento per scoprire funzionalità aggiuntive. Per aiutarci a migliorare Itinerari, condividi il tuo feedback.

Esegui il tuo percorso

Puoi eseguire il percorso su qualsiasi dispositivo locale o remoto disponibile, in modo simile a qualsiasi altro test di instrumentazione, 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 l'app e si connette a Gemini per determinare quali azioni intraprendere per ogni passaggio del tuo percorso.

Esegui percorsi su qualsiasi app preinstallata

Puoi eseguire un percorso su un'app preinstallata sul tuo dispositivo di test. Questa opzione è utile se vuoi testare una versione di produzione della tua app o se non hai ancora aggiornato l'app al plug-in Android per Gradle 9.0.0 o versioni successive.

1. Apri o crea un nuovo progetto aggiornato al plug-in Android per Gradle 9.0.0 o versioni successive.
2. Scrivi un viaggio.
3. Modifica la configurazione di esecuzione per il viaggio e aggiungi le seguenti variabili di ambiente. Una configurazione di esecuzione viene creata automaticamente quando tenti di eseguire un percorso da Android Studio.
   • Imposta JOURNEYS_CUSTOM_APP_ID sull'ID pacchetto dell'app di destinazione.
4. Esegui il viaggio che hai modificato. Android Studio dovrebbe eseguire i passaggi del percorso nell'app di destinazione specificata.

Eseguire un percorso dalla riga di comando

Per eseguire Journeys dalla riga di comando, utilizza Android CLI.

Visualizza 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, 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.