Mobile Offline Support

目次

• 概要
• 使用場面
• クイックスタート
• リファレンスガイド
• ベストプラクティス

概要

接続状態に関係なくシームレスなユーザー体験を提供するオフラインファースト モバイルアプリケーションを設計します。

使用場面

• インターネット接続なしで動作するアプリを構築する場合
• 接続が戻ったときのシームレスな同期を実装する場合
• デバイスとサーバー間のデータ競合を処理する場合
• インテリジェントなキャッシングでサーバー負荷を軽減する場合
• ローカルストレージでアプリの応答性を改善する場合

クイックスタート

最小限の動作例：

import AsyncStorage from '@react-native-async-storage/async-storage';
import NetInfo from '@react-native-community/netinfo';

class StorageManager {
  static async saveItems(items) {
    try {
      await AsyncStorage.setItem(
        'items_cache',
        JSON.stringify({ data: items, timestamp: Date.now() })
      );
    } catch (error) {
      console.error('Failed to save items:', error);
    }
  }

  static async getItems() {
    try {
      const data = await AsyncStorage.getItem('items_cache');
      return data ? JSON.parse(data) : null;
    } catch (error) {
      console.error('Failed to retrieve items:', error);
      return null;
    }
  }

// ... (詳細な実装についてはリファレンスガイドを参照)

リファレンスガイド

references/ ディレクトリの詳細な実装：

ガイド	内容
React Native Offline Storage	React Native Offline Storage
iOS Core Data Implementation	iOS Core Data Implementation
Android Room Database	Android Room Database

ベストプラクティス

✅ すべきこと

• 堅牢なローカルストレージを実装する
• オンライン時に自動同期を使用する
• オフラインステータスに対して視覚的フィードバックを提供する
• アクションをキューに入れて後で同期する
• 競合を優雅に処理する
• 頻繁にアクセスされるデータをキャッシュする
• 適切なエラー回復を実装する
• オフラインシナリオを十分にテストする
• 大きなデータに圧縮を使用する
• ストレージ使用量を監視する

❌ してはいけないこと

• 常に接続されていることを想定する
• 大きなファイルを頻繁に同期する
• ストレージの制限を無視する
• 不要な同期を強制する
• オフラインモードでデータを失う
• 機密データを暗号化されていない状態で保存する
• キューアイテムを無限に蓄積する
• 同期の失敗を黙って無視する
• タイトループで同期する
• オフラインテストなしでデプロイする