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

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

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

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

يمكنك تفعيل اختبار إمكانية الوصول إلى التطبيق وضبط إعداداته باستخدام فئة 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 عمليات التحقّق من تسهيل الاستخدام لتطبيقك، قد تجد العديد من الفرص لتحسين تسهيل الاستخدام لتطبيقك، ولكن قد لا تتمكّن من معالجة هذه الفرص على الفور. ولإيقاف تعذُّر اختبارات Espresso باستمرار بسبب هذه النتائج، يمكنك تجاهلها مؤقتًا. يوفّر إطار عمل اختبار إمكانية الوصول (ATF) هذه الوظيفة باستخدام الطريقة setSuppressingResultMatcher()، التي توجّه Espresso إلى إخفاء جميع النتائج التي تستوفي تعبير المطابقة المحدّد.

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

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

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

تحدّد أداة ATF العديد من أدوات المطابقة لمساعدتك في تحديد النتائج التي تريد عرضها في اختبارات 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))));