Ferramenta de linha de comandos

O Valance no Terminal e em CI.

A ferramenta de linha de comandos funciona com os mesmos projetos que a app: obter, comparar, enviar, verificar, carregar builds e submeter para revisão. Está incluída no desbloqueio do Valance.

1. Instale-a

   Abra o instalador e siga os passos. Depois, confirme que funciona:

   valance version

2. Forneça-lhe a licença

   No Valance, escolha Definições → Compra → Exportar licença da linha de comandos e guarde o ficheiro. Depois, instale-a. Mantenha-a privada: funciona para qualquer pessoa que a tenha.

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

3. Forneça-lhe uma chave da API

   A ferramenta não usa as chaves guardadas na app. Defina estas três variáveis com o ID da chave, o ID do emissor (omita-o no caso de uma chave individual) e o caminho para o ficheiro .p8 que descarregou do 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

Utilize-a

Todos os comandos funcionam com um projeto .valance, como o que a app cria. Execute help para os ver todos.

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

Num servidor de CI

Guarde a licença como segredo e passe-a em VALANCE_LICENSE, seja a própria licença ou o caminho para o ficheiro. O verify termina com um erro quando o App Store Connect não corresponde ao projeto, para que um pipeline consiga detetar uma ficha que se desviou.

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

Desinstalar

Remova a ferramenta e o registo que o instalador guardou dela:

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