Que fait asc-cli-usage ?
Guide pour utiliser l'asc cli dans ce dépôt (drapeaux, formats de sortie, pagination, authentification et découverte). Utilisez-le lorsque l'on vous demande d'exécuter ou de concevoir des commandes asc ou d'interagir avec App Store Connect via l'interface en ligne de commande.
Utilisation générale
Les commandes asc suivent la structure :
asc <ressource> <action> [options]
Drapeaux communs
| Drapeau | Description |
|---|---|
--help | Affiche l'aide pour une commande |
--format | Spécifie le format de sortie (json, table, yaml) |
--limit | Limite le nombre de résultats (pour la pagination) |
--filter | Filtre les résultats par une condition |
--sort | Trie les résultats par un champ |
--include | Inclut les ressources associées dans la réponse |
Formats de sortie
json: Sortie JSON brute (par défaut pour les scripts)table: Tableau formaté pour une lecture humaineyaml: Sortie YAML pour les configurations
Pagination
Pour les listes volumineuses, utilisez le drapeau --limit pour contrôler le nombre de résultats par page. Exemple :
asc builds list --limit 10
Pour obtenir la page suivante, examinez le champ next dans la réponse JSON et utilisez le paramètre --cursor avec le jeton de pagination fourni.
Authentification
L'authentification se fait via un jeton API. Définissez les variables d'environnement suivantes :
export ASC_API_KEY_ID=<votre-id-de-clé>
export ASC_API_ISSUER_ID=<votre-id-d'émetteur>
export ASC_API_KEY_PATH=<chemin-vers-votre-clé-privée>
Découverte des commandes
Pour lister toutes les ressources disponibles :
asc --help
Pour explorer une ressource spécifique :
asc <ressource> --help
Exemples
# Lister les builds récentes
export ASC_API_KEY_ID=ABC123
export ASC_API_ISSUER_ID=def-456
export ASC_API_KEY_PATH=./AuthKey.p8
asc builds list --limit 5 --format table