ASC CLI: Automatización rápida y programable para App Store Connect
ASC CLI – Automatización rápida y programable para App Store Connect
Si construye aplicaciones iOS, probablemente haya pasado horas explorando la consola web de App Store Connect para gestionar compilaciones, grupos de TestFlight o informes de ventas. La nueva ASC CLI (App‑Store‑Connect‑CLI) convierte esas tareas repetitivas en una herramienta ligera centrada en los scripts escrita en Go. Es de código abierto, con licencia MIT, y puede instalarse vía Homebrew o compilarse desde el código fuente.
¿Por qué usar ASC CLI?
| Desafío | Solución de ASC CLI |
|---|---|
| Trabajo manual | Automatice compilaciones, lanzamientos y retroalimentación desde la terminal |
| Herramientas pesadas | Un único binario Go (<10 MiB) con inicio instantáneo |
| Soporte de scripting pobre | Salida JSON‑primero, sintaxis de banderas clara, sin peticiones interactivas |
| Integración CI | No interactivo, amigable con el entorno, soporta pipelines CI/CD |
El README y la documentación muestran más de 60 comandos de alto nivel: asc builds, asc testflight, asc reviews, asc analytics e incluso asc migrate para compatibilidad con Fastlane. Todos los comandos devuelven por defecto JSON, pero puede cambiar a --output table o --output markdown cuando necesite datos legibles por humanos.
Inicio rápido
Homebrew (recomendado)
brew tap rudrankriyam/tap
brew install rudrankriyam/tap/asc
Desde el código fuente
git clone https://github.com/rudrankriyam/App-Store-Connect-CLI.git
cd App-Store-Connect-CLI
make build
sudo make install # instala en /usr/local/bin
Autenticación
asc auth login \
--name "MyApp"
--key-id "ABC123"
--issuer-id "DEF456"
--private-key /path/to/AuthKey.p8
~/.asc/config.json local cuando no hay llavero disponible.
Funcionalidades principales
- Gestión de compilaciones y versiones – Listar, listar todas, expirar y adjuntar compilaciones a versiones. Ejemplo:
asc builds list --app 123456789 --paginate - Automatización TestFlight – Añadir testers, gestionar grupos, obtener retroalimentación y exportar configuración vía YAML. Ejemplo:
asc testflight sync pull --app 123456789 --output testflight.yaml - Metadatos de la App Store – Establecer locales, categorías, precios y subir localizaciones. Ejemplo:
asc app-setup info set --app 123456789 --locale en-US --name "My Awesome App" - Informes de análisis y finanzas – Descargar ventas, finanzas e informes detallados directamente a TSV o CSV. Ejemplo:
asc analytics sales --vendor 12345678 --type SALES --frequency DAILY --date 2024-01-20. - Compatibilidad Fastlane – Importar/exportar metadatos de Fastlane vía los comandos
asc migrate. - Zero Interaction – Cada comando se controla con banderas; sin prompts interactivos, está listo para CI.
- Actualización automática – Cuando se instala mediante el script de instalación, ASC comprueba actualizaciones al iniciar y las aplica automáticamente.
Consejos avanzados de scripting
- Paginación – Use
--paginatepara seguir automáticamente los enlacesnext. - Ordenación – La bandera
--sortsoporta orden ascendente o descendente. - Formatos de salida – Cambie a tabla o markdown para informes legibles.
- Depuración –
--debugimprime salida verbose;--api-debugexpone rastreo HTTP. - Sobrescrituras de entorno – Establezca
ASC_KEY_ID,ASC_ISSUER_ID,ASC_PRIVATE_KEY(o base64) para saltar el login interactivo cuando se ejecute CI.
Flujo de trabajo de ejemplo
# Autenticar (una vez)
asc auth login --name myapp --key-id ABC123 --issuer-id DEF456 --private-key ~/.keys/AuthKey.p8
# Subir una nueva versión
asc builds upload --app 123456789 --ipa path/to/app.ipa
# Adjuntar compilación a una versión
asc versions attach-build \
--version-id V123-456 \
--build BUILD_ID
# Enviar para revisión
asc submit create --app 123456789 \
--version "1.5.0" \
--build BUILD_ID \
--confirm
# Obtener el estado de la presentación
asc submit status --id SUBMISSION_ID
Ejecutar este script en un job de CI le brinda una automatización completa de principio a fin sin abrir la interfaz de App Store Connect.
Comunidad y contribución
ASC CLI se mantiene activamente—más de 500 commits, 50 releases y 500+ estrellas en GitHub. Se aceptan contribuciones mediante pull requests; consulte CONTRIBUTING.md para las directrices. El proyecto depende de la comunidad de código abierto para solicitudes de características, reportes de bugs y mejoras de documentación.
Conclusión
ASC CLI ofrece una interfaz limpia, controlada por versiones y programable a App Store Connect que puede reemplazar los pasos manuales de la interfaz en cualquier flujo de trabajo. Es ideal para equipos que requieren despliegues automatizados y repetibles, y para desarrolladores individuales que deseen evitar el cuello de botella de la UI web.
Descargue, pruébelo hoy y lleve el poder del terminal a su pipeline de App Store Connect.