flutter-platform-integration

Flutter プラットフォーム連携

要件を満たす既存の保守されているプラグインがある場合は、そちらを優先してください。その機能が利用できない場合、製品固有の場合、または制御可能なネイティブ契約が必要な場合は、プラットフォームコードを記述します。

プロジェクトですでに使用している適切なプラグインをカスタムネイティブコードに置き換えるよう求められた場合、まずネイティブコードを記述してはいけません。現在のプラグインが対応している内容を挙げ、どの具体的な要件を満たせないのか（API、プラットフォーム、動作、ライセンス、サイズの不足）を尋ね、その不足が明らかになるまではプラグインを維持するよう推奨してください。不足が実際にある場合は、Dart ラッパー、上流への修正、または不足部分だけを対象とした限定的なチャネルなど、最小限の変更で解消します。

境界を選ぶ

• 実績のあるクロスプラットフォーム機能には、パッケージ API を使用します。
• 複数メソッドのチャネルにコンパイル時の構造が役立つ場合は、Pigeon または別の型付きコード生成契約を使用します。
• 小規模で安定したリクエスト／レスポンスやイベントのインターフェースには、基本的なメソッドチャネル／イベントチャネルを使用します。
• 適切なネイティブの C 互換ライブラリや、パフォーマンスが重要な呼び出しには FFI を使用します。
• ネイティブビューの埋め込みが必要な場合にのみプラットフォームビューを使用し、コンポジション、ジェスチャー、アクセシビリティ、パフォーマンスを考慮します。

ドメインモデルはチャネル契約の外部に保ちます。メッセージには互換性を保ちながらバージョンを付与または更新し、境界ですべての値を検証して、プラットフォームの失敗を対処可能な Dart エラーに変換します。

参照資料を必要に応じて読む

• 既存パッケージ、チャネルまたは Pigeon、FFI、JS 相互運用、プラットフォームビューのいずれかを選ぶ際は、連携戦略を読みます。
• 再利用可能なプラグインパッケージ、連合型実装、プラットフォームインターフェース、またはマルチプラットフォームのネイティブ API を作成または進化させる際は、プラグイン開発を読みます。

flutter-package-development は、再利用可能な公開 API、パッケージ構成、互換性、連合に関する判断、利用者にとっての品質、公開準備を担当します。パッケージ設計とネイティブ実装の両方が重要な場合は、両方のスキルを使用します。

ライフサイクルとプラットフォーム

該当する場合は、エンジン／アクティビティ／ビューコントローラーへの接続、バックグラウンドとフォアグラウンドの切り替え、権限フロー、キャンセル、複数のエンジンインスタンスに対応します。プラグインが見つからない場合に遅れてクラッシュするのではなく、非対応プラットフォームでの動作を明示します。

検証

フェイクを使って Dart アダプターをテストし、サポート対象のすべてのターゲットでネイティブ実装をテストします。エラーのマッピング、ライフサイクル再接続、権限、バックグラウンド動作、埋め込みビューのアクセシビリティを検証します。

参考資料

• Flutter プラットフォーム連携
• プラットフォームチャネル
• FFI を使ったネイティブコードへのバインド
• パッケージとプラグインの開発