android-compose-accessibility

Android Compose のアクセシビリティ

使用する場面

• 次のような依頼でこのスキルを使用します：Compose のアクセシビリティレビュー、Android の Compose におけるセマンティクスの問題、Compose のフォーカス順序。
• 主な成果：セマンティクス、アナウンス、コントラスト、フォーカス順序、柔軟なタッチターゲットにより、Compose インターフェースをアクセシブルにします。
• 対象範囲が広がる場合に引き継ぐスキル：
• android-ui-states-validation
• android-testing-ui

ワークフロー

1. 対象の画面が Compose、View システム、または相互運用を含む混在画面のいずれかを特定します。
2. 応答性、アクセシビリティ、パフォーマンスの要件を満たす、最も手間の少ない UI パターンを選択します。
3. 安定した状態、明示的な副作用、再利用可能なデザイントークンを中心に UI を構築します。
4. フィクスチャアプリで、長いテキスト、フォントの拡大、RTL、画面幅の狭いデバイスなどのエッジケースを試します。
5. 引き継ぐ前に、ユニットテスト、UI テスト、スクリーンショットで確認しやすいチェックで検証します。

ガードレール

• アニメーションや抽象化を追加する前に、安定した状態と予測可能なレンダリングを優先します。
• アクセシビリティのセマンティクス、コントラスト、フォーカス順序、タッチターゲットに関する指針を常に尊重します。
• 明示的な相互運用の境界を設けずに、Compose と View システムの管理を混在させないでください。
• 早すぎるマイクロ最適化ではなく、測定に基づくパフォーマンス改善を優先します。

アンチパターン

• ナビゲーションやビジネスロジックを末端の UI コンポーネントに直接埋め込む。
• ローカライズや動的テキストで崩れる固定サイズを使用する。
• セマンティクスを無視し、視覚的な変化だけをアナウンスする。
• XML のパターンを考え方に合わせて調整せず、そのまま Compose に移植する。

例

想定どおりの流れ

• シナリオ：Compose の OrbitTasks カードにセマンティクスと読み上げ可能なラベルを追加します。
• コマンド：cd examples/orbittasks-compose && ./gradlew :app:connectedDebugAndroidTest

エッジケース

• シナリオ：画面幅の狭いレイアウトで、フォントの拡大、コントラスト、タッチターゲットを検証します。
• コマンド：cd examples/orbittasks-compose && ./gradlew :app:assembleDebug

失敗からの復旧

• シナリオ：アクセシビリティに関する依頼と、一般的な UI 検証やテーマに関する作業を区別します。
• コマンド：python3 scripts/eval_triggers.py --skill android-compose-accessibility

完了チェックリスト

• 実装方針が明確かつ最小限で、適切な Android の画面に対応しています。
• 関連するサンプルコマンドとベンチマーク用プロンプトを実行するか、更新しています。
• 依頼が隣接するスキルの範囲にまたがる場合、その引き継ぎを記録しています。
• 選択したパターンと、主な移行方法またはトラブルシューティング手順を公式リファレンスで確認できます。

公式リファレンス

• https://developer.android.com/develop/ui/compose/accessibility
• https://developer.android.com/guide/topics/ui/accessibility/apps
• https://developer.android.com/guide/topics/ui/accessibility/testing
• https://developer.android.com/develop/ui/compose/layouts/adaptive