offline_web_proxy

Flutter WebView内で動作するオフライン対応ローカルプロキシサーバ。 既存のWebシステムをモバイルアプリでシームレスに動作させ、 オンライン/オフライン状態を意識する必要をなくします。

主な機能

• インテリジェントキャッシング: RFC準拠のキャッシュ制御とオフライン戦略
• リクエストキューイング: オフライン時のPOST/PUT/DELETEリクエストの自動キュー。 キュー・隔離・ドロップ履歴は AES-256 で暗号化して保存し、隔離と履歴には保持上限を設ける
• Cookie管理: AES-256暗号化による安全なCookie永続化
• 静的リソース配信: assets/static/ 配下を起動時に走査し、同梱アセットとして配信
• シームレスなオフライン対応: 透過的なオンライン/オフライン切り替え

クイックスタート

import 'package:offline_web_proxy/offline_web_proxy.dart';

final proxy = OfflineWebProxy();
final config = ProxyConfig(
  origin: 'https://your-api-server.com',
  port: 0, // ポート自動割り当て
  preferredPort: 8787, // 利用可能なら固定ポートを優先する
);

// プロキシサーバを起動
final port = await proxy.start(config: config);
print('Proxy running on http://127.0.0.1:$port');

// WebViewで使用
webViewController.loadUrl('http://127.0.0.1:$port/your-app-path');

アーキテクチャ

プロキシはWebViewからのHTTPリクエストを横取りして:

1. オンライン時: リクエストを上流サーバに転送し、レスポンスをキャッシュ
2. オフライン時: キャッシュから配信、または更新リクエストをキューに保存
3. 復旧時: オンライン復帰時にキューされたリクエストを自動的に消化

キャッシュ戦略

• Fresh: TTL内、即座に配信
• Stale: TTL切れだがStale期間内、オンラインなら検証
• Expired: Stale期間外、クリーンアップ時に削除

設定オプションは ProxyConfig を、詳細な技術仕様は specs.md を参照してください。