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

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

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

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

يمكنك تفعيل اختبار تسهيل الاستخدام وضبطه باستخدام 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 نتيجة معينة فقط إذا كانت تتوافق مع كل عمليات التحقّق التالية من تسهيل الاستخدام:

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

يحدد ATF العديد من المطابقات لمساعدتك في تحديد النتائج التي ستظهر في اختبارات الإسبريسو. ما يلي: المثال يؤدي إلى منع نتائج عمليات التحقق المرتبطة بوحدة 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))));