android-networking-retrofit-okhttp

Android Networking Retrofit OkHttp

使用する場面

• リクエストが次の内容に関する場合に、このスキルを使用します：Android の Retrofit セットアップ、Android の OkHttp インターセプター、Android の API エラーマッピング。
• 主な成果：Retrofit、OkHttp、インターセプター、API コントラクト、堅牢なエラー処理を使用して、Android のネットワークスタックを構築します。
• 対象範囲が広がる場合の引き継ぎ先スキル：
• android-serialization-offline-sync
• android-security-best-practices

ワークフロー

1. 対象となるデータソース、永続化の境界、同期モデル、デバイス機能を確認します。
2. ネットワーク、ストレージ、メディア、バックグラウンド API を接続する前に、コントラクトを明確にモデル化します。
3. 移行時にも安全なデフォルト設定を用いて、推奨される AndroidX またはプラットフォームのパターンを適用します。
4. サンプルアプリとシナリオを使って、オフライン動作、再試行、プロセス終了時の動作を検証します。
5. 必要に応じて、セキュリティ、パフォーマンス、リリースのリスクについて、関連するサポートスキルに引き継ぎます。

ガードレール

• 場当たり的なマップやバンドルよりも、型付きモデルと明示的なシリアライザーを優先します。
• バックグラウンド処理は、冪等性を保ち、キャンセルに対応できるようにします。
• ストレージ、メディア、ネットワークの詳細をプレゼンテーションコードに漏らさないようにします。
• ユーザーデータの永続性、プライバシー、移行経路を実装の一部として扱います。

アンチパターン

• ディスクやネットワークの呼び出しでメインスレッドをブロックする。
• 再試行可能な同期エラーを、回復不能なユーザー向けエラーとして扱う。
• マッピング層を設けずに、キャッシュモデルと通信モデルを混在させる。
• より限定的な API があるにもかかわらず、広範なストレージ権限や通知機能を要求する。

例

通常のケース

• シナリオ：タスクの更新における同期リクエストとネットワーク障害をモデル化します。
• コマンド：cd examples/orbittasks-compose && ./gradlew :app:testDebugUnitTest

エッジケース

• シナリオ：XML フィクスチャで古いキャッシュと再試行の動作を処理します。
• コマンド：cd examples/orbittasks-xml && ./gradlew :app:testDebugUnitTest

障害からの復旧

• シナリオ：ネットワークに関するプロンプトを、シリアル化、セキュリティ、オフライン同期に関するリクエストと区別します。
• コマンド：python3 scripts/eval_triggers.py --skill android-networking-retrofit-okhttp

完了チェックリスト

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

公式リファレンス

• https://developer.android.com/develop/connectivity/network-ops/connecting
• https://developer.android.com/topic/architecture/data-layer/offline-first
• https://developer.android.com/training/volley
• https://developer.android.com/training/articles/perf-anr