الاختبار

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

إلى جانب التحقّق اليدوي، يجب أيضًا استخدام الاختبار المبرمَج للإشارة إلى أي مشاكل محتملة قد تؤثر في تجربة المستخدم أثناء إجراء تغييرات مستمرة على تطبيقك.

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

عمليات التحقّق من تسهيل الاستخدام

لاختبار تسهيل الاستخدام المبرمَج، يمكنك أيضًا استخدام إطار عمل اختبار تسهيل الاستخدام، وهو الإطار الأساسي نفسه الذي يشغّل أداة Accessibility Scanner وعمليات فحص تسهيل الاستخدام في Espresso، لإجراء بعض عمليات الفحص ذات الصلة بتسهيل الاستخدام تلقائيًا، بدءًا من الإصدار 1.8.0 من أداة Compose.

لتفعيل عمليات التحقّق، أضِف ui-test-junit4-accessibility dependency، اطلب enableAccessibilityChecks() في AndroidComposeTestRule، وشغِّل إجراءً أو tryPerformAccessibilityChecks:

@Rule
@JvmField
val composeTestRule = createAndroidComposeRule<ComponentActivity>()

@Test
fun noAccessibilityLabel() {
    composeTestRule.setContent {
        Box(
            modifier = Modifier
                .size(50.dp, 50.dp)
                .background(color = Color.Gray)
                .clickable { }
                .semantics {
                    contentDescription = ""
                }
        )
    }

    composeTestRule.enableAccessibilityChecks()

    // Any action (such as performClick) will perform accessibility checks too:
    composeTestRule.onRoot().tryPerformAccessibilityChecks()
}
AccessibilitySnippets.kt

يتعذّر إكمال هذا الاختبار المحدّد مع ظهور استثناء ورسالة تفيد بأنّه قد لا يحتوي العنصر على تصنيف يمكن لخدمات تسهيل الاستخدام قراءته.

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

إذا كنت تستخدم ميزتَي "العروض" و"الإنشاء" معًا وكنت تستخدم AccessibilityValidator، أو كنت بحاجة إلى ضبط أحدها، يمكنك ضبطه في القاعدة:

@Test
fun lowContrastScreen() {
    composeTestRule.setContent {
        Box(
            modifier = Modifier
                .fillMaxSize()
                .background(color = Color(0xFFFAFBFC)),
            contentAlignment = Alignment.Center
        ) {
            Text(text = "Hello", color = Color(0xFFB0B1B2))
        }
    }

    // Optionally, set AccessibilityValidator manually
    val accessibilityValidator = AccessibilityValidator()
        .setThrowExceptionFor(
            AccessibilityCheckResult.AccessibilityCheckResultType.WARNING
        )

    composeTestRule.enableAccessibilityChecks(accessibilityValidator)

    composeTestRule.onRoot().tryPerformAccessibilityChecks()
}
AccessibilitySnippets.kt

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