Communitygithub.com

appstore-release (publication App Store)

Automatisez les soumissions d'applications iOS sur App Store Connect à l'aide d'un fichier de configuration unique pour un pipeline de publication cohérent et fiable.

Qu'est-ce que appstore-release (publication App Store) ?

Appstore-release est un outil en ligne de commande conçu pour automatiser de bout en bout la soumission d'une application iOS (construite avec EAS/Expo) sur l'App Store via l'API App Store Connect. Il permet à un agent IA ou à un développeur de gérer l'ensemble du processus — de la vérification de l'environnement à la soumission en révision — sans intervention manuelle pour les étapes automatisables. L'outil est piloté par une configuration unique `config.json` qui contient toutes les métadonnées, les prix, les captures d'écran, les abonnements et les informations de révision. Il est idempotent : chaque commande peut être exécutée plusieurs fois sans risque. Seules deux étapes nécessitent une intervention humaine car Apple ne les expose pas via l'API : la déclaration des données de confidentialité et la première soumission d'abonnement. L'architecture suit les principes SOLID avec des services injectés, ce qui facilite l'extension par de nouvelles commandes. Il fonctionne sur macOS et Linux, nécessite Node.js, un compte développeur Apple, et une clé API App Store Connect. L'outil est conçu pour être utilisé avec Claude Code, Cursor, Codex ou tout autre agent capable d'exécuter des scripts Node.js.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add threelipped-genushesperiphona524/appstore-release

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

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)

  1. 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.
  2. 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é.
  3. 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.
  4. Idempotent : chaque commande peut être exécutée en toute sécurité plusieurs fois. node cli.mjs release peut ê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

  1. Clé API ASC (App Manager) : téléchargez AuthKey_XXXX.p8, notez l'ID de clé + l'ID d'émetteur.
  2. 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.
  3. Projet EAS configuré, eas login effectué.
  4. Remplissez config.json à partir de references/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…") :
    node cli.mjs credentials     # nouveau certificat de distribution + profil → credentials.json
    
    puis définissez "credentialsSource":"local" sur le profil de production eas.json.
  • Construisez + soumettez le binaire (exportez EXPO_ASC_API_KEY_PATH/KEY_ID/ISSUER_ID + EXPO_APPLE_TEAM_ID + EXPO_APPLE_TEAM_TYPE pour le mode non interactif) :
    eas build -p ios --profile production --non-interactive --no-wait
    eas submit -p ios --profile production --id <buildId>
    
    Attendez que la construction soit VALIDE (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 :

  1. 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 NSUserTrackingUsageDescription mais que vous ne déclarez aucun suivi, la publication est bloquée → supprimez la clé, reconstruisez (références/gotchas.md).
  2. 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 par lib/config.mjs).

Skills associés