コマンドラインツール

ターミナルでも、CIでも、Valance。

コマンドラインツールは、Appと同じプロジェクトを扱います。プル、差分の確認、プッシュ、検証、ビルドのアップロード、審査への提出まで。Valanceの1回の購入に含まれています。

1. インストールする

   インストーラを開き、手順に従ってください。その後、動作することを確認します：

   valance version

2. ライセンスを渡す

   Valanceで「設定」→「購入」→「コマンドラインライセンスを書き出す」を選択し、ファイルを保存します。次に、それをインストールします。ライセンスを持っている人は誰でも使用できるため、他人と共有しないでください。

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

3. APIキーを渡す

   このツールは、Appに保存されているキーを使用しません。キーID、発行者ID（個人キーの場合は省略）、App Store Connectからダウンロードした.p8ファイルのパスを使って、次の3つの変数を設定してください。

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

使ってみる

すべてのコマンドは、Appで作成するものと同じ.valanceプロジェクトを扱います。helpを実行すると、すべてのコマンドを確認できます。

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

CIサーバで使う

ライセンスをシークレットとして保存し、VALANCE_LICENSEで渡します。ライセンスそのものでも、ファイルのパスでもかまいません。App Store Connectがプロジェクトと一致しない場合、verifyはエラーで終了するため、掲載情報のずれをパイプラインで検出できます。

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

アンインストール

ツールと、インストーラによるその記録を削除します：

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