Sobre o projeto

App Store Connect CLI (`asc`) é uma ferramenta de linha de comando rápida e scriptável para automatizar fluxos de trabalho do App Store Connect nas plataformas iOS, macOS, tvOS e visionOS. ### Instalação - Homebrew: `brew install asc` - Script de instalação: `curl -fsSL https://asccli.sh/install | bash` - WinGet: `winget install Rorkai.ASC --exact` - Binários de release disponíveis nas releases do GitHub; builds a partir do código-fonte exigem a versão do Go declarada em go.mod. ### Autenticação As chaves de API são geradas em appstoreconnect.apple.com. Autentique-se com: ```bash asc auth login --name "MyApp" --key-id "ABC123" --issuer-id "DEF456" --private-key /path/to/AuthKey.p8 --network ``` Chaves de API individuais omitem `--issuer-id` e usam `--key-type individual`. Para ambientes de CI ou sem interface, passe `--bypass-keychain`. Valide com `asc auth status --validate` ou `asc auth doctor`. ### Padrões de Saída `asc` usa saída `table` em terminais interativos e `json` em pipes/CI. Substitua globalmente via `ASC_DEFAULT_OUTPUT` ou por comando com `--output json --pretty`. ### Fluxos de Trabalho Comuns **TestFlight e builds:** ```bash asc apps list --output table asc builds upload --app "APP_ID" --ipa "/path/to/MyApp.ipa" asc testflight groups list --app "APP_ID" ``` **Submissão ao App Store:** ```bash asc publish appstore --app "APP_ID" --ipa "/path/to/MyApp.ipa" --version "1.2.3" --submit --confirm asc status --app "APP_ID" --watch ``` **Validação e revisão:** ```bash asc validate --app "APP_ID" --version "1.2.3" asc review status --app "APP_ID" asc validate --app "APP_ID" --version "1.2.3" --deep ``` A validação profunda verifica App Privacy, contratos e anexos de assinatura através dos endpoints web autenticados da Apple, sem prompts interativos. **Metadados e localização:** ```bash asc localizations list --app "APP_ID" --type app-info asc metadata apply --app "APP_ID" --version "1.2.3" --dir "./metadata" --dry-run asc metadata keywords audit --app "APP_ID" --version "1.2.3" --blocked-terms-file "./blocked-terms.txt" ``` A auditoria de palavras-chave reporta duplicatas, sobreposição com o nome/subtítulo do app, uso do orçamento em bytes e termos bloqueados. **Capturas de tela e mídia:** ```bash asc screenshots plan --app "APP_ID" --version "1.2.3" --review-output-dir "./screenshots/review" asc screenshots apply --app "APP_ID" --version "1.2.3" --review-output-dir "./screenshots/review" --confirm ``` A captura de tela baseada em matriz entre dispositivos, localidades e aparências é suportada via um arquivo de plano JSONC. **Assinatura e bundle IDs:** ```bash asc bundle-ids capabilities list --bundle "BUNDLE_ID" asc signing fetch --bundle-id com.example.app --profile-type IOS_APP_STORE --output .asc/signing asc signing sync pull --repo [email protected]:team/signing.git --password-file ~/.config/asc/signing-sync-password --output-dir .asc/signing/pulled ``` `signing fetch` baixa certificados e perfis de provisionamento. `signing sync` compartilha identidades através de um armazenamento Git criptografado. Use `--create-missing` para gerar chave/certificado/perfil ausentes em uma única passagem. **Automação de fluxo de trabalho:** ```bash asc workflow validate --output json asc workflow run --dry-run testflight_beta VERSION:1.2.3 ``` **Xcode Cloud:** ```bash asc xcode-cloud run --workflow-id "WORKFLOW_ID" --pull-request-id "PR_ID" asc xcode-cloud build-runs get --id "BUILD_RUN_ID" ``` **Apple Ads e StoreKit:** Credenciais OAuth separadas são usadas para campanhas do Apple Ads e StoreKit Retention Messaging. Consulte `asc ads auth login` e `asc storekit auth login` para configuração. ### Agent Skills 25 skills de automação `asc` revisadas estão disponíveis em https://github.com/rorkai/app-store-connect-cli-skills. Instale globalmente com `asc install-skills`, que fixa o commit verificado e verifica cada arquivo. ### Privacidade e Telemetria Telemetria pseudônima em nível de comando é enviada por padrão para ajudar os mantenedores a acompanhar a confiabilidade. Os eventos incluem versão da CLI, SO, arquitetura, caminho do comando, duração e status HTTP em falhas. Eles excluem argumentos brutos, credenciais, identificadores de conta Apple, bundle IDs e caminhos de arquivo. Desative com `ASC_TELEMETRY_DISABLED=1`, `DO_NOT_TRACK=1` ou `asc telemetry disable`. ### Documentação - `docs/CI_CD.md` — integração com GitHub Actions, GitLab, Bitrise, CircleCI - `docs/WORKFLOWS.md` — padrões locais do Xcode para o TestFlight - `commands/signing.mdx` — configuração de identidade de assinatura e rotação em CI - `guides/apple-ads-playbooks.mdx` — guias do operador do Apple Ads - `docs/API_NOTES.md` — peculiaridades e comportamentos da API - `docs/PARITY.md` — áreas de paridade restantes A ajuda integrada é autoritativa: `asc <command> --help`. Licença: MIT. Ferramenta não oficial, não afiliada à Apple Inc.