جارٍ التحقق من إمكانية الوصول

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

توضح هذه الصفحة كيفية إضافة عمليات فحص إمكانية الوصول إلى اختبارات الإسبريسو الحالية. لمزيد من المعلومات حول إمكانية الوصول، راجع أدلة إمكانية الوصول.

تفعيل عمليات التحقّق

يمكنك تفعيل اختبار تسهيل الاستخدام وضبطه باستخدام الفئة AccessibilityChecks:

Kotlin

import androidx.test.espresso.accessibility.AccessibilityChecks

@RunWith(AndroidJUnit4::class)
@LargeTest
class MyWelcomeWorkflowIntegrationTest {
    init {
        AccessibilityChecks.enable()
    }
}

Java

import androidx.test.espresso.accessibility.AccessibilityChecks;

@RunWith(AndroidJUnit4.class)
@LargeTest
public class MyWelcomeWorkflowIntegrationTest {
    @BeforeClass
    public void enableAccessibilityChecks() {
        AccessibilityChecks.enable();
    }
}

يتم تلقائيًا تنفيذ عمليات التحقّق عند تنفيذ أي إجراء عرض محدّد في ViewActions. وتشمل كل عملية تحقق طريقة عرض يتم تنفيذ الإجراء عليها بالإضافة إلى جميع طرق العرض اللاحقة. يمكنك تقييم التدرّج الهرمي الكامل لطريقة العرض على أي شاشة خلال كل عملية تحقق من خلال تمرير true إلى setRunChecksFromRootView()، كما هو موضّح في مقتطف الرمز التالي:

Kotlin

AccessibilityChecks.enable().setRunChecksFromRootView(true)

Java

AccessibilityChecks.enable().setRunChecksFromRootView(true);

منع مجموعات فرعية من النتائج

بعد إجراء Espresso لعمليات فحص إمكانية الوصول في تطبيقك، قد تجد عدة فرص لتحسين إمكانية الوصول إلى تطبيقك والتي لا يمكنك معالجتها فورًا. لإيقاف اختبارات الإسبريسو باستمرار بسبب هذه النتائج، يمكنك تجاهلها مؤقتًا. يوفّر إطار عمل اختبار تسهيل الاستخدام (ATF) هذه الوظيفة باستخدام طريقة setSuppressingResultMatcher() التي تطلب من Espresso إيقاف جميع النتائج التي تستوفي تعبير المطابِق المحدّد.

عندما تُجري تغييرات على تطبيقك تتناول جانبًا واحدًا من ميزات تسهيل الاستخدام، من المفيد لإسبريسو عرض نتائج لأكبر عدد ممكن من الجوانب الأخرى لإمكانية الوصول. لهذا السبب، من الأفضل قمع فقط فرص محددة معروفة للتحسين.

عند إيقاف نتائج اختبار إمكانية الوصول مؤقتًا التي تخطط لمعالجتها لاحقًا، من المهم عدم حجب النتائج المماثلة عن طريق الخطأ. لهذا السبب، استخدِم أدوات المطابقة ذات النطاق الضيق. لإجراء ذلك، اختَر مُطابقًا بحيث لا تمنع Espresso نتيجة معيّنة إلا إذا كانت تستوفي كلّ من عمليات التحقق التالية المتعلّقة بتسهيل الاستخدام:

1. عمليات التحقّق من إمكانية الوصول من نوع معيّن، مثل تلك التي تتحقق من حجم ناحية اللمس المستهدفة
2. عمليات تحقّق من تسهيل الاستخدام تقيّم عنصرًا معيّنًا في واجهة المستخدم، مثل الزر.

تحدّد AATF العديد من أدوات المطابقة لمساعدتك في تحديد النتائج التي يتم عرضها في اختبارات Espresso. يمنع المثال التالي نتائج عمليات التحقّق المرتبطة بتباين ألوان عنصر TextView واحد. معرّف العنصر هو countTV.

Kotlin

AccessibilityChecks.enable().apply {
        setSuppressingResultMatcher(
                allOf(
                    matchesCheck(TextContrastCheck::class.java),
                    matchesViews(withId(R.id.countTV))
                )
        )
}

Java

AccessibilityValidator myChecksValidator =
    AccessibilityChecks.enable()
        .setSuppressingResultMatcher(
            allOf(
                matchesCheck(TextContrastCheck.class),
                matchesViews(withId(R.id.countTV))));