Befehlszeilentool

Valance im Terminal und in der CI.

Das Befehlszeilentool arbeitet mit denselben Projekten wie die App: abrufen, Diff prüfen, übertragen, kontrollieren, Builds hochladen und zur Prüfung einreichen. Es ist in der Freischaltung von Valance enthalten.

1. Installieren

   Öffnen Sie das Installationsprogramm und folgen Sie den Schritten. Prüfen Sie dann, ob es funktioniert:

   valance version

2. Lizenz übergeben

   Wählen Sie in Valance Einstellungen → Kauf → Befehlszeilenlizenz exportieren und sichern Sie die Datei. Installieren Sie sie anschließend. Behalten Sie sie für sich: Sie funktioniert bei allen, die sie besitzen.

   valance license install ~/Downloads/Valance\ License.jws

3. API-Schlüssel angeben

   Das Tool verwendet nicht die in der App gespeicherten Schlüssel. Legen Sie diese drei Variablen fest, mit der Schlüssel-ID, der Aussteller-ID (bei einem individuellen Schlüssel weglassen) und dem Pfad zur .p8-Datei, die Sie aus App Store Connect geladen haben.

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

Verwenden

Jeder Befehl arbeitet mit einem .valance-Projekt, wie es die App erstellt. Führen Sie help aus, um alle anzuzeigen.

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

Auf einem CI-Server

Speichern Sie die Lizenz als Secret und übergeben Sie sie in VALANCE_LICENSE, entweder die Lizenz selbst oder den Pfad zur Datei. verify endet mit einem Fehler, wenn App Store Connect nicht mit dem Projekt übereinstimmt, sodass eine Pipeline einen abgewichenen Eintrag erkennen kann.

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

Deinstallieren

Entfernen Sie das Tool und den Eintrag des Installationsprogramms dazu:

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