expo-deployment

Présentation de la compétence expo-deployment

expo-deployment est une compétence orientée déploiement pour les apps Expo. Elle aide un agent à passer de « l’app fonctionne en local » à un véritable parcours de mise en production sur l’iOS App Store, Google Play, l’hébergement web et les routes API via EAS. Son vrai rôle ne se limite pas à générer des commandes : il s’agit surtout de choisir le bon workflow Expo de déploiement, de configurer correctement les identifiants et d’éviter les blocages de soumission les plus fréquents qui ralentissent les premières mises en ligne.

À qui s’adresse la compétence expo-deployment

Cette compétence est particulièrement adaptée aux développeurs, fondateurs et équipes qui livrent une app Expo et ont besoin d’une aide concrète pour :

• une première configuration de EAS
• les parcours de soumission sur les stores
• la distribution via TestFlight
• la soumission dans Play Console
• le déploiement web avec EAS Hosting
• les workflows CI/CD pour des releases reproductibles

Si vous maîtrisez déjà le développement d’une app Expo mais êtes moins à l’aise avec les opérations de release, expo-deployment est un très bon choix.

Ce qui distingue expo-deployment d’un prompt générique

Un prompt IA générique peut vous dire « exécute EAS build puis submit ». La compétence expo-deployment devient vraiment utile quand vous avez besoin d’un guidage de release tenant compte des plateformes :

• elle se concentre sur le déploiement basé sur EAS, pas sur des conseils vagues de publication mobile
• elle renvoie vers des références concrètes pour iOS, Play Store, TestFlight, les métadonnées et les workflows
• elle reflète des tâches réelles de release Expo comme eas credentials, eas metadata:pull, les profils de soumission et les workflows de preview sur PR

C’est ce qui la rend plus pertinente à installer pour planifier un déploiement qu’un assistant de développement Expo plus généraliste.

Ce que les utilisateurs veulent généralement savoir d’abord

Avant d’installer la compétence expo-deployment, la plupart des utilisateurs veulent des réponses à quatre questions :

1. Peut-elle m’aider à publier sur les stores, et pas seulement à builder en local ?
2. Couvre-t-elle à la fois les releases manuelles et le CI/CD ?
3. M’aidera-t-elle pour la configuration des identifiants et les frictions propres à chaque store ?
4. Est-elle utile si je n’ai qu’une seule cible, comme TestFlight ou le web ?

D’après le dépôt, la réponse est oui aux quatre, avec une valeur particulièrement forte pour les workflows de mise en production iOS/Android sur les stores et l’automatisation EAS.

Principaux points forts et limites concrètes

Ses principaux atouts sont la couverture fonctionnelle et son orientation très opérationnelle. expo-deployment couvre depuis un même point d’entrée de déploiement les builds de production, les soumissions sur les stores, TestFlight, la gestion des métadonnées et les workflows automatisés.

Sa limite principale est qu’il s’agit malgré tout d’une compétence d’orchestration, pas d’un raccourci magique pour contourner les exigences des stores. Il vous faut toujours :

• des comptes Apple Developer et Google Play
• des fiches d’app et des bundle IDs cohérents
• des identifiants et clés API
• un eas.json valide
• des assets store et une conformité aux politiques

Si votre blocage vient de la création de compte ou d’une validation juridique/compliance, la compétence peut vous guider dans les étapes, mais elle ne peut pas supprimer ces dépendances externes.

Comment utiliser la compétence expo-deployment

Contexte d’installation pour la compétence expo-deployment

Installez la compétence dans votre environnement compatible, puis utilisez-la quand vous souhaitez que l’agent planifie ou exécute un travail de release Expo. Un schéma d’installation courant ressemble à ceci :

npx skills add https://github.com/expo/skills --skill expo-deployment

Vous en tirerez le plus de valeur si votre dépôt contient déjà une app Expo et si vous pouvez fournir des fichiers clés comme app.json, app.config.js ou eas.json.

Quels fichiers du dépôt lire en premier

Pour ce guide expo-deployment, le parcours de lecture le plus utile et le plus rapide est :

1. SKILL.md
2. references/workflows.md
3. references/testflight.md
4. references/ios-app-store.md
5. references/play-store.md
6. references/app-store-metadata.md

Pourquoi cet ordre :

• SKILL.md donne la surface fonctionnelle du déploiement
• workflows.md montre les schémas d’automatisation
• testflight.md décrit le chemin iOS bêta le plus rapide
• les références spécifiques aux stores traitent les vrais détails d’identifiants et de soumission
• les métadonnées deviennent importantes quand l’app approche du lancement

Les entrées nécessaires pour que la compétence fonctionne bien

La compétence expo-deployment fonctionne nettement mieux si vous fournissez un contexte de déploiement précis, et pas juste « déploie mon app ». Parmi les informations utiles :

• plateforme cible : ios, android, web ou all
• objectif de release : TestFlight, internal Play track, production stores, preview web deploy
• état actuel : EAS not initialized, eas.json exists, credentials partially configured
• identifiants de l’app : bundle/package IDs
• préférence CI/CD : release manuelle ou workflow automatisé
• contraintes : workflow managé, délais, accès équipe, disponibilité des identifiants

Sans ce contexte, la réponse restera générique, car les décisions de déploiement changent beaucoup selon la cible et l’étape de release.

Étapes minimales de configuration avant la première utilisation

Le dépôt indique clairement un point de départ de base pour le déploiement Expo :

npm install -g eas-cli
eas login
npx eas-cli@latest init

Cette initialisation crée eas.json, qui devient le centre des profils de build et de soumission. Si vous n’avez pas de eas.json, demandez à l’agent, via la expo-deployment skill, d’en créer un adapté à vos environnements plutôt que d’accepter aveuglément la configuration par défaut.

Principaux schémas d’usage de expo-deployment

Voici à quoi ressemblent des demandes concrètes et utiles pour expo-deployment usage :

• « Configure EAS pour des builds iOS et Android de production. »
• « Prépare cette app Expo pour TestFlight d’abord, puis pour une sortie App Store. »
• « Crée un eas.json avec des profils preview et production. »
• « Génère un EAS Workflow pour des déploiements web à chaque push sur main. »
• « Explique quels identifiants il me manque encore avant une soumission sur Play Store. »

Ces formulations sont bien meilleures que simplement dire « déploie cette app », car elles forcent la compétence à se placer sur un parcours de release concret.

Transformer un objectif vague en prompt efficace

Prompt faible :

Deploy my Expo app.

Prompt solide :

Use the expo-deployment skill to prepare my Expo app for iOS TestFlight and Android internal testing. We already have an Expo project, but no eas.json. Bundle IDs are set. I want manual release first, then GitHub-triggered automation. Tell me what files to create or edit, what credentials are required for Apple and Google, and which commands to run in order.

Pourquoi cette version fonctionne mieux :

• elle nomme les cibles
• elle précise l’état actuel de la configuration
• elle demande des étapes dans l’ordre
• elle distingue release manuelle et CI/CD
• elle demande des changements au niveau des fichiers, pas seulement des commandes

Meilleur workflow expo-deployment pour une première release mobile

Une séquence pragmatique de première release avec expo-deployment ressemble à ceci :

1. initialiser EAS
2. vérifier les profils eas.json
3. configurer les identifiants
4. builder une plateforme à la fois
5. envoyer d’abord iOS sur TestFlight
6. envoyer Android sur une piste interne
7. valider l’installation, les crashes, le versioning et les métadonnées store
8. ne soumettre largement qu’ensuite

Cela correspond à l’accent mis par le dépôt sur TestFlight comme voie iOS initiale la plus sûre.

Parcours iOS : TestFlight avant l’App Store avec expo-deployment

L’un des schémas les plus utiles de la compétence est sa position explicite en faveur d’un passage par TestFlight avant toute soumission App Store. La référence associée recommande fortement de ne pas aller directement en review App Store.

Les commandes typiques incluent :

eas build -p ios --profile production --submit

ou le raccourci :

npx testflight

Utilisez la compétence expo-deployment ici pour demander :

• la configuration des identifiants Apple
• la configuration de la clé API App Store Connect
• une stratégie autoIncrement
• l’ordre de déploiement des testeurs TestFlight

C’est là que la compétence apporte bien plus de valeur qu’une simple commande de build en une ligne.

Parcours Android : piste interne avant la production avec expo-deployment

Sur Android, le principal frein à l’adoption vient généralement de la configuration du service account, pas du build lui-même. Les indications du dépôt montrent que le travail important consiste à :

• créer un Google service account
• le relier à l’accès API de Play Console
• lui accorder les autorisations de release
• brancher serviceAccountKeyPath ou une configuration adossée à des secrets dans eas.json

Si vous utilisez expo-deployment for Deployment dans un cadre d’équipe, demandez à l’agent de privilégier une configuration CI basée sur des secrets plutôt que des fichiers de clés versionnés dans le dépôt.

Déploiement web et workflows de preview

La compétence est également pertinente si votre app Expo cible le web. La référence de workflow incluse couvre :

• les déploiements web de production à chaque push sur main
• les previews de PR
• les updates de preview de type OTA pour les pull requests natives

C’est utile si votre problème de release n’est pas la soumission sur les stores, mais la fiabilité des environnements de preview. Demandez à la compétence de mapper votre stratégie de branches vers .eas/workflows/*.yml plutôt que de générer des conseils génériques sur GitHub Actions.

La prise en charge des métadonnées App Store est utile, mais cadrée

Une fonctionnalité précieuse mais facile à manquer dans ce guide expo-deployment concerne l’automatisation des métadonnées. Le dépôt inclut des workflows store.config.json via EAS Metadata, notamment :

• eas metadata:pull
• eas metadata:push

Point important : la référence précise explicitement qu’il s’agit d’un support Apple App Store uniquement et en statut preview. Utilisez-le pour une gestion répétable des métadonnées App Store, mais ne supposez pas un niveau d’équivalence identique pour la gestion des fiches Google Play.

Conseils pratiques qui améliorent nettement la qualité des réponses

Pour obtenir de meilleures réponses de la expo-deployment skill, donnez à l’agent :

• votre eas.json actuel
• s’il s’agit d’une première soumission ou d’une mise à jour
• si des fiches d’app existent déjà dans App Store Connect et Play Console
• les pistes de release visées
• si vous avez besoin de commandes locales interactives ou d’une automatisation compatible CI

Ces détails font passer la réponse de « voici quelques commandes » à « voici le plan de déploiement exact, avec les blocages probables signalés ».

FAQ sur la compétence expo-deployment

La compétence expo-deployment convient-elle aux débutants ?

Oui, si vous êtes déjà à l’aise avec le code d’une app Expo mais débutez dans les opérations de release. La compétence est particulièrement utile pour les premières soumissions sur les stores, car elle réduit les tâtonnements autour de l’initialisation EAS, des identifiants et de l’ordre des étapes de publication.

Si vous découvrez totalement Expo, commencez d’abord par les bases du projet. Cette compétence sert à livrer une app, pas à la créer.

Quand utiliser expo-deployment plutôt qu’un prompt normal ?

Utilisez expo-deployment quand votre demande concerne la mécanique de release :

• configuration de eas.json
• mise en place des identifiants de soumission Apple ou Google
• build et soumission avec EAS
• déploiement TestFlight ou Play track
• automatisation de workflow
• gestion des métadonnées store

Pour des bugs d’interface ou du développement de fonctionnalités, une compétence de développement Expo plus généraliste sera plus adaptée.

Est-ce que expo-deployment installe quelque chose dans mon app ?

Le parcours expo-deployment install consiste surtout à ajouter la compétence à votre environnement IA, puis à utiliser l’outillage officiel d’Expo comme eas-cli. La compétence elle-même ne remplace pas EAS. En pratique, l’installation d’outillage principale est :

npm install -g eas-cli

Puis l’initialisation :

npx eas-cli@latest init

La compétence peut-elle aider si je n’ai besoin que de TestFlight ?

Oui. C’est même l’un de ses cas d’usage les plus nets. Le dépôt inclut une référence dédiée ainsi qu’un chemin de commande raccourci. Si votre objectif immédiat est « mettre une build sur de vrais iPhones en toute sécurité », cette compétence est un très bon choix.

Est-ce que expo-deployment peut aussi gérer des workflows CI/CD ?

Oui. Le fichier references/workflows.md couvre les EAS Workflows pour :

• déployer sur push
• générer des previews de PR
• gérer des previews d’updates
• exécuter des workflows de release avec jobs de build et de soumission

La compétence reste donc utile au-delà des soumissions ponctuelles.

Dans quels cas expo-deployment n’est pas le bon choix ?

Évitez cette compétence si :

• vous n’utilisez pas Expo/EAS
• vous avez seulement besoin de théorie générale sur les releases mobiles
• votre blocage concerne l’approbation légale, la conformité policy ou la validation de compte business
• vous avez besoin de cas limites très spécifiques aux stores natifs, au-delà de workflows centrés sur Expo

Dans ces situations, un expert de release propre à la plateforme ou la documentation officielle du store pourra être plus important qu’un assistant de déploiement Expo.

Comment améliorer l’usage de la compétence expo-deployment

Donnez à expo-deployment l’état réel de la release, pas seulement l’objectif

Le moyen le plus rapide d’améliorer les résultats de expo-deployment consiste à préciser ce qui est déjà vrai :

• eas.json existe ou non
• les identifiants sont configurés ou non
• les fiches d’app sont créées ou non
• première release ou mise à jour
• flux manuel ou cible CI/CD

Cela aide la compétence à ne pas perdre de temps sur des étapes que vous avez déjà terminées.

Demandez une sortie ordonnée avec des points de décision

Un format de demande efficace est :

1. auditer l’état actuel de préparation au déploiement
2. lister les blocages par plateforme
3. proposer les modifications de fichiers
4. fournir les commandes dans l’ordre
5. séparer le parcours manuel du parcours compatible CI

Cette structure pousse la compétence expo-deployment à produire quelque chose d’exécutable plutôt qu’un ensemble hétérogène de suggestions.

Fournissez de vrais fichiers de configuration pour un guidage plus précis

Si possible, fournissez :

• eas.json
• app.json ou app.config.*
• le package name / bundle identifier
• les fichiers YAML de workflow actuels

Ces fichiers permettent à la compétence de repérer des problèmes comme l’absence de profils de soumission, des identifiants incohérents ou une séparation trop faible entre environnements.

Surveillez les modes d’échec les plus fréquents

Les raisons les plus courantes pour lesquelles la sortie de expo-deployment échoue malgré tout restent des manques de configuration externes :

• fiche d’app App Store Connect absente
• app non créée dans Play Console
• bundle/package IDs qui ne correspondent pas
• clés API manquantes ou permissions insuffisantes
• numéros de version/build qui ne s’incrémentent pas

Demandez à la compétence de les valider explicitement avant de générer les étapes finales de release.

Améliorez vos prompts en nommant précisément la cible de release

« Deploy to production » est trop vague. Préférez :

• « Publier iOS pour des testeurs internes sur TestFlight »
• « Soumettre Android uniquement sur une piste interne »
• « Créer un workflow de déploiement web pour les push sur main »
• « Préparer les métadonnées App Store à partir de la fiche existante »

Des cibles explicites produisent un bien meilleur expo-deployment usage, car chaque parcours a ses propres prérequis et critères de réussite.

Itérez après la première réponse

Après la première réponse, affinez avec un second tour, par exemple :

• « Maintenant, convertis cela en étapes compatibles CI uniquement. »
• « Maintenant, génère les modifications exactes de eas.json. »
• « Maintenant, concentre-toi uniquement sur la configuration des identifiants iOS. »
• « Maintenant, liste ce que je dois faire manuellement dans App Store Connect. »

Cette réduction progressive est la meilleure manière de faire passer expo-deployment d’un guidage large à une checklist réellement déployable.