בדיקת הנגישות מאפשרת לכם לחוות את האפליקציה מנקודת המבט של כל בסיס המשתמשים, כולל משתמשים עם צורכי נגישות. סוג הבדיקה הזה יכול לחשוף הזדמנויות להפוך את האפליקציה ליעילה ורב-תכליתית יותר.
בדף הזה מוסבר איך להוסיף בדיקות נגישות לבדיקות Espresso הקיימות. מידע נוסף על נגישות זמין במדריכי הנגישות.
הפעלת הבדיקות
כדי להפעיל ולהגדיר בדיקות נגישות, משתמשים בכיתה AccessibilityChecks:
// import androidx.test.espresso.accessibility.AccessibilityChecks @RunWith(AndroidJUnit4::class) @LargeTest class MyWelcomeWorkflowIntegrationTest { init { AccessibilityChecks.enable() } }
כברירת מחדל, הבדיקות פועלות כשמבצעים פעולת צפייה שמוגדרת ב-androidx.test.espresso.action.ViewActions, כמו click() או scrollTo().
כל בדיקה כוללת את התצוגה שבה הפעולה מתבצעת, וגם את כל התצוגות הצאצאיות. כדי להעריך את כל היררכיית התצוגות של המסך בכל בדיקה, מעבירים את true אל setRunChecksFromRootView(), כמו בקטע הקוד הבא:
AccessibilityChecks.enable().setRunChecksFromRootView(true)
הסתרת קבוצות משנה של תוצאות
אחרי ש-Espresso מריץ בדיקות נגישות באפליקציה, יכול להיות שתמצאו כמה הזדמנויות לשפר את הנגישות של האפליקציה, אבל לא תוכלו לטפל בהן מיד. כדי למנוע מצב שבו בדיקות Espresso נכשלות שוב ושוב בגלל התוצאות האלה, אתם יכולים להתעלם מהן באופן זמני. Accessibility Test Framework (ATF) מספק את הפונקציונליות הזו באמצעות השיטה setSuppressingResultMatcher(), שמורה ל-Espresso להסתיר את כל התוצאות שתואמות לביטוי ההתאמה שצוין.
כשאתם מבצעים שינויים באפליקציה שמתייחסים להיבט אחד של נגישות, כדאי ש-Espresso יציג תוצאות לכמה שיותר היבטים אחרים של נגישות. לכן, מומלץ להסתיר רק הזדמנויות ספציפיות ומוכרות לשיפור.
כשאתם משתיקים באופן זמני ממצאים של בדיקות נגישות שאתם מתכננים לטפל בהם בהמשך, חשוב לא להשתיק בטעות ממצאים דומים. לכן, כדאי להשתמש בהתאמות עם היקף מצומצם. כדי לעשות זאת, בוחרים matcher כך ש-Espresso ידכא תוצאה נתונה רק אם היא עומדת בכל בדיקות הנגישות הבאות:
- בדיקות נגישות מסוג מסוים, כמו בדיקות של גודל יעד המגע.
- בדיקות נגישות שמעריכות רכיב בממשק המשתמש מסוים, כמו כפתור.
ב-ATF מוגדרים כמה מתאמים
שעוזרים לכם להגדיר אילו תוצאות יוצגו בבדיקות Espresso. בדוגמה הבאה, המערכת מסתירה את תוצאות הבדיקות שקשורות לניגודיות הצבעים של רכיב TextView יחיד. מזהה הרכיב הוא countTV.
AccessibilityChecks.enable().apply { setSuppressingResultMatcher( allOf( matchesCheck(TextContrastCheck::class.java), matchesViews(withId(R.id.countTV)) ) ) }