android-local-persistence-datastore

Android ローカル永続化 DataStore

使用するタイミング

• 次のようなリクエストの場合にこのスキルを使用します：Android の DataStore のセットアップ、Android の SharedPreferences の置き換え、Android の型付きローカル設定。
• 主な成果：DataStore、スキーマセーフなモデル、移行を考慮したデフォルト値を使用して、軽量なユーザー設定とアプリ設定を永続化します。
• 対象範囲が広がる場合の引き継ぎ先スキル：
• android-room-database
• android-modernization-upgrade

ワークフロー

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

ガードレール

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

アンチパターン

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

例

基本的なケース

• シナリオ：OrbitTasks のリマインダー設定とフィルター設定を安全に保存します。
• コマンド：cd examples/orbittasks-compose && ./gradlew :app:testDebugUnitTest

エッジケース

• シナリオ：XML フィクスチャを壊さずに古い設定キーを移行します。
• コマンド：cd examples/orbittasks-xml && ./gradlew :app:testDebugUnitTest

障害復旧

• シナリオ：軽量な設定ストレージのリクエストと Room の永続化作業が混在するのを防ぎます。
• コマンド：python3 scripts/eval_triggers.py --skill android-local-persistence-datastore

完了チェックリスト

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

公式リファレンス

• https://developer.android.com/topic/libraries/architecture/datastore
• https://developer.android.com/codelabs/android-preferences-datastore
• https://developer.android.com/training/data-storage/shared-preferences
• https://developer.android.com/topic/libraries/architecture/datastore#proto-datastore