Araçlı testler, fiziksel veya emülasyonlu Android cihazlarda çalışır. Bu nedenle, Android çerçeve API'lerinden yararlanabilirler. Bu nedenle, araçlı testler yerel testlere kıyasla daha fazla doğruluk sağlar ancak çok daha yavaş çalışır.
Enstrümantasyon testlerini yalnızca gerçek bir cihazın davranışına göre test yapmanız gereken durumlarda kullanmanızı öneririz. AndroidX Test, gerektiğinde enstrümantasyon testleri yazmayı kolaylaştıran çeşitli kitaplıklar sağlar.
Test ortamınızı ayarlama
Android Studio projenizde, araçlı testlerin kaynak dosyalarını module-name/src/androidTest/java/ dizininde saklarsınız. Yeni bir proje oluşturduğunuzda bu dizin zaten mevcuttur ve örnek bir enstrümantasyon testi içerir.
Başlamadan önce, uygulamalarınız için enstrümantasyon testi kodunu hızlıca derleyip çalıştırmanıza olanak tanıyan AndroidX Test API'lerini eklemeniz gerekir. AndroidX Test, bir JUnit 4 test çalıştırıcısı (AndroidJUnitRunner) ve Espresso, UI Automator ve Compose test gibi işlevsel kullanıcı arayüzü testleri için API'ler içerir.
Ayrıca, AndroidX Test tarafından sağlanan test çalıştırıcıyı ve kural API'lerini kullanmak için projenizin Android test bağımlılıklarını yapılandırmanız gerekir.
Uygulamanızın üst düzey build.gradle dosyasında bu kitaplıkları bağımlılık olarak belirtmeniz gerekir:
dependencies {
androidTestImplementation "androidx.test:runner:$androidXTestVersion"
androidTestImplementation "androidx.test:rules:$androidXTestVersion"
// Optional -- UI testing with Espresso
androidTestImplementation "androidx.test.espresso:espresso-core:$espressoVersion"
// Optional -- UI testing with UI Automator
androidTestImplementation "androidx.test.uiautomator:uiautomator:$uiAutomatorVersion"
// Optional -- UI testing with Compose
androidTestImplementation "androidx.compose.ui:ui-test-junit4:$compose_version"
}
En yeni sürümleri AndroidX Sürüm Notları ve Compose kullanıcı arayüzü Sürüm Notları'nda bulabilirsiniz.
JUnit 4 test sınıflarını kullanmak ve test filtreleme gibi özelliklere erişmek için uygulamanızın modül düzeyindeki build.gradle dosyasına aşağıdaki ayarı ekleyerek projenizde varsayılan test araçları çalıştırıcısı olarak AndroidJUnitRunner'ı belirttiğinizden emin olun:
android {
defaultConfig {
testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
}
}
Araçlı test sınıfı oluşturma
Enstrümantasyon test sınıfınız, yerel testler oluşturma bölümünde açıklanan sınıfa benzer bir JUnit 4 test sınıfı olmalıdır.
Araçlı bir JUnit 4 test sınıfı oluşturmak için varsayılan test çalıştırıcınız olarak AndroidJUnit4 değerini belirtin.
Aşağıdaki örnekte, LogHistory sınıfı için Parcelable arayüzünün doğru şekilde uygulandığını doğrulamak amacıyla nasıl bir enstrümantasyon testi yazabileceğiniz gösterilmektedir:
Kotlin
import android.os.Parcel import android.text.TextUtils.writeToParcel import androidx.test.filters.SmallTest import androidx.test.runner.AndroidJUnit4 import com.google.common.truth.Truth.assertThat import org.junit.Before import org.junit.Test import org.junit.runner.RunWith const val TEST_STRING = "This is a string" const val TEST_LONG = 12345678L // @RunWith is required only if you use a mix of JUnit3 and JUnit4. @RunWith(AndroidJUnit4::class) @SmallTest class LogHistoryAndroidUnitTest { private lateinit var logHistory: LogHistory @Before fun createLogHistory() { logHistory = LogHistory() } @Test fun logHistory_ParcelableWriteRead() { val parcel = Parcel.obtain() logHistory.apply { // Set up the Parcelable object to send and receive. addEntry(TEST_STRING, TEST_LONG) // Write the data. writeToParcel(parcel, describeContents()) } // After you're done with writing, you need to reset the parcel for reading. parcel.setDataPosition(0) // Read the data. val createdFromParcel: LogHistory = LogHistory.CREATOR.createFromParcel(parcel) createdFromParcel.getData().also { createdFromParcelData: List<Pair<String, Long>> -> // Verify that the received data is correct. assertThat(createdFromParcelData.size).isEqualTo(1) assertThat(createdFromParcelData[0].first).isEqualTo(TEST_STRING) assertThat(createdFromParcelData[0].second).isEqualTo(TEST_LONG) } } }
Java
import android.os.Parcel; import android.util.Pair; import androidx.test.runner.AndroidJUnit4; import com.google.common.truth.Truth.assertThat; import java.util.List; import org.junit.Before; import org.junit.Test; import org.junit.runner.RunWith; // @RunWith is required only if you use a mix of JUnit3 and JUnit4. @RunWith(AndroidJUnit4.class) public class LogHistoryAndroidUnitTest { public static final String TEST_STRING = "This is a string"; public static final long TEST_LONG = 12345678L; private LogHistory mLogHistory; @Before public void createLogHistory() { mLogHistory = new LogHistory(); } @Test public void logHistory_ParcelableWriteRead() { // Set up the Parcelable object to send and receive. mLogHistory.addEntry(TEST_STRING, TEST_LONG); // Write the data. Parcel parcel = Parcel.obtain(); mLogHistory.writeToParcel(parcel, mLogHistory.describeContents()); // After you're done with writing, you need to reset the parcel for reading. parcel.setDataPosition(0); // Read the data. LogHistory createdFromParcel = LogHistory.CREATOR.createFromParcel(parcel); List<Pair<String, Long>> createdFromParcelData = createdFromParcel.getData(); // Verify that the received data is correct. assertThat(createdFromParcelData.size()).isEqualTo(1); assertThat(createdFromParcelData.get(0).first).isEqualTo(TEST_STRING); assertThat(createdFromParcelData.get(0).second).isEqaulTo(TEST_LONG); } }
Enstrümantasyon testlerini çalıştırma
Araçlı testler gerçek cihazlarda veya emülatörlerde çalıştırılabilir. Android Studio kılavuzunda şunları nasıl yapacağınızı öğrenebilirsiniz:
Ek kaynaklar
Kullanıcı arayüzü testleri genellikle kullanıcı arayüzünün doğru davranışını doğrulayan araçlı testlerdir. Espresso veya Compose Test gibi çerçeveler kullanırlar. Daha fazla bilgi edinmek için Kullanıcı arayüzü test kılavuzu'nu okuyun.
Enstrümantasyon testlerini kullanma hakkında daha fazla bilgi için aşağıdaki kaynakları inceleyin.