Sobre el proyecto

App Store Connect CLI (`asc`) es una herramienta de línea de comandos rápida y programable para automatizar flujos de trabajo de App Store Connect en las plataformas iOS, macOS, tvOS y visionOS. ### Instalación - Homebrew: `brew install asc` - Script de instalación: `curl -fsSL https://asccli.sh/install | bash` - WinGet: `winget install Rorkai.ASC --exact` - Binarios de release disponibles en GitHub releases; las compilaciones desde código fuente requieren la versión de Go declarada en go.mod. ### Autenticación Las claves de API se generan en appstoreconnect.apple.com. Autentícate con: ```bash asc auth login --name "MyApp" --key-id "ABC123" --issuer-id "DEF456" --private-key /path/to/AuthKey.p8 --network ``` Las claves de API individuales omiten `--issuer-id` y usan `--key-type individual`. Para entornos de CI o sin interfaz, pasa `--bypass-keychain`. Valida con `asc auth status --validate` o `asc auth doctor`. ### Valores predeterminados de salida `asc` usa salida `table` en terminales interactivas y `json` en pipes/CI. Anula globalmente mediante `ASC_DEFAULT_OUTPUT` o por comando con `--output json --pretty`. ### Flujos de trabajo comunes **TestFlight y compilaciones:** ```bash asc apps list --output table asc builds upload --app "APP_ID" --ipa "/path/to/MyApp.ipa" asc testflight groups list --app "APP_ID" ``` **Envío a 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 ``` **Validación y revisión:** ```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 ``` La validación profunda comprueba App Privacy, acuerdos y adjuntos de suscripciones mediante los endpoints web con sesión iniciada de Apple, sin solicitudes interactivas. **Metadatos y localización:** ```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" ``` La auditoría de palabras clave informa de duplicados, solapamiento con el nombre/subtítulo de la app, uso del presupuesto de bytes y términos bloqueados. **Capturas de pantalla y multimedia:** ```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 ``` Se admite la captura de pantallas basada en matrices entre dispositivos, idiomas y apariencias mediante un archivo de plan JSONC. **Firma e IDs de bundle:** ```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` descarga certificados y perfiles de aprovisionamiento. `signing sync` comparte identidades mediante un almacén Git cifrado. Usa `--create-missing` para generar la clave/certificado/perfil que falten en una sola pasada. **Automatización de flujos de trabajo:** ```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 y StoreKit:** Se usan credenciales OAuth independientes para campañas de Apple Ads y StoreKit Retention Messaging. Consulta `asc ads auth login` y `asc storekit auth login` para la configuración. ### Agent Skills Hay 25 skills de automatización de `asc` revisadas disponibles en https://github.com/rorkai/app-store-connect-cli-skills. Instálalas globalmente con `asc install-skills`, que fija el commit extraído y verifica cada archivo. ### Privacidad y telemetría De forma predeterminada se envía telemetría seudónima a nivel de comando para ayudar a los mantenedores a seguir la fiabilidad. Los eventos incluyen versión de la CLI, SO, arquitectura, ruta del comando, duración y estado HTTP en fallos. Excluyen argumentos sin procesar, credenciales, identificadores de cuentas de Apple, IDs de bundle y rutas de archivos. Desactívala con `ASC_TELEMETRY_DISABLED=1`, `DO_NOT_TRACK=1` o `asc telemetry disable`. ### Documentación - `docs/CI_CD.md` — integración con GitHub Actions, GitLab, Bitrise, CircleCI - `docs/WORKFLOWS.md` — patrones de Xcode local a TestFlight - `commands/signing.mdx` — configuración de identidad de firma y rotación en CI - `guides/apple-ads-playbooks.mdx` — guías para operadores de Apple Ads - `docs/API_NOTES.md` — peculiaridades y comportamientos de la API - `docs/PARITY.md` — áreas de paridad restantes La ayuda integrada es la fuente autoritativa: `asc <command> --help`. Licencia: MIT. Herramienta no oficial, no afiliada a Apple Inc.