بازرسی و اشکال‌زدایی

بازرسی

چندین ابزار می‌تواند به شما کمک کند تا محتوایتان را از دیدگاه دسترس‌پذیری به‌سرعت بازرسی کنید:

• مجموعه دسترس‌پذیری Android: شامل «منوِ دسترس‌پذیری»، «انتخاب برای شنیدن»، «دسترسی با کلید»، و TalkBack است که اطلاعاتی درباره نحوه عملکرد معناشناسی برنامه‌تان برای کاربران این فناوری‌ها ارائه می‌دهد. آزمایش با فناوری‌های کمکی Android به‌عنوان بهترین روش برای درک آنچه کاربران دارای نیازهای دسترس‌پذیری تجربه خواهند کرد، به‌شدت توصیه می‌شود.
• بازرس چیدمان: به شما امکان می‌دهد معناشناسی هر ترکیب‌پذیر را بازرسی و اشکال‌زدایی کنید و به شناسایی اطلاعات مفقود یا نادرست کمک می‌کند.
• برنامه اسکنر دسترس‌پذیری: صفحه‌نمایش را اسکن می‌کند و با شناسایی برخی‌از مشکلات رایج، پیشنهادهایی برای بهبود دسترس‌پذیری آن ارائه می‌دهد.

اشکال‌زدایی کردن

ممکن است بین Compose، سیستم معنایی، و سرویس‌های دسترس‌پذیری Android با رفتارهای دسترس‌پذیری غیرمنتظره‌ای مواجه شوید که ردیابی آن‌ها دشوار است. ویژگی‌های معنایی می‌توانند به شما کمک کنند تا بفهمید چرا مؤلفه‌هایتان به این شکل رفتار می‌کنند.

می‌توانید مشکلات رفتار دسترس‌پذیری را با بازرس چیدمان در «استودیو Android»،‏ TreeDebug در تنظیمات توسعه‌دهنده TalkBack، یا printToLog ComposeTestRule اشکال‌زدایی کنید. همه این ابزارها می‌توانند اطلاعاتی درباره گره‌ها (و ویژگی‌های آن‌ها) ارائه دهند که توسط Compose درمعرض سرویس‌های دسترس‌پذیری قرار می‌گیرند.

مثال زیر از «بازرس چیدمان» برای اشکال‌زدایی صفحه‌ای با سه عنصر استفاده می‌کند که در آن، با روشن بودن سرویس‌های دسترس‌پذیری، عنصر اول انتخاب نمی‌شود و عنصر دوم هیچ بازخورد کنشی مرتبط با خود ندارد. می‌توانید ویژگی‌های معنایی را برای یافتن مشکلات احتمالی بررسی کنید.

درخت مؤلفه در «بازرس چیدمان» حاوی اطلاعاتی درباره حدود، پارامترها، و دیگر اطلاعات معنایی مرتبط با عنصر است. در درخت، هر سه عنصر تشخیص داده می‌شوند:

شکل ۲. بازرس چیدمان با هر سه عنصر..

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

شکل ۳.‏ بازرس چیدمان: اولین عنصر با hideFromAccessibility.

عنصر دوم دارای ویژگی تمرکز است، اما مانند عنصر قبلی، onClick ندارد. بنابراین، ممکن است در جایی فاقد اصلاح‌کننده clickable باشد، به همین دلیل است که سرویس دسترس‌پذیری مانند TalkBack ممکن است برخی از سیگنال‌های کنش را به کاربر اعلام نکند:

شکل ۴. بازرس چیدمان: عنصر دوم با focused.

عنصر نوشتاری سوم همه ویژگی‌های لازم را دارد—فوکوس‌پذیر است، onClick دارد، و معناشناسی‌های اضافی دیگری بر آن اعمال شده است—به همین دلیل است که همان‌طور که انتظار می‌رود تفسیر می‌شود.

شکل ۵. بازرس چیدمان: عنصر سوم با همه میاناهای برنامه‌سازی کاربردی.

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