Migration vers React Native

Vue d'ensemble

Workflow prescriptif pour l'adoption incrémentale de React Native dans les applications natives existantes utilisant @callstack/react-native-brownfield, de la configuration initiale à l'intégration progressive de l'hôte.

• Piste Expo
• Piste bare React Native

Utilisez une piste par tâche sauf si l'utilisateur demande explicitement une migration ou une comparaison.

Stratégie de migration

Utilisez cette stratégie pour la planification et l'exécution de la migration brownfield :

1. Évaluez l'état de l'application et sélectionnez la piste Expo ou bare.
2. Effectuez la configuration initiale avec @callstack/react-native-brownfield.
3. Packagez les artefacts RN (XCFramework/AAR) à partir de l'application source RN.
4. Intégrez une surface RN dans l'application hôte et validez le démarrage/exécution.
5. Répétez l'intégration par fonctionnalité/écran pour le déploiement incrémental.

Garde-fous de l'agent (Global)

Appliquez ces règles sur tous les fichiers de référence :

1. Sélectionnez d'abord un chemin (Expo ou bare) et ne mélangez pas les étapes.
2. Utilisez les espaces réservés de la documentation (<framework_target_name>, <android_module_name>, <registered_module_name>) et résolvez-les à partir des fichiers du projet.
3. Validez chaque commande de packaging avant de passer à l'intégration de l'hôte.
4. Préférez la documentation officielle pour les longs extraits de plate-forme et les détails des options CLI.
5. Isolez les applications hôtes des API React Native directes quand c'est possible (approche facade).

Docs canoniques

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

Portail de sélection du chemin (Doit s'exécuter en premier)

Avant de sélectionner un fichier de référence, classifiez le projet :

1. Si aucune application React Native n'existe encore, utilisez le chemin de création Expo :
   • expo-create-app.md -> expo-quick-start.md
2. Si l'application React Native existe, inspectez package.json et app.json :
   • Expo si expo est présent ou si le workflow du plugin Expo est demandé.
   • Bare RN si les dossiers natifs et le workflow direct RN CLI sont utilisés sans exigences de chemin Expo.
3. Si c'est encore flou, posez une question de désambiguïsation.
4. Continuez avec exactement un chemin.

Quand l'appliquer

Référencez ce package quand :

• Planifiez une migration incrémentale d'applications natives uniquement vers React Native ou Expo
• Créez des flux d'intégration brownfield pour les projets Expo ou bare React Native
• Effectuez la configuration initiale avec @callstack/react-native-brownfield
• Générez des artefacts iOS XCFramework à partir d'une application React Native
• Générez et publiez des artefacts Android AAR à partir d'une application React Native
• Intégrez les artefacts générés dans les applications hôtes iOS/Android

Référence rapide

Mappage Problème -> Compétence