expo-dev-client

Vue d’ensemble de la compétence expo-dev-client

À quoi sert expo-dev-client

La compétence expo-dev-client vous aide à déterminer si vous avez réellement besoin d’un client de développement Expo, puis vous guide pour le configurer et le builder avec EAS Build en local ou pour TestFlight. Son rôle ne se limite pas à « faire un build » : il s’agit surtout de « mettre une app de test personnalisée, capable d’utiliser du natif, sur de vrais appareils sans tâtonner dans la doc Expo ».

À qui s’adresse cette compétence

Cette compétence est particulièrement adaptée à :

• les équipes Expo qui ajoutent des modules natifs
• les développeurs qui testent des modules Expo locaux ou du code natif personnalisé
• les apps qui utilisent des cibles spécifiques à Apple comme les widgets, les app clips ou les extensions
• les équipes qui ont besoin d’un processus reproductible pour des tests iOS internes via TestFlight

Si votre app fonctionne entièrement dans Expo Go, cette compétence est généralement inutile.

La principale décision d’installation

La vraie question avant adoption est simple : avez-vous besoin d’un development client ou non ? La compétence expo-dev-client est utile précisément parce qu’elle tranche ce point très tôt. Elle vous pousse explicitement à essayer d’abord Expo Go avec npx expo start, ce qui évite du temps de build perdu et une complexité EAS inutile.

Ce qui distingue expo-dev-client d’un prompt Expo générique

Un prompt générique peut dire à un agent de « configurer Expo dev client », mais cette compétence est davantage orientée décision. Elle met l’accent sur :

• le seuil à partir duquel un dev client devient nécessaire
• la structure attendue de eas.json
• la différence entre les builds locaux et les builds cloud/TestFlight
• le chemin de commandes concret pour un test de type déploiement sur appareils physiques

Elle est donc plus utile pour les workflows de setup et les étapes proches de la release qu’un prompt d’assistance Expo trop généraliste.

Comment utiliser la compétence expo-dev-client

Installer la compétence expo-dev-client

Installez-la dans votre environnement compatible skills avec :

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

Comme cette compétence est compacte et principalement centrée sur SKILL.md, l’installation consiste surtout à la rendre disponible pour être réutilisée lors de tâches Expo liées aux tests natifs.

Commencez par le besoin réel, pas par la commande

Avant d’invoquer la compétence expo-dev-client, définissez l’objectif concret :

• « J’ai ajouté un SDK natif et je dois tester sur un iPhone »
• « Nous avons besoin d’un dev client spécifique à une branche pour la QA »
• « Notre app inclut maintenant un widget, donc Expo Go ne suffit plus »
• « Nous voulons un build de développement iOS distribué via TestFlight »

C’est important, car cette compétence est la plus pertinente quand le besoin de code natif personnalisé est clairement établi.

Vérifiez d’abord si Expo Go suffit

Une erreur fréquente consiste à utiliser expo-dev-client trop tôt. Le premier test recommandé est :

npx expo start

Si votre app fonctionne dans Expo Go, arrêtez-vous là. Un development client ajoute du temps de build, des exigences de signature et une charge de distribution. N’utilisez cette compétence que lorsque les capacités natives imposent réellement cette étape.

Identifiez les signaux qui indiquent un bon fit

Utilisez expo-dev-client si votre projet comprend :

• des modules Expo locaux
• du code natif personnalisé
• des modules natifs tiers indisponibles dans Expo Go
• des cibles Apple comme des widgets, app clips ou extensions

C’est dans ces cas que le dev client passe de « facultatif » à « indispensable ».

Préparez le minimum d’informations dont un agent a besoin

Si vous voulez qu’un agent utilise efficacement la compétence expo-dev-client, fournissez-lui :

• la plateforme cible : ios, android ou les deux
• le mode de distribution prévu : installation locale, test interne ou TestFlight
• si l’app a déjà EAS configuré
• votre eas.json actuel
• si l’app utilise des modules natifs non pris en charge par Expo Go
• d’éventuelles contraintes de versioning ou de signature

Sans ce contexte, l’agent peut toujours suggérer des commandes, mais il risque de rater le bon profil de build ou de vous prescrire une configuration trop lourde.

Utilisez un prompt plus solide que « set up expo-dev-client »

Un prompt faible :

Set up expo-dev-client.

Un prompt plus solide :

Use the expo-dev-client skill to determine whether this Expo app needs a dev client. We added a third-party native iOS SDK and need a TestFlight-distributed development build for internal QA. Review this eas.json, identify missing settings, and give the exact commands for building and submitting.

Pourquoi cela fonctionne mieux :

• il demande d’abord de valider le besoin
• il nomme explicitement le déclencheur natif
• il précise le workflow cible
• il fournit une configuration à corriger de façon concrète

Configurez correctement eas.json

La configuration clé mise en avant par cette compétence est un profil de build de développement avec developmentClient: true, généralement accompagné d’une automatisation de version :

{
  "cli": {
    "version": ">= 16.0.1",
    "appVersionSource": "remote"
  },
  "build": {
    "production": {
      "autoIncrement": true
    },
    "development": {
      "autoIncrement": true,
      "developmentClient": true
    }
  },
  "submit": {
    "production": {},
    "development": {}
  }
}

Les champs importants sont :

• developmentClient: true : indique à EAS d’embarquer le development client
• autoIncrement: true : réduit les frictions liées aux numéros de build
• appVersionSource: "remote" : maintient un versioning cohérent via EAS

Builder pour TestFlight quand le test à distance sur appareil est important

Pour les équipes iOS, le cas d’usage expo-dev-client usage le plus rentable est souvent TestFlight :

eas build -p ios --profile development --submit

C’est le flux pratique de expo-dev-client for Deployment quand vous avez besoin d’une app compatible dev distribuée à des testeurs, et pas seulement d’un artefact local. Cette approche combine build cloud et soumission, ce qui est généralement plus rapide que d’assembler des étapes séparées.

Utilisez les builds locaux quand la vitesse ou la confidentialité priment

Si vous n’avez pas besoin de TestFlight, les builds locaux peuvent être un meilleur workflow :

• itération plus rapide dans certains environnements
• meilleur contrôle sur l’outillage local
• utile pour tester sur appareil avant un déploiement interne plus large

Choisissez le local si vous déboguez la configuration ou si vous validez une intégration native sur votre propre appareil. Choisissez TestFlight si vous travaillez avec la QA ou des testeurs non techniques.

Lisez d’abord le bon fichier du dépôt

Cette compétence est simple : commencez par SKILL.md. Il n’y a pas de répertoires de support supplémentaires comme resources/, rules/ ou de scripts utilitaires dans ce chemin de compétence ; l’essentiel des conseils exploitables est donc déjà concentré dans ce fichier.

Cela signifie aussi qu’il ne faut pas s’attendre à une logique d’automatisation très poussée : il s’agit avant tout d’un guide pratique de décision et de workflow.

Workflow conseillé pour des projets réels

Un workflow expo-dev-client guide fiable ressemble à ceci :

1. Vérifier si Expo Go échoue pour une raison liée au natif.
2. Examiner ou créer eas.json.
3. Ajouter un profil development avec developmentClient: true.
4. Choisir entre build local et distribution via TestFlight.
5. Exécuter la commande EAS exacte pour votre plateforme.
6. Tester sur un appareil physique.
7. Revoir les réglages du profil si le versioning ou le comportement de soumission n’est pas correct.

Cet ordre évite des cycles de build inutiles et permet de repérer tôt le cas où « on n’avait pas besoin d’un dev client ».

FAQ sur la compétence expo-dev-client

Est-ce que expo-dev-client est réservé aux apps Expo avancées ?

Globalement oui. Les débutants peuvent l’utiliser, mais la compétence devient surtout pertinente quand une app dépasse les limites d’Expo Go à cause d’exigences natives. Si vous êtes encore dans un workflow entièrement managé, elle n’apportera peut-être pas de vraie valeur pour l’instant.

Est-ce que expo-dev-client revient simplement à installer expo-dev-client dans un projet ?

Non. La compétence expo-dev-client sert à cadrer le workflow autour des builds avec development client. Elle aide à savoir quand les utiliser, comment configurer EAS et comment choisir le bon chemin de build. Ce n’est pas un simple rappel d’installation de package.

Quand ne faut-il pas utiliser la compétence expo-dev-client ?

Ne l’utilisez pas si :

• votre app fonctionne déjà dans Expo Go
• vous n’avez besoin que d’itérations au niveau JavaScript
• vous cherchez un guide complet de release build plutôt qu’une configuration de development client
• votre problème n’a pas de lien avec les capacités natives ou la distribution des builds

En quoi est-ce différent d’un prompt classique de dépannage Expo ?

Un prompt standard produit souvent des conseils de build génériques. La expo-dev-client skill est plus ciblée et donc meilleure pour guider la décision d’installation : elle insiste sur le point de contrôle « faut-il un dev client ou non ? » ainsi que sur les détails précis du profil EAS qui bloquent fréquemment l’adoption.

Est-ce que expo-dev-client est aussi utile pour Android ?

Oui, mais les indications les plus explicites dans cet extrait concernent surtout iOS et TestFlight. La logique de fond reste valable pour les builds de développement Android lorsque du code natif personnalisé impose un dev client à la place d’Expo Go.

Est-ce adapté aux workflows de déploiement ?

Oui, dans certaines limites. expo-dev-client for Deployment doit surtout être compris comme un moyen de distribuer en interne des builds de développement, en particulier via TestFlight pour la QA ou les tests par branche. Cela ne remplace pas une vraie planification de release production.

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

Donnez l’état actuel du projet dès le départ

Pour obtenir de meilleurs résultats avec la compétence expo-dev-client, incluez :

• votre eas.json
• les appareils cibles et la plateforme
• s’il s’agit d’un usage purement local ou de TestFlight
• quel module natif ou quelle cible a imposé ce changement
• si Expo Go a déjà été testé

Cela aide l’agent à passer d’un conseil générique à des modifications et commandes précises.

Demandez d’abord une décision, ensuite les étapes

Un prompt de qualité commence par :

First determine whether this app truly needs expo-dev-client.

Cette seule instruction améliore la qualité de sortie, car la principale valeur de cette compétence est d’éviter une configuration de dev client inutile.

Incluez des extraits de configuration à relire

Si vous collez votre eas.json existant, un agent peut :

• détecter l’absence de developmentClient: true
• suggérer des corrections de versioning
• aligner les profils submit et build
• éviter d’inventer une configuration dont vous n’avez pas besoin

C’est bien plus efficace que de repartir de zéro.

Soyez explicite sur l’objectif de distribution

La bonne commande dépend de ce que vous voulez :

• un build de développement local
• un build cloud pour installation sur appareil
• un build iOS soumis à TestFlight

Si vous ne le précisez pas, la première réponse peut être techniquement correcte mais inadaptée au fonctionnement réel de votre équipe.

Surveillez le principal mode d’échec

L’échec le plus courant consiste à utiliser expo-dev-client pour des apps qui devraient rester dans Expo Go. Le second est de sous-spécifier la configuration EAS, puis de reprocher à la compétence des réponses vagues. Ces deux problèmes sont évitables si vous fournissez l’exigence native et la configuration actuelle.

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

Après une première réponse, posez des questions de suivi comme :

• « Validate this eas.json against a dev-client TestFlight workflow. »
• « Rewrite the build commands for Android only. »
• « Assume our app uses a widget extension; what changes the decision? »
• « Minimize the setup to the smallest working development profile. »

Cela fait passer la expo-dev-client skill d’une explication générique à une exécution adaptée à votre projet.

Facilitez l’adoption en équipe avec un prompt standard

Si plusieurs développeurs doivent utiliser cette compétence, créez un modèle de prompt interne réutilisable, par exemple :

Use expo-dev-client to assess whether this Expo app requires a development client. Here is our eas.json, target platform, distribution goal, and native dependency list. Return: 1) decision, 2) config changes, 3) exact commands, 4) likely blockers.

Cela rend les réponses plus cohérentes et réduit les frictions d’onboarding.

Utilisez la compétence comme un filtre de décision, pas seulement comme une recette

La meilleure façon d’améliorer expo-dev-client usage consiste à l’utiliser comme un point de passage décisionnel avant de lancer des builds. Si la compétence n’est utilisée qu’une fois que l’équipe a déjà acté l’usage d’un dev client, vous perdez son plus gros avantage : éviter une surcharge inutile liée aux workflows de build natif.