إنشاء اختبارات باستخدام الآلات

يتم إجراء اختبارات قياس حالة التطبيق على أجهزة Android، سواء كانت أجهزة فعلية أو محاكاة. وبالتالي، يمكنها الاستفادة من واجهات برمجة التطبيقات لإطار عمل Android. وبالتالي، توفّر الاختبارات الآلية دقة أعلى من الاختبارات المحلية، على الرغم من أنّها تعمل بشكل أبطأ بكثير.

ننصح باستخدام اختبارات لقياس حالة التطبيق فقط في الحالات التي يجب فيها إجراء الاختبار وفقًا لسلوك جهاز حقيقي. يوفّر AndroidX Test عدة مكتبات تسهّل كتابة اختبارات لقياس حالة التطبيق عند الضرورة.

إعداد بيئة الاختبار

في مشروعك على "استوديو Android"، يمكنك تخزين ملفات المصدر للاختبارات الآلية في module-name/src/androidTest/java/. هذا الدليل موجود بالفعل عند إنشاء مشروع جديد ويحتوي على مثال لاختبار لقياس حالة التطبيق.

قبل البدء، عليك إضافة واجهات برمجة تطبيقات AndroidX Test، والتي تتيح لك إنشاء وتشغيل رمز اختبار لقياس حالة التطبيق لتطبيقاتك بسرعة. يتضمّن AndroidX Test أداة تشغيل اختبارات JUnit 4،‏ AndroidJUnitRunner، وواجهات برمجة تطبيقات لاختبارات واجهة المستخدم الوظيفية، مثل Espresso وUI Automator وCompose test.

عليك أيضًا ضبط تبعيات اختبار Android لمشروعك من أجل استخدام مشغّل الاختبار وواجهات برمجة التطبيقات للقواعد التي يوفّرها AndroidX Test.

في ملف 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);
    }
}

إجراء اختبارات لقياس حالة التطبيق

يمكن إجراء الاختبارات الآلية على أجهزة حقيقية أو محاكيات. في دليل &quot;استوديو Android&quot;، يمكنك التعرّف على كيفية:

مراجع إضافية

اختبارات واجهة المستخدم هي عادةً اختبارات لقياس حالة التطبيق تتحقّق من السلوك الصحيح لواجهة المستخدم. وتستخدم هذه الاختبارات إطارات عمل مثل Espresso أو Compose Test. لمزيد من المعلومات، يُرجى الاطّلاع على دليل اختبار واجهة المستخدم.

لمزيد من المعلومات حول استخدام اختبارات قياس الأداء، يُرجى الاطّلاع على المراجع التالية.

عيّنة