AIBit-Descubre proyectos de código abierto AIBit-Descubre proyectos de código abierto

ASC CLI: Automatización rápida y programable para App Store Connect

Descubra ASC CLI—una herramienta Go de código abierto que convierte App Store Connect en un patio de recreo de línea de comandos. Aprenda cómo instalarla vía Homebrew o desde el código fuente, autentíquese con claves API y ejecute scripts automatizados para compilaciones, TestFlight, reseñas y más. Su salida JSON‑primera, diseño sin interacción y comprobaciones internas de actualización hacen de ASC ideal para pipelines CI/CD y equipos de dev‑ops que necesitan un puente ligero y programable entre Xcode y 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

La herramienta guarda las credenciales en el llavero del sistema por defecto, o puede escribir un ~/.asc/config.json local cuando no hay llavero disponible.

Funcionalidades principales

  1. Gestión de compilaciones y versiones – Listar, listar todas, expirar y adjuntar compilaciones a versiones. Ejemplo: asc builds list --app 123456789 --paginate
  2. 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
  3. 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"
  4. 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.
  5. Compatibilidad Fastlane – Importar/exportar metadatos de Fastlane vía los comandos asc migrate.
  6. Zero Interaction – Cada comando se controla con banderas; sin prompts interactivos, está listo para CI.
  7. 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 --paginate para seguir automáticamente los enlaces next.
  • Ordenación – La bandera --sort soporta orden ascendente o descendente.
  • Formatos de salida – Cambie a tabla o markdown para informes legibles.
  • Depuración – --debug imprime salida verbose; --api-debug expone 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.