命令行工具

在终端和 CI 上使用 Valance。

命令行工具与 App 处理相同的项目：拉取、比较差异、推送、验证、上传构建版本以及提交审核。它随 Valance 解锁一同提供。

1. 安装

   打开安装器并按照步骤操作。然后检查它能否正常工作：

   valance version

2. 提供许可证

   在 Valance 中，选择“设置”→“购买”→“导出命令行许可证”并存储文件。然后安装该许可证。请妥善保管：任何持有它的人都可以使用。

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

3. 提供 API 密钥

   该工具不使用存储在 App 中的密钥。请使用密钥 ID、Issuer ID（个人密钥可省略）以及你从 App Store Connect 下载的 .p8 文件路径，设置以下三个变量。

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

使用

每个命令都作用于 .valance 项目，就像 App 创建的那样。运行 help 可查看所有命令。

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

在 CI 服务器上

将许可证存储为密钥（secret），并通过 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