การตรวจสอบการช่วยเหลือพิเศษ

การทดสอบการช่วยเหลือพิเศษช่วยให้คุณได้สัมผัสประสบการณ์การใช้งานแอปจากมุมมองของ ฐานผู้ใช้ทั้งหมด ซึ่งรวมถึงผู้ใช้ที่มีความต้องการด้านการช่วยเหลือพิเศษ การทดสอบรูปแบบนี้ จะช่วยให้คุณเห็นโอกาสในการเพิ่มประสิทธิภาพและความสามารถรอบด้านให้กับแอป

หน้านี้จะอธิบายวิธีเพิ่มการตรวจสอบการช่วยเหลือพิเศษลงใน Espresso test ที่มีอยู่ ดูข้อมูลเพิ่มเติมเกี่ยวกับการช่วยเหลือพิเศษได้ที่คำแนะนำ เกี่ยวกับการช่วยเหลือพิเศษ

เปิดใช้การตรวจสอบ

คุณเปิดใช้และกำหนดค่าการทดสอบการช่วยเหลือพิเศษได้โดยใช้คลาส 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 ล้มเหลวอย่างต่อเนื่องเนื่องจากผลลัพธ์เหล่านี้ คุณสามารถละเว้นผลลัพธ์ชั่วคราวได้ Accessibility Test Framework (ATF) มีฟังก์ชันนี้โดยใช้เมธอด setSuppressingResultMatcher() ซึ่งจะสั่งให้ Espresso ระงับผลลัพธ์ทั้งหมดที่ตรงกับนิพจน์ Matcher ที่ระบุ

เมื่อคุณทำการเปลี่ยนแปลงในแอปเพื่อแก้ไขปัญหาด้านการช่วยเหลือพิเศษด้านใดด้านหนึ่ง Espresso จะแสดงผลลัพธ์สำหรับด้านอื่นๆ ของการช่วยเหลือพิเศษให้ได้มากที่สุด ด้วยเหตุนี้ คุณจึงควรระงับเฉพาะโอกาสที่ทราบ ในการปรับปรุง

เมื่อระงับผลการทดสอบการช่วยเหลือพิเศษชั่วคราวซึ่งคุณวางแผนที่จะแก้ไขในภายหลัง คุณต้องระมัดระวังไม่ให้ระงับผลการทดสอบที่คล้ายกันโดยไม่ตั้งใจ ด้วยเหตุนี้ ให้ใช้ตัวเทียบที่กำหนดขอบเขตแคบๆ โดยเลือกMatcher เพื่อให้ Espresso ระงับผลลัพธ์ที่กำหนดก็ต่อเมื่อเป็นไปตามการตรวจสอบการช่วยเหลือพิเศษแต่ละรายการ ต่อไปนี้

1. การตรวจสอบการช่วยเหลือพิเศษบางประเภท เช่น การตรวจสอบขนาดเป้าหมายการสัมผัส
2. การตรวจสอบการช่วยเหลือพิเศษที่ประเมินองค์ประกอบ UI ที่เฉพาะเจาะจง เช่น ปุ่ม

ATF กำหนด Matcher หลายรายการ เพื่อช่วยคุณกำหนดผลลัพธ์ที่จะแสดงในการทดสอบ 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))));