اختبار تنسيق Compose

اختبِر واجهة المستخدم لتطبيقك للتحقق من صحة سلوك رمز Compose. ويتيح لك ذلك اكتشاف الأخطاء مبكرًا وتحسين جودة تطبيقك.

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

المشاهدات

إذا كنت تستخدم الملفات الشخصية بدلاً من ميزة "إنشاء"، يُرجى الاطّلاع على القسم العام اختبار التطبيقات على Android.

على وجه الخصوص، يمكنك البدء بدليل اختبارات واجهة المستخدم المبرمَجة. ويوضّح هذا القسم كيفية برمجة الاختبارات التي يتم إجراؤها على الجهاز، بما في ذلك عند استخدام طرق العرض.

المفاهيم الرئيسية

في ما يلي بعض المفاهيم الأساسية لاختبار رمز Compose.

• الدلالات: تتفاعل اختبارات الإنشاء مع واجهة المستخدم باستخدام الدلالات، التي تمنح معنى لقطع واجهة المستخدم ويتم إنشاؤها إلى جانب التسلسل الهرمي لواجهة المستخدم.
• اختبار واجهات برمجة التطبيقات: توفّر أداة Compose واجهات برمجة تطبيقات للاختبار للعثور على العناصر، وإجراء تأكيدات على حالتها وخصائصها، وتنفيذ إجراءات لمحاكاة تفاعلات المستخدمين.
• المزامنة: تتم تلقائيًا مزامنة اختبارات Compose مع واجهة المستخدم، في انتظار أن تصبح غير نشِطة قبل إجراء التأكيدات أو تنفيذ الإجراءات.
• إمكانية التشغيل التفاعلي: في التطبيقات المختلطة، يمكن أن تتفاعل الاختبارات بسلاسة مع كل من العناصر المستندة إلى الإنشاء والعرض، والتكامل مع أطر الاختبار الأخرى.

// Test rules and transitive dependencies:
androidTestImplementation("androidx.compose.ui:ui-test-junit4:$compose_version")
// Needed for createComposeRule(), but not for createAndroidComposeRule<YourActivity>():
debugImplementation("androidx.compose.ui:ui-test-manifest:$compose_version")

// file: app/src/androidTest/java/com/package/MyComposeTest.kt

class MyComposeTest {

    @get:Rule val composeTestRule = createComposeRule()
    // use createAndroidComposeRule<YourActivity>() if you need access to
    // an activity

    @Test
    fun myTest() {
        // Start the app
        composeTestRule.setContent {
            MyAppTheme {
                MainScreen(uiState = fakeUiState, /*...*/)
            }
        }

        composeTestRule.onNodeWithText("Continue").performClick()

        composeTestRule.onNodeWithText("Welcome").assertIsDisplayed()
    }
}