ASC CLI : Automation rapide et scriptable pour App Store Connect

ASC CLI – Automation rapide et scriptable pour App Store Connect

Si vous développez des applications iOS, vous avez probablement passé des heures à fouiller la console Web d'App Store Connect pour gérer les builds, les groupes TestFlight ou les rapports de ventes. Le nouvel ASC CLI (App‑Store‑Connect‑CLI) convertit ces tâches répétitives en un outil léger, priorisant le script, écrit en Go. C’est un projet open‑source sous licence MIT, et il peut être installé via Homebrew ou construit à partir du code source.

Pourquoi utiliser ASC CLI ?

Le README et la documentation présentent plus de 60 commandes de haut niveau : asc builds, asc testflight, asc reviews, asc analytics, et même asc migrate pour la compatibilité Fastlane. Toutes les commandes produisent par défaut du JSON, mais vous pouvez passer à --output table ou --output markdown quand vous avez besoin de données lisibles par un humain.

Démarrage rapide

Homebrew (recommandé)

brew tap rudrankriyam/tap
brew install rudrankriyam/tap/asc

À partir du source

git clone https://github.com/rudrankriyam/App-Store-Connect-CLI.git
cd App-Store-Connect-CLI
make build
sudo make install  # installe dans /usr/local/bin

Authentification

asc auth login \
  --name "MyApp"
  --key-id "ABC123"
  --issuer-id "DEF456"
  --private-key /path/to/AuthKey.p8

Fonctionnalités principales

1. Gestion des builds & des versions – Lister, lister tout, expirer et rattacher des builds aux versions. Exemple : asc builds list --app 123456789 --paginate
2. Automatisation TestFlight – Ajouter des testeurs, gérer les groupes, récupérer les retours, et exporter la configuration via YAML. Exemple : asc testflight sync pull --app 123456789 --output testflight.yaml
3. Métadonnées App Store – Définir les locales, catégories, prix et télécharger les localisations. Exemple : asc app-setup info set --app 123456789 --locale en-US --name "My Awesome App"
4. Rapports Analytics & Finance – Télécharger les ventes, les finances, et les rapports détaillés directement au TSV ou CSV. Exemple : asc analytics sales --vendor 12345678 --type SALES --frequency DAILY --date 2024-01-20.
5. Compatibilité Fastlane – Importer/exporter les métadonnées Fastlane via les commandes asc migrate.
6. Aucune interaction – Chaque commande est pilotée par des drapeaux ; l'absence d'invites interactives le rend prêt pour la CI.
7. Auto‑mise à jour – Lorsqu'il est installé via le script d'installation, ASC vérifie les mises à jour au démarrage et les applique automatiquement.

Conseils avancés de scripting

• Pagination – Utilisez --paginate pour suivre automatiquement les liens next.
• Tri – Le drapeau --sort supporte l'ordre ascendant ou descendant.
• Formats de sortie – Passez au format table ou markdown pour des rapports lisibles.
• Débogage – --debug affiche une sortie verbeuse ; --api-debug expose la trace HTTP.
• Overrides environnementaux – Définissez ASC_KEY_ID, ASC_ISSUER_ID, ASC_PRIVATE_KEY (ou base64) pour sauter l'identification interactive lorsqu'on exécute en CI.

Exemple de workflow

# Authentifier (une seule fois)
asc auth login --name myapp --key-id ABC123 --issuer-id DEF456 --private-key ~/.keys/AuthKey.p8

# Créer un nouveau build
asc builds upload --app 123456789 --ipa path/to/app.ipa

# Attacher le build à une version
asc versions attach-build \
  --version-id V123-456 \
  --build BUILD_ID

# Soumettre pour révision
asc submit create --app 123456789 \
  --version "1.5.0" \
  --build BUILD_ID \
  --confirm

# Récupérer le statut de la soumission
asc submit status --id SUBMISSION_ID

Exécuter ce script dans un job CI vous donne une automatisation complète de bout en bout sans ouvrir l'interface UI d'App Store Connect.

Communauté et contribution

ASC CLI est activement maintenu — plus de 500 commits, 50 releases et plus de 500 stars sur GitHub. Les contributions sont les bienvenues via des pull requests; consultez le CONTRIBUTING.md pour les lignes directrices. Le projet compte sur la communauté open‑source pour les demandes de nouvelles fonctionnalités, les rapports d'erreurs, et les améliorations de la documentation.

En conclusion

ASC CLI offre une interface propre, contrôlée par version, scriptable vers App Store Connect qui peut remplacer les étapes manuelles de l'UI à n'importe quel workflow de développement. C’est idéal pour les équipes qui ont besoin de déploiements répétitifs et automatisés, ainsi que pour les développeurs individuels qui souhaitent éviter le goulot d’étranglement de l'UI web.

Téléchargez, essayez dès aujourd'hui, et introduisez la puissance du terminal dans votre pipeline App Store Connect.