Configuration EAS

Configuration et paramètres

Avant toute étape, lisez Avant de commencer et Principes de base du terminal. Ces instructions supposent que vous avez ouvert le monorepo supastack complet dans VS Code ; sa racine package.json marque la racine du référentiel. Dans les commandes pnpm, un package d'espace de travail est une application ou un dossier de code partagé ; dans le produit, un espace de travail est le conteneur de données et la limite de sécurité d'une équipe. corepack pnpm --filter ... sélectionne un package dans le monorepo tandis que les commandes sont exécutées à partir de sa racine. Si vous avez ouvert uniquement un dossier mobile ou de bureau synchronisé, il ne contient pas le backend Web, la configuration Docker ou les scripts racine : exécutez le backend à partir de ce monorepo ou d'un serveur hébergé accessible et utilisez les propres scripts du dossier de plateforme. Une variable d'environnement est un paramètre nommé stocké dans un fichier .env local ou dans votre tableau de bord d'hébergement ; redémarrez l'application concernée après l'avoir modifiée et conservez les secrets du serveur en dehors des valeurs NEXT_PUBLIC_ et EXPO_PUBLIC_.

1. Ouvrez apps/mobile/eas.json et apps/mobile/app.json dans VS Code pour vérifier les paramètres de développement, d'aperçu et de production.

2. Ajoutez le client de développement natif à partir de la racine du référentiel avec le corepack pnpm --filter @supastack/mobile exec expo install expo-dev-client. Exécutez le corepack pnpm --filter @supastack/mobile typecheck, puis le corepack pnpm --filter @supastack/mobile build pour l'exportation JavaScript locale.

3. Pour les tests natifs, connectez-vous à votre compte Expo, modifiez le dossier du terminal avec cd apps/mobile, puis exécutez npx eas-cli@latest build --platform android --profile development. Utilisez iOS pour demander une version cloud iOS EAS à partir de n'importe quel système d'exploitation ; un Mac avec Xcode est nécessaire pour exécuter le simulateur iOS ou compiler localement. Attendu : l'exportation vérifie le bundle JavaScript et EAS produit une application de développement native installable. Consultez le Guide de construction de développement de Expo pour savoir pourquoi Expo Go ne peut pas ajouter de bibliothèques natives.

La compilation de l’espace de travail mobile lance son script d’exportation. Elle valide la mise en bundle pour les cibles configurées ; la signature des stores, la configuration de distribution et l’acceptation sur appareil physique sont des étapes séparées.

corepack pnpm --filter @supastack/mobile typecheck
corepack pnpm --filter @supastack/mobile test
corepack pnpm --filter @supastack/mobile build

Commandes à copier

Suivez les commentaires pour voir dans quel dossier une commande s'exécute. Si deux terminaux sont étiquetés, ouvrez deux fenêtres de terminal et laissez la première commande s'exécuter pendant que vous utilisez la seconde.

# From the monorepo root, install the native development client once:
corepack pnpm --filter @supastack/mobile exec expo install expo-dev-client
corepack pnpm --filter @supastack/mobile typecheck
corepack pnpm --filter @supastack/mobile build

# EAS needs to run where apps/mobile/eas.json is located:
cd apps/mobile
npx eas-cli@latest build --platform android --profile development

Processus d’implémentation

Après la modification d’un package utilisé par mobile, exécutez ses tests de contrat partagés. Sur les appareils visés, vérifiez les zones sûres natives, le comportement du clavier, la taille lisible du texte et la réduction des mouvements.

Gardez les achats natifs derrière la frontière RevenueCat existante. Une compilation réussie ne doit pas ajouter Stripe Checkout à l’interface mobile en remplacement d’une intégration d’achat native vérifiée.

Utilisez une build de développement EAS sur iOS ou Android pour valider react-native-purchases avec les produits sandbox configurés. Expo Go et l’export du workspace ne valident pas les transactions des boutiques.

Vérification et dépannage

Si la version EAS indique que expo-dev-client est manquant, répétez sa commande d'installation et confirmez que apps/mobile/package.json le répertorie désormais. Exécutez EAS à partir de apps/mobile pour qu'il trouve eas.json. Si EAS signale un projet ou une configuration de signature manquant, vérifiez votre compte Expo et les paramètres du projet. Expo Go et une exportation réussie ne testent toujours pas StoreKit ou Play Billing ; utilisez une version de développement EAS avec des produits sandbox. Une version cloud iOS peut être démarrée sous Windows ou Linux ; seul le travail de simulation/construction iOS local nécessite un Mac avec Xcode.

Notez l’appareil, la compilation, l’environnement API et le mode de connexion utilisés pour l’acceptation. Vérifiez le retour par lien profond, la restauration de session, les droits refusés et la déconnexion. Présentez séparément la réussite de l’exportation et les vérifications des stores et des appareils.

Une fois l’exportation réussie, si l’objectif est une publication, suivez Soumettre aux stores d’applications : les profils eas.json et les scripts build:/submit: fournis couvrent Google Play et l’App Store.