פיתוח בדיקות במכשירים

הרצת בדיקות אינסטרומנטציה במכשירי Android, פיזיים או באמולטור. לכן, הם יכולים להשתמש בממשקי ה-API של Android framework. לכן, בדיקות עם כלים מספקות דיוק רב יותר מבדיקות מקומיות, אבל הן פועלות הרבה יותר לאט.

מומלץ להשתמש בבדיקות אינסטרומנטציה רק במקרים שבהם צריך לבדוק את ההתנהגות של מכשיר אמיתי. ב-AndroidX Test יש כמה ספריות שמקלות על כתיבת בדיקות אינסטרומנטציה כשצריך.

הגדרת סביבת הבדיקה

בפרויקט ב-Android Studio, קובצי המקור של הבדיקות המכשוריות מאוחסנים ב-module-name/src/androidTest/java/. הספרייה הזו כבר קיימת כשיוצרים פרויקט חדש, והיא מכילה דוגמה לבדיקת אינסטרומנטציה.

לפני שמתחילים, צריך להוסיף ממשקי API של AndroidX Test, שמאפשרים ליצור ולהריץ במהירות קוד בדיקת אינסטרומנטציה לאפליקציות. ‫AndroidX Test כולל כלי להרצת בדיקות של JUnit 4, ‏AndroidJUnitRunner, וממשקי API לבדיקות פונקציונליות של ממשק המשתמש, כמו Espresso, ‏UI Automator ובדיקת פיתוח נייטיב.

כדי להשתמש בכלי להרצת הבדיקות ובממשקי ה-API של הכללים שסופקו על ידי AndroidX Test, צריך גם להגדיר את יחסי התלות של הבדיקות ב-Android לפרויקט.

בקובץ build.gradle ברמה העליונה של האפליקציה, צריך לציין את הספריות האלה כיחסי תלות:

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"
}

אתם יכולים למצוא את הגרסאות העדכניות בנתוני הגרסה של AndroidX ובנתוני הגרסה של ממשק המשתמש של Compose.

כדי להשתמש במחלקות בדיקה של JUnit 4 ולקבל גישה לתכונות כמו סינון בדיקות, צריך לוודא ש-AndroidJUnitRunner מוגדר ככלי ברירת המחדל להרצת בדיקות אינסטרומנטציה בפרויקט. לשם כך, מוסיפים את ההגדרה הבאה לקובץ build.gradle ברמת המודול של האפליקציה:

android {
    defaultConfig {
        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
    }
}

יצירת מחלקת בדיקת אינסטרומנטציה

מחלקת בדיקת האינסטרומנטציה שלכם צריכה להיות מחלקת בדיקה של JUnit 4, שדומה למחלקה שמתוארת בקטע על בניית בדיקות מקומיות.

כדי ליצור מחלקת בדיקה של JUnit 4 עם אינסטרומנטציה, צריך לציין את AndroidJUnit4 בתור מריץ הבדיקות שמוגדר כברירת מחדל.

בדוגמה הבאה מוצג איך אפשר לכתוב בדיקת אינסטרומנטציה כדי לוודא שהממשק Parcelable מוטמע בצורה נכונה במחלקה LogHistory:

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);
    }
}

הרצת בדיקות אינסטרומנטציה

אפשר להריץ בדיקות עם כלים במכשירים אמיתיים או באמולטורים. במדריך של Android Studio מוסבר איך:

מקורות מידע נוספים

בדיקות של ממשק המשתמש הן בדרך כלל בדיקות עם כלים שמאמתות את ההתנהגות הנכונה של ממשק המשתמש. הן משתמשות במסגרות כמו Espresso או Compose Test. מידע נוסף זמין במדריך לבדיקת ממשק המשתמש.

למידע נוסף על השימוש בבדיקות אינסטרומנטציה, עיינו במקורות המידע הבאים.

דוגמה