App Store Release
Pilotez une soumission entière d'application iOS sur l'App Store Connect via l'API. Objectif de conception : l'utilisateur fournit les identifiants + un config.json une fois, puis l'agent fait tout ce qui est automatisable et n'interrompt l'utilisateur que pour les quelques éléments qu'Apple n'expose pas vraiment via l'API. Ne demandez pas à l'utilisateur de reconfirmer ce qui est déjà dans la configuration ou qui a des valeurs par défaut sensées.
Principe de fonctionnement (à lire en premier)
- Piloté par la configuration, pas par les invites. Tout le contenu de l'application se trouve dans
config.json. Exécutez les commandes ; n'interrogez pas l'utilisateur. - Seulement deux éléments sont uniquement dans l'interface utilisateur (Apple n'a pas d'API) : la collecte de données de confidentialité de l'application et la première soumission d'abonnement + soumission. Les outils détectent et signalent ces éléments avec des clics exacts. Tout le reste est scripté.
- Demandez à l'utilisateur uniquement lorsque : la configuration manque d'un champ obligatoire (indiquez exactement lequel), une décision commerciale n'est pas dans la configuration (prix de l'abonnement, calendrier de publication), ou avant l'unique action irréversible (soumission finale). Sinon, continuez.
- Idempotent : chaque commande peut être exécutée en toute sécurité plusieurs fois.
node cli.mjs releasepeut être exécuté de manière répétée.
Architecture (SOLID, pour que vous puissiez l'étendre)
scripts/
cli.mjs point d'entrée unique / dispatcheur (node cli.mjs <commande>)
lib/ services injectés, une responsabilité chacun
env.mjs analyser+valider l'environnement (identifiants, id d'application)
jwt.mjs fournisseur de jeton ES256
client.mjs AscClient — authentification + HTTP + erreurs uniformes
discovery.mjs localiser les ressources ASC par clé naturelle (pas d'identifiants codés en dur)
assets.mjs téléchargeur binaire : réserver → télécharger → valider
config.mjs charger + valider la configuration, lister ce qui manque
log.mjs résultats structurés + résumé lisible par machine
context.mjs racine de composition (injection de dépendances)
commands/ un fichier par tâche ; contrat uniforme (voir _contract.md)
Ajouter une capacité = ajouter un commands/x.mjs (méta + run(ctx)) et l'enregistrer dans cli.mjs.
Configuration (une fois) — voir références/setup.md
- Clé API ASC (App Manager) : téléchargez
AuthKey_XXXX.p8, notez l'ID de clé + l'ID d'émetteur. - L'enregistrement de l'application existe dans ASC (l'identifiant du bundle est enregistré).
ASC_APP_ID= l'identifiant numérique de l'URL ASC de l'application. - Projet EAS configuré,
eas logineffectué. - Remplissez
config.jsonà partir dereferences/config-template.json. Validez à tout moment : toute commande affiche exactement les champs manquants.
Environnement
export ASC_KEY_ID=... ASC_ISSUER_ID=... ASC_P8_PATH=/abs/AuthKey_XXXX.p8 # gitignore le .p8
export ASC_APP_ID=1234567890
export APPSTORE_CONFIG=/abs/config.json
cd scripts # puis : node cli.mjs <commande>
Livret de procédures
1. Orientation
node cli.mjs status # aperçu complet en lecture seule
node cli.mjs check # état de préparation + les étapes UI uniquement encore en attente
2. Construire le binaire (EAS)
- Si
eas buildéchoue avec des identifiants obsolètes ("provisioning profile expiré / aucun certificat avec le numéro de série…") :puis définisseznode cli.mjs credentials # nouveau certificat de distribution + profil → credentials.json"credentialsSource":"local"sur le profil de productioneas.json. - Construisez + soumettez le binaire (exportez
EXPO_ASC_API_KEY_PATH/KEY_ID/ISSUER_ID+EXPO_APPLE_TEAM_ID+EXPO_APPLE_TEAM_TYPEpour le mode non interactif) :Attendez que la construction soit VALIDE (eas build -p ios --profile production --non-interactive --no-wait eas submit -p ios --profile production --id <buildId>node cli.mjs status).
3. Remplir toute la fiche en une seule fois
node cli.mjs release # attacher la construction → métadonnées → tarification → droits de contenu →
# classification d'âge → catégorie → informations de révision → captures d'écran →
# abonnement → vérification
release exécute tout le pipeline (idempotent) et se termine par check, qui affiche les étapes uniquement UI restantes. Les captures d'écran doivent exister au préalable (répertoire config.screenshots.dir) — voir références/screenshots.md pour les générer.
4. Les deux étapes UI uniquement (transfert avec clics exacts)
check les liste lorsqu'elles s'appliquent :
- Confidentialité de l'application → Collecte de données : déclarez les types de données correspondant au manifeste de confidentialité de l'application, puis Publiez. ⚠️ Si le binaire contient
NSUserTrackingUsageDescriptionmais que vous ne déclarez aucun suivi, la publication est bloquée → supprimez la clé, reconstruisez (références/gotchas.md). - Premier abonnement : page de version → Achats intégrés et abonnements → Sélectionner → → Enregistrer → Ajouter pour révision → Soumettre. (L'API ne peut pas attacher un premier abonnement.)
5. Soumettre
node cli.mjs check # confirmer que rien ne manque
node cli.mjs submit --submit # application uniquement / mises à jour (pas de premier achat intégré)
Pour un premier abonnement, l'utilisateur soumet dans l'interface utilisateur (étape 4.2). Vérifiez avec status : version et abonnement sont tous deux WAITING_FOR_REVIEW.
Rejets
En cas de rejet, la version redevient modifiable (REJECTED/METADATA_REJECTED/DEVELOPER_REJECTED). Lisez le message du centre de résolution, corrigez (métadonnées via release, ou reconstruction pour les problèmes binaires), soumettez à nouveau.
Références
references/setup.md— création de clé, enregistrement d'application, EAS, hygiène des secrets.references/gotchas.md— tous les pièges réels (à lire avant la première exécution).references/screenshots.md— génération de PNG aux dimensions exactes (HTML → Chrome sans tête).references/config-template.json— configuration par application (validée parlib/config.mjs).