بررسی دسترس‌پذیری

آزمایش دسترس‌پذیری به شما امکان می‌دهد برنامه‌تان را از دیدگاه کل پایگاه کاربرانتان، ازجمله کاربران دارای نیازهای دسترس‌پذیری، تجربه کنید. این نوع آزمایش می‌تواند فرصت‌هایی را برای قدرتمندتر و همه‌کاره‌تر کردن برنامه‌تان آشکار کند.

این صفحه نحوه افزودن بررسی‌های دسترس‌پذیری به آزمایش‌های 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 به‌دلیل این نتایج، می‌توانید آن‌ها را موقتاً نادیده بگیرید. «چارچوب آزمایش دسترس‌پذیری» (ATF) این عملکرد را بااستفاده از روش setSuppressingResultMatcher() ارائه می‌دهد که به Espresso دستور می‌دهد همه نتایجی را که با عبارت تطبیق‌دهنده داده‌شده مطابقت دارند سرکوب کند.

وقتی تغییراتی در برنامه‌تان ایجاد می‌کنید که به یک جنبه از دسترس‌پذیری می‌پردازد، مفید است که Espresso نتایج را برای هر تعداد جنبه دیگر از دسترس‌پذیری که ممکن است نشان دهد. به همین دلیل، بهتر است فقط فرصت‌های شناخته‌شده خاصی را برای بهبود متوقف کنید.

وقتی یافته‌های آزمایش دسترس‌پذیری را که قصد دارید بعداً به آن‌ها رسیدگی کنید موقتاً پنهان می‌کنید، مهم است که یافته‌های مشابه را به‌طور تصادفی پنهان نکنید. به همین دلیل، از تطبیق‌دهنده‌هایی استفاده کنید که دامنه محدودی دارند. برای انجام این کار، مطابقت‌دهنده‌ای انتخاب کنید تا Espresso نتیجه‌ای را فقط درصورتی سرکوب کند که هرکدام از بررسی‌های دسترس‌پذیری زیر را برآورده کند:

  1. بررسی‌های دسترس‌پذیری از نوع خاص، مثل بررسی‌هایی که اندازه هدف لمس را بررسی می‌کنند.
  2. بررسی‌های دسترس‌پذیری که عنصر واسط کاربر خاصی (مثل دکمه) را ارزیابی می‌کند.

ATF چندین تطبیق‌دهنده را تعریف می‌کند تا به شما کمک کند مشخص کنید کدام نتایج در آزمایش‌های Espresso نشان داده شود. مثال زیر نتایج بررسی‌های مربوط به کنتراست رنگ یک عنصر TextView را سرکوب می‌کند. شناسه عنصر countTV است.

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