android-testing-unit

Android 単体テスト

使用する場面

• リクエストが次の内容に関する場合に、このスキルを使用します：Android の単体テスト戦略、Android のテスト用 ViewModel リデューサー、Android のリポジトリ単体テスト。
• 主な成果：リデューサー、ユースケース、リポジトリ、ライフサイクルに安全な状態ホルダーを対象に、高速で焦点を絞った Android 単体テストを作成します。
• 対象範囲が広がる場合の引き継ぎ先スキル：
• android-testing-ui
• android-ui-states-validation

ワークフロー

1. リスクの対象範囲を定めます：正確性、セキュリティ、パフォーマンス、テストの深度、リリース自動化。
2. 起こりそうなリグレッションを検出できる範囲で、最も対象を絞った検証戦略を選びます。
3. 失敗時に単に赤く表示するだけでなく、対処につながるようにワークフローを計測します。
4. ショーケースアプリとパッケージ出力に対して、関連するチェックを実行します。
5. 残存するリスクを、明示的なフォローアップ作業と担当スキルとともに記録します。

ガードレール

• 一度限りのローカルでの無理な対応より、CI で再現可能なチェックを優先します。
• 曖昧な品質ゲートではなく、明確な修正手順を示して失敗させます。
• シークレット、署名情報、本番環境の認証情報を、サンプルやフィクスチャに含めないでください。
• パフォーマンスとセキュリティの作業は、根拠に基づくエンジニアリング作業として扱い、俗説に頼らないでください。

アンチパターン

• テストのシグナルを高めずにテストを増やすこと。
• 誰も再現できないベンチマークやセキュリティスキャンをリリースすること。
• ビルドロジックにリリース認証情報をハードコードすること。
• ユーザーへの影響が解釈されていない合成メトリクスを使用すること。

例

順調なケース

• シナリオ：両方のフィクスチャアプリで、リデューサーとフォーマッターのロジックを対象に絞ったローカルテストでカバーします。
• コマンド：cd examples/orbittasks-compose && ./gradlew :app:testDebugUnitTest && cd ../orbittasks-xml && ./gradlew :app:testDebugUnitTest

エッジケース

• シナリオ：インストルメンテーションを使わずに、同期の失敗と権限拒否の分岐をモックします。
• コマンド：cd examples/orbittasks-compose && ./gradlew :app:testDebugUnitTest

失敗からの復旧

• シナリオ：単体テストのリクエストを UI テストや一般的なアーキテクチャの整理から切り分けます。
• コマンド：python3 scripts/eval_triggers.py --skill android-testing-unit

完了チェックリスト

• 実装方針が明確かつ最小限で、適切な Android の対象領域に結び付いています。
• 関連するサンプルコマンドとベンチマーク用プロンプトを実行するか、更新しています。
• リクエストが境界をまたぐ場合は、関連スキルへの引き継ぎを文書化しています。
• 選択したパターンと、主な移行またはトラブルシューティングの手順を公式リファレンスで確認できます。

公式リファレンス

• https://developer.android.com/training/testing/local-tests
• https://developer.android.com/training/testing/fundamentals
• https://developer.android.com/topic/libraries/architecture/viewmodel
• https://kotlinlang.org/docs/jvm-test-using-junit.html