Configurer l’application mobile

Configuration et paramètres

Placez les valeurs destinées à l’appareil dans apps/mobile/.env.local ; Expo lit ce fichier, pas le .env à la racine du dépôt. EXPO_PUBLIC_API_URL est l’origine du backend web que le téléphone peut joindre — la même valeur que celle testée dans le navigateur du téléphone. EXPO_PUBLIC_APP_SCHEME est le schéma URI natif de l’application ; utilisez une valeur en DNS inversé comme com.example.app.

app.json gère le nom du produit, le slug, la version, l’identifiant de bundle et les plugins. app.config.ts dérive le schéma de lien profond et les origines de production de EXPO_PUBLIC_APP_SCHEME ; un changement de schéma exige donc une reconstruction native, pas seulement un redémarrage de Metro. Sur le serveur, ajoutez chaque origine utilisée par l’application à MOBILE_ALLOWED_ORIGINS ; le transfert échoue de manière sûre quand les deux côtés ne concordent pas.

Chaque valeur EXPO_PUBLIC_* est intégrée au bundle de l’application. Gardez les clés des fournisseurs sur le serveur et n’utilisez les valeurs publiques que pour les adresses et les schémas.

EXPO_PUBLIC_API_URL=http://192.168.1.25:3000
EXPO_PUBLIC_APP_SCHEME=com.example.app

Processus d’implémentation

Redémarrez Expo après avoir modifié .env.local. Lancez les tests et la vérification de types du paquet, puis confirmez le schéma résolu avec un build de développement : ouvrez un lien de callback d’authentification et vérifiez qu’il revient à l’application plutôt qu’au navigateur. Expo Go ne peut pas valider les schémas personnalisés de votre build natif.

Vérification et dépannage

Redémarrez Expo après avoir modifié .env.local et ouvrez l’aperçu sur l’appareil cible. Changez le thème, redémarrez l’application et confirmez que le choix persiste ; déclenchez ensuite un lien profond et vérifiez que l’application le route au lieu du navigateur.