React Native への移行

概要

@callstack/react-native-brownfield を使用して、既存のネイティブアプリに React Native を段階的に導入するための規範的なワークフロー。初期セットアップからホストアプリの段階的統合まで対応しています。

• Expo トラック
• Bare React Native トラック

ユーザーが明示的に移行またはで比較を要求しない限り、1 つのタスクにつき 1 つのトラックを使用してください。

移行戦略

Brownfield 移行の計画と実行にはこの戦略を使用してください:

1. アプリの状態を評価し、Expo または Bare パスを選択する。
2. @callstack/react-native-brownfield で初期セットアップを実行する。
3. React Native ソースアプリから RN アーティファクト (XCFramework/AAR) をパッケージ化する。
4. 1 つの RN サーフェスをホストアプリに統合し、スタートアップ/ランタイムを検証する。
5. 機能/画面ごとに統合を繰り返し、段階的なロールアウトを実現する。

Agent ガードレール (グローバル)

すべてのリファレンスファイルに対して、これらのルールを適用してください:

1. 最初に 1 つのパス (Expo または Bare) を選択し、ステップを混在させない。
2. ドキュメントのプレースホルダー (<framework_target_name>、<android_module_name>、<registered_module_name>) を使用し、プロジェクトファイルから解決する。
3. ホスト統合に進む前に、各パッケージ化コマンドを検証する。
4. 長いプラットフォーム固有のスニペットと CLI オプションの詳細については、公式ドキュメントを優先する。
5. 可能な限り、ホストアプリを React Native API から直接隔離する (ファサードアプローチ)。

正規ドキュメント

• Quick Start
• Expo Integration
• iOS Integration
• Android Integration
• Brownfield CLI
• Guidelines
• Troubleshooting

パス選択ゲート (最初に実行する必須項目)

リファレンスファイルを選択する前に、プロジェクトを分類してください:

1. React Native アプリがまだ存在しない場合は、Expo 作成パスを使用:
   • expo-create-app.md -> expo-quick-start.md
2. React Native アプリが存在する場合は、package.json と app.json を検査:
   • expo が存在する場合、または Expo プラグインワークフローが要求される場合は Expo。
   • Expo パスの要件なしにネイティブフォルダと直接 RN CLI ワークフローが使用されている場合は Bare RN。
3. まだ不明な場合は、1 つの曖昧性排除質問をする。
4. 正確に 1 つのパスで続行する。

適用時期

以下の場合にこのパッケージを参照してください:

• ネイティブのみのアプリから React Native または Expo への段階的な移行を計画している
• Expo または Bare React Native プロジェクト用の Brownfield 統合フローを作成している
• @callstack/react-native-brownfield での初期セットアップを実行している
• React Native アプリから iOS XCFramework アーティファクトを生成している
• React Native アプリから Android AAR アーティファクトを生成して公開している
• 生成されたアーティファクトをホスト iOS/Android アプリに統合している

クイックリファレンス

ファイル	説明
quick-start.md	共有プリフライトと必須のパス選択ゲート
expo-create-app.md	Expo brownfield セットアップ前に新しい Expo アプリをスキャフォルド
expo-quick-start.md	Expo プラグインセットアップとパッケージ化準備
expo-ios-integration.md	Expo iOS パッケージ化とホストスタートアップ統合
expo-android-integration.md	Expo Android パッケージ化、公開、およびホスト統合
bare-quick-start.md	Bare React Native ベースラインセットアップ
bare-ios-xcframework-generation.md	Bare iOS XCFramework 生成
bare-android-aar-generation.md	Bare Android AAR 生成と公開
bare-ios-native-integration.md	Bare iOS ホスト統合
bare-android-native-integration.md	Bare Android ホスト統合

問題 -> スキルマッピング

問題	開始位置
パス決定が最初に必要	quick-start.md
Brownfield 用の新しい Expo アプリを作成する必要がある	expo-create-app.md
Expo brownfield セットアップとプラグイン配線が必要	expo-quick-start.md
Expo iOS brownfield 統合が必要	expo-ios-integration.md
Expo Android brownfield 統合が必要	expo-android-integration.md
Bare RN ベースラインセットアップが必要	bare-quick-start.md
Bare RN iOS XCFramework 生成が必要	bare-ios-xcframework-generation.md
Bare RN Android AAR 生成/公開が必要	bare-android-aar-generation.md
Bare RN iOS ホスト統合が必要	bare-ios-native-integration.md
Bare RN Android ホスト統合が必要	bare-android-native-integration.md