Outil en ligne de commande

Valance dans Terminal et en CI.

L’outil en ligne de commande fonctionne avec les mêmes projets que l’app : récupérez, comparez, envoyez, contrôlez, téléversez des builds et soumettez pour examen. Il est inclus avec le déverrouillage de Valance.

Téléchargement

Un programme d’installation pour Mac avec puce Apple sous macOS 27 ou version ultérieure, signé et notarié par Apple.

Télécharger le programme d’installation
  1. Installez-le

    Ouvrez le programme d’installation et suivez les étapes. Vérifiez ensuite qu’il fonctionne :

    valance version
  2. Fournissez-lui votre licence

    Dans Valance, choisissez Réglages → Achat → Exporter la licence en ligne de commande et enregistrez le fichier. Installez-le ensuite. Gardez-le pour vous : il fonctionne pour toute personne qui le possède.

    valance license install ~/Downloads/Valance\ License.jws
  3. Fournissez-lui une clé API

    L’outil n’utilise pas les clés stockées dans l’app. Définissez ces trois variables avec l’ID de la clé, l’ID de l’émetteur (à omettre pour une clé individuelle) et le chemin du fichier .p8 téléchargé depuis App Store Connect.

    export ASC_KEY_ID=ABC123DEFG
    export ASC_ISSUER_ID=00000000-0000-0000-0000-000000000000
    export ASC_PRIVATE_KEY=~/.appstoreconnect/AuthKey_ABC123DEFG.p8

Utilisez-le

Chaque commande fonctionne sur un projet .valance, comme celui que crée l’app. Exécutez help pour toutes les afficher.

valance pull MyApp.valance
valance diff MyApp.valance
valance push MyApp.valance
valance help

Sur un serveur CI

Stockez la licence comme secret et transmettez-la dans VALANCE_LICENSE, soit la licence elle-même, soit le chemin du fichier. verify se termine par une erreur quand App Store Connect ne correspond pas au projet, pour qu’un pipeline puisse repérer une fiche qui a divergé.

VALANCE_LICENSE="$VALANCE_LICENSE" valance verify Listing/MyApp.valance

Désinstallation

Supprimez l’outil et la trace qu’en garde le programme d’installation :

sudo rm -rf /usr/local/libexec/valance /usr/local/bin/valance
sudo pkgutil --forget com.ashleycorbion.valance.cli