Questa guida illustra l'installazione di Espresso mediante SDK Manager e la sua creazione con Gradle. È consigliato Android Studio.
Configura l'ambiente di test
Per evitare irregolarità, ti consigliamo vivamente di disattivare le animazioni di sistema sui dispositivi virtuali o fisici utilizzati per i test. Sul dispositivo, in Impostazioni > Opzioni sviluppatore, disattiva le seguenti tre impostazioni:
- Scala animazione finestra
- Scala animazione transizione
- Scala durata animatore
Aggiungi dipendenze Espresso
Per aggiungere dipendenze Espresso al progetto, completa i seguenti passaggi:
- Apri il file
build.gradle
dell'app. Di solito non è il filebuild.gradle
di primo livello, maapp/build.gradle
. - Aggiungi le seguenti righe all'interno delle dipendenze:
Alla moda
androidTestImplementation 'androidx.test.espresso:espresso-core:3.4.0' androidTestImplementation 'androidx.test:runner:1.4.0' androidTestImplementation 'androidx.test:rules:1.4.0'
Kotlin
androidTestImplementation('androidx.test.espresso:espresso-core:3.4.0') androidTestImplementation('androidx.test:runner:1.4.0') androidTestImplementation('androidx.test:rules:1.4.0')
Visualizza il set completo di dipendenze Gradle.
Imposta il runner della strumentazione
Aggiungi allo stesso file build.gradle
la seguente riga in
android.defaultConfig
:
Alla moda
testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
Kotlin
testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner"
File di build Gradle di esempio
Alla moda
plugins { id 'com.android.application' } android { compileSdkVersion 33 defaultConfig { applicationId "com.my.awesome.app" minSdkVersion 21 targetSdkVersion 33 versionCode 1 versionName "1.0" testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner" } } dependencies { androidTestImplementation 'androidx.test:runner:1.4.0' androidTestImplementation 'androidx.test.espresso:espresso-core:3.4.0' }
Kotlin
plugins { id("com.android.application") } android { compileSdkVersion(33) defaultConfig { applicationId = "com.my.awesome.app" minSdkVersion(21) targetSdkVersion(33) versionCode = 1 versionName = "1.0" testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner" } } dependencies { androidTestImplementation('androidx.test:runner:1.4.0') androidTestImplementation('androidx.test.espresso:espresso-core:3.4.0') }
Analytics
Per assicurarci di essere sulla strada giusta con ogni nuova release, il runner del test raccoglie dati e analisi. In particolare, per ogni chiamata viene caricato un hash del nome del pacchetto dell'applicazione sottoposta a test. Questo ci consente di misurare sia il conteggio dei pacchetti unici utilizzando Espresso, sia il volume di utilizzo.
Se non vuoi caricare questi dati, puoi disattivarli includendo l'argomento
disableAnalytics
nel comando instrumentation:
adb shell am instrument -e disableAnalytics true
Aggiungi il primo test
Android Studio crea test per impostazione predefinita in src/androidTest/java/com.example.package/
.
Esempio di test JUnit4 con regole:
Kotlin
@RunWith(AndroidJUnit4::class) @LargeTest class HelloWorldEspressoTest { @get:Rule val activityRule = ActivityScenarioRule(MainActivity::class.java) @Test fun listGoesOverTheFold() { onView(withText("Hello world!")).check(matches(isDisplayed())) } }
Java
@RunWith(AndroidJUnit4.class) @LargeTest public class HelloWorldEspressoTest { @Rule public ActivityScenarioRule<MainActivity> activityRule = new ActivityScenarioRule<>(MainActivity.class); @Test public void listGoesOverTheFold() { onView(withText("Hello world!")).check(matches(isDisplayed())); } }
Esegui test
Puoi eseguire i test in Android Studio o dalla riga di comando.
In Android Studio
Per creare una configurazione di test in Android Studio, procedi nel seguente modo:
- Apri Run > Edit Configurations (Esegui > Modifica configurazioni).
- Aggiungi una nuova configurazione di Android Tests.
- Scegli un modulo.
- Aggiungi un runner della strumentazione specifico:
androidx.test.runner.AndroidJUnitRunner
- Esegui la configurazione appena creata.
Dalla riga di comando
Esegui questo comando Gradle:
./gradlew connectedAndroidTest