Questa guida descrive come preparare ed eseguire un test di misurazione utilizzando Firebase Test Lab. Per utilizzare questa guida, ti serviranno test di strumentazione (scritto da te o dal tuo team) che utilizza il Espresso o UI Automator Framework di test Android. I test di strumentazione possono eseguire fino a 45 minuti su dispositivi fisici e fino a 60 minuti su dispositivi virtuali.
Nei passaggi successivi, devi caricare l'APK dell'app e l'APK del test a Firebase.
(Facoltativo) Aggiungere la raccolta di screenshot all'app
Firebase Test Lab include una libreria (testlab-instr-lib) che puoi
utilizzare per elaborare gli screenshot acquisiti con ScreenCapture di AndroidX
quando esegui test di misurazione, ad esempio i test scritti utilizzando il
framework di test Espresso.
Questa sezione descrive come creare oggetti ScreenCapture
con la libreria AndroidX e come elaborarli utilizzando testlab-instr-lib.
Dopo aver eseguito il test di misurazione, puoi visualizzare gli screenshot acquisiti nella console Firebase.
Prova un'app di esempio
Scarica l'app di esempio NotePad per provare questa funzionalità. La possibilità di acquisire screenshot è già integrata nel progetto Notepad.
Passaggio 1: Aggiungere la libreria di screenshot al progetto
Nel file Gradle delle impostazioni a livello di radice del progetto di test (
settings.gradle.kts
osettings.gradle
), aggiungi il repository Maven di Google a ogni sezionerepositories
:pluginManagement { repositories { // Add the following line: google() // Google's Maven repository mavenCentral() gradlePluginPortal() } } dependencyResolutionManagement { repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS) repositories { // Add the following line: google() // Google's Maven repository mavenCentral() } } // ...
Nel file Gradle del modulo (a livello di app) (di solito
<project>/<app-module>/build.gradle.kts
o<project>/<app-module>/build.gradle
), aggiungi una dipendenza per la libreria di screenshot Test Lab.dependencies { // ... // Add Test Lab's instrumentation test screenshot library: androidTestImplementation("com.google.firebase:testlab-instr-lib:0.2") // ...
Nel file
AndroidManifest.xml
del test, registra il valoreFirebaseScreenCaptureProcessor
in un tag di metadati all'interno della Elemento<instrumentation>
. Puoi anche specificare il processore come in AndroidJUnitRunner (vedi l'argomento Documentazione di riferimento AndroidJUnitRunner per istruzioni).<instrumentation // Check that you have the following line (if not, add it): android:name="androidx.test.runner.AndroidJUnitRunner" // Specifies AndroidJUnitRunner as the test runner android:targetPackage="com.your.package.name"> // Add the following: <meta-data android:name="screenCaptureProcessors" android:value="com.google.firebase.testlab.screenshot.FirebaseScreenCaptureProcessor" /> </instrumentation> ...
Nel file
AndroidManifest.xml
dell'app, aggiungi le seguenti righe all'interno dell'elemento<manifest>
:<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
Nel file
AndroidManifest.xml
, specifica le autorizzazioni di sistema per la tua app aggiungendo le seguenti righe all'interno del tag<manifest>
. Se stai testando Su Android 10 (livello API 29) o versioni successive, omettiWRITE_EXTERNAL_STORAGE
(la tua app non richiede questa autorizzazione per leggere e scrivi screenshot sul dispositivo).<manifest ... > <!-- WRITE_EXTERNAL_STORAGE is not needed on Android 10 (API level 29) or higher. --> <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/> <uses-permission android:name="android.permission.INTERNET"/> ... </manifest>
Passaggio 2: Acquisire screenshot durante il test
In qualsiasi momento del test in cui vuoi acquisire uno screenshot, chiama il metodo
Screenshot.capture()
dalla raccolta AndroidX. Questo produce
Oggetto ScreenCapture
.
Quando chiami process()
sull'oggetto ScreenCapture
, questo viene elaborato
usando lo strumento Screen CaptureProcessor
registrato nel tuo AndroidManifest.xml
. Tieni presente che
BasicScreenCaptureProcessor
viene utilizzato se non sono registrati processori.
Dato che hai registrato FirebaseScreenCaptureProcessor
, i tuoi screenshot
verrà elaborato tramite FirebaseScreenCaptureProcessor
e sarà disponibile
per te con i risultati quando esegui il test con Firebase Test Lab.
Esempi di casi d'uso per la creazione di un ScreenCapture
:
Acquisisci uno screenshot completo su una build API.VERSION_CODES.JELLY_BEAN_MR2 e sopra:
Screenshot.capture()
Acquisisci un
ScreenCapture
dell'attività a qualsiasi livello API. Tieni presente che questa è l'unica opzione per i dispositivi precedenti a Build.VERSION_CODES.JELLY_BEAN_MR2.@Rule public ActivityTestRule<MainActivity> activityRule = new ActivityTestRule<>(MainActivity.class); ... Screenshot.capture(activityRule.getActivity()); ...
Esempi di casi d'uso per l'elaborazione di una schermata acquisita
Elabora un
ScreenCapture
tramite ilFirebaseScreenCaptureProcessor
:Screenshot.capture().process();
Elabora un
ScreenCapture
tramite unScreenCaptureProcessor
specificato (in questo modo puoi saltare la registrazione del processore):Set<ScreenCaptureProcessor> processors = new HashSet<>(); processors.add(new FirebaseScreenCaptureProcessor()); Screenshot.capture().process(processors);
Imposta il nome e il formato del
ScreenCapture
ed elaboralo utilizzando il processore registrato:Screenshot.capture().setName("myscreenshot").setFormat(CompressFormat.JPEG).process();
Passaggio 3: Crea ed esegui il test
Sviluppa la tua app e testa gli APK (vedi Testare l'app per istruzioni).
Carica i file APK nella dashboard Test Lab della console Firebase.
Infine, esegui il test.
Passaggio 4: Visualizzare gli screenshot del test
Al termine del test, puoi visualizzare gli screenshot acquisiti nella console Firebase.
Nella scheda Test, seleziona il test completato. e poi fai clic sulla scheda Risultati.
Seleziona di nuovo il test e fai clic sulla scheda Screenshot che viene visualizzata.
(Facoltativo) Attivare funzionalità di test aggiuntive
Puoi abilitare le seguenti funzionalità nel test prima di eseguirlo con Test Lab:
Attiva Orchestrator
Android Test Orchestrator è uno strumento che esegue in modo indipendente ogni test di misurazione della tua app. Test Lab utilizza sempre la versione più recente di Orchestrator.
Per attivare Orchestrator per Test Lab, nella configurazione del test di strumentazione, fai clic su Opzioni aggiuntive > Esegui con Orchestrator.
Quando utilizzi Orchestrator, puoi usufruire di quanto segue:
- Nessuno stato condiviso. Ogni test viene eseguito nella propria istanza di instrumentazione, pertanto uno stato condiviso non si accumula nei test.
- Arresti anomali isolati. Se un test si arresta in modo anomalo, la strumentazione viene terminata e gli altri test nella tua suite possono continuare a essere eseguiti.
Tieni presente che quando utilizzi Orchestrator, ogni test viene eseguito in modo indipendente di strumentazione, il che significa che il processo dell'app viene riavviato dopo in ogni scenario di test. I tempi di esecuzione più lunghi che ne derivano potrebbero influire sul tuo utilizzo della quota o sul tempo fatturato e potrebbero portarti a superare i limiti di timeout dei tuoi dispositivi. Se riduci il livello tempi di avvio, questo overhead si accorcierà.
Per impostare opzioni aggiuntive per Orchestrator, specificale tramite
Campo environmentVariables
: Ad esempio, per utilizzare clearPackageData
, utilizza questa
opzione in gcloud:
--environment-variables clearPackageData=true
Attivare lo sharding
La suddivisione in blocchi dei test suddivide un insieme di test in sottogruppi (blocchi) che vengono eseguiti singolarmente in modo isolato. Test Lab esegue automaticamente ogni shard in parallelo usando più dispositivi e permette di completare l'intero set di test in meno tempo.
Ad esempio, se crei N shard, per ogni dispositivo selezionato, Test Lab avvia N dispositivi identici ed esegue un sottoinsieme di test su ciascun dispositivo. Ciò significa che gli scenari di test con sharding possono comportare più esecuzioni di test per dispositivo. Gli scenari di test non suddivisi, tuttavia, comportano un'esecuzione di test per dispositivo. Per apprendere i concetti di Test Lab, consulta Concetti principali.
Per abilitare il test dello sharding nella console Firebase, segui questi passaggi:
Nella configurazione del test di strumentazione, fai clic su Opzioni aggiuntive.
Nella sezione Sharding, inserisci il numero di shard che vuoi eseguire.
Fatturazione per gli shard di test
Test Lab implementa gli shard sfruttando la tecnologia integrata di AndroidJUnitRunner meccanismo di sharding. Per evitare l'addebito per l'avvio di shard vuoti (shards senza assegnati scenari di test), il numero di shard che devono essere inferiori al numero totale di scenari di test. A seconda del tempo di esecuzione di ogni scenario di test, in genere è buona norma assegnare 2-10 scenari di test per shard.
Per ulteriori informazioni sulla fatturazione, leggi Utilizzo, quote e fatturazione.