🔹 build
Copia un prompt de configuración con los pasos de instalación y la guía completa en markdown para este plugin.
🏗️ Gestiona builds nativos de iOS/Android con Capgo Cloud.
Acceso a builds y output
Sección titulada “Acceso a builds y output”Los builds nativos en la nube están disponibles en todos los planes de Capgo. Las credenciales de build nunca se almacenan en los servidores de Capgo: solo se usan para el build y luego se eliminan. Los outputs del build pueden subirse opcionalmente con enlaces de descarga temporales.
Guarda las credenciales primero
Sección titulada “Guarda las credenciales primero”npx @capgo/cli build credentials save --appId YOUR_APP_ID --platform iosnpx @capgo/cli build credentials save --appId YOUR_APP_ID --platform androidCaptura una URL de salida en CI
Sección titulada “Captura una URL de output en CI”Pasa --output-record para persistir la URL de descarga y el QR code, y luego usar build last-output para leerlo:
npx @capgo/cli build request APP_ID --platform android --output-upload --output-record /tmp/build.jsonnpx @capgo/cli build last-output --path /tmp/build.json --field outputUrl🔹 Necesario
Sección titulada “ 🔹 Necesario”npx @capgo/cli@latest build needed🧭 Imprime “yes” y termina con code 1 si se requiere un Native Build; de lo contrario, imprime “no” y termina con code 0. Si un comando falla, termina con code 2.
Ejemplo:
npx @capgo/cli@latest build needed com.example.app --channel production --verboseOpciones:
| Parámetro | Tipo | Descripción |
|---|---|---|
| -a | string | clave API para vincular a tu cuenta |
| -c | string | Canal con el que comparar. Por defecto, CapacitorUpdater.defaultChannel o el canal público por defecto |
| --package-json | string | Rutas a los archivos package.json para monorepos (separadas por comas) |
| --node-modules | string | Rutas a los directorios node_modules para monorepos (separadas por comas) |
| —verbose | boolean | Activa la salida verbose con logs detallados |
| —supa-host | string | URL del host de Supabase personalizada (para self-hosting o desarrollo con Capgo) |
| —supa-anon | string | Clave anon personalizada de Supabase (para self-hosting) |
Alias: onboarding
npx @capgo/cli@latest build initConfigura las credenciales de build de forma interactiva (iOS: certificados + profiles automatizados; Android: keystore + Google OAuth aprovisiona la cuenta de servicio de GCP y la invitación de Play Console)
Opciones:
| Parámetro | Tipo | Descripción |
|---|---|---|
| -a | string | clave API para vincular a tu cuenta |
| -p | string | Plataforma para el onboarding (ios o android). Si se omite, se autodetecta si solo hay una carpeta nativa; de lo contrario, lanza un prompt. |
| —supa-host | string | URL del host de Supabase personalizada (para self-hosting o desarrollo con Capgo) |
| —no-analytics | boolean | Desactiva las analytics de onboarding y el terminal replay para esta ejecución |
🔹 Solicitud
Sección titulada “ 🔹 Solicitud”npx @capgo/cli@latest build requestSolicita un Native Build desde Capgo Cloud. Este comando comprimirá el directorio de tu proyecto y lo subirá a Capgo para el build. El build se procesará y se enviará directamente a las tiendas de apps. Las credenciales nunca se almacenan en los servidores de Capgo; se eliminan después del build. Guárdalas antes de solicitar un build:
npx @capgo/cli build credentials save --appId APP_ID --platform iosEjemplo:
npx @capgo/cli@latest build request com.example.app --platform ios --path .Opciones:
| Parámetro | Tipo | Descripción |
|---|---|---|
| —path | string | Ruta al directorio del proyecto a buildear (por defecto: directorio actual) |
| --node-modules | string | Rutas a los directorios node_modules para monorepos (separadas por comas) |
| —platform | string | Plataforma de destino: ios o android (requerido) |
| —build-mode | string | Modo de build: debug o release (por defecto: release) |
| —build-certificate-base64 | string | iOS: Certificado .p12 codificado en Base64 |
| —p12-password | string | iOS: Contraseña del certificado (opcional si no tiene contraseña) |
| —apple-id | string | iOS: email de Apple ID para subir app-specific passwords (alternativa a la clave API de App Store Connect) |
| —apple-app-specific-password | string | iOS: app-specific password (xxxx-xxxx-xxxx-xxxx) para subir a TestFlight |
| —apple-app-id | string | iOS: ID numérico de la app en App Store Connect (requerido junto con —apple-id y —apple-app-specific-password) |
| —apple-key-id | string | iOS: Key ID de API de App Store Connect |
| —apple-issuer-id | string | iOS: Issuer ID de App Store Connect |
| —apple-key-content | string | iOS: Clave API de App Store Connect en Base64 (.p8) |
| —app-store-connect-team-id | string | iOS: Team ID de App Store Connect |
| —ios-scheme | string | iOS: Scheme de Xcode para el build (por defecto: App) |
| —ios-target | string | iOS: Target de Xcode para leer build settings (por defecto: el mismo que el scheme) |
| —xcode-version | string | iOS: Build en una máquina con esta versión de Xcode (ej. 26, 26.0.1, 27). Una versión mayor acepta cualquier minor. Por defecto: cualquier máquina. Precedencia: CLI > env (CAPGO_IOS_XCODE_VERSION) > credenciales guardadas |
| —ios-distribution | string | iOS: Modo de distribución |
| —ios-provisioning-profile | string | iOS: Ruta del provisioning profile o mapeo bundleId=path (repetible) |
| —android-keystore-file | string | Android: Archivo keystore codificado en Base64 |
| —keystore-key-alias | string | Android: Alias de la clave del keystore |
| —keystore-key-password | string | Android: Contraseña de la clave del keystore |
| —keystore-store-password | string | Android: Contraseña del almacén del keystore |
| —play-config-json | string | Android: JSON de la cuenta de servicio de Google Play en Base64 |
| —android-flavor | string | Android: Product flavor para el build (p. ej. production). Obligatorio si tu proyecto tiene varios flavors. |
| —android-track | string | Android: track de Google Play para este upload (internal, alpha, beta, production). Por defecto sin —submit-to-store-review: internal. Con —submit-to-store-review y sin track definido: production. Precedencia: CLI > env > credenciales guardadas |
| —android-release-status | string | Android: estado de la release en Google Play (draft, completed, inProgress, halted). Por defecto sin —submit-to-store-review: draft. Con —submit-to-store-review y sin status definido: completed. Precedencia: CLI > env > credenciales guardadas |
| —in-app-update-priority | string | Android: prioridad de in-app update de Google Play para esta release (entero 0–5; mayor = más urgente). Ver https://developer.android.com/guide/playcore/in-app-updates. Precedencia: CLI > env > credenciales guardadas |
| —no-playstore-upload | boolean | Omite el upload a Play Store para este build (anula la config de play guardada). Requiere —output-upload. |
| —submit-to-store-review | boolean | Tras el upload, envía la versión a la tienda para revisión en lugar de dejarla como un build de borrador o inactivo. En Android, esto apunta por defecto al track de producción con release_status completed (puedes sobrescribirlo con —android-track / PLAY_STORE_TRACK y —android-release-status / PLAY_STORE_RELEASE_STATUS). En iOS, envía el build procesado de TestFlight a revisión en la App Store. |
| —store-release-name | string | Nombre o etiqueta de versión de la release en la tienda. Android lo envía como el version_name de Google Play; iOS lo usa como la versión de la App Store al crear o reutilizar una versión editable. |
| —store-release-notes | string | Notas de la release por defecto. Android las usa como el changelog de Play; iOS las usa como el texto de fallback en |
| —store-release-notes-locale | string | Notas de la release localizadas (repetible), por ejemplo —store-release-notes-locale en-US=“Bug fixes” —store-release-notes-locale es-ES=“Corrección de errores”. |
| —ios-testflight-groups | string | iOS: nombres o IDs de grupos externos de TestFlight separados por comas para la distribución beta externa. |
| —ios-automatic-release | boolean | iOS: lanza automáticamente la versión de la App Store tras la aprobación de Apple. Por defecto es manual. |
| —no-ios-automatic-release | boolean | iOS: mantén la versión de la App Store pendiente de lanzamiento manual tras la aprobación de Apple. |
| —output-upload | boolean | Sobrescribe el comportamiento de upload del output solo para este build (activar). Precedencia: CLI > env > credenciales guardadas |
| —no-output-upload | boolean | Sobrescribe el comportamiento de upload del output solo para este build (desactivar). Precedencia: CLI > env > credenciales guardadas |
| —output-retention | string | Sobrescribe el TTL del link de output solo para este build (1h a 7d). Ejemplos: 1h, 6h, 2d. Precedencia: CLI > env > credenciales guardadas |
| —output-record | string | Tras un build exitoso, escribe un registro JSON (jobId, status, outputUrl, qrCodeAscii, qrCodePngPath, finishedAt) en una ruta. También se escribe un QR code en PNG junto a esa ruta con el .qr.png sufijo. Lee los campos con build last-output. |
| —no-cache | boolean | Omitir restauración de caché de build y no guardar una nueva entrada de caché para este build. La caché de build está activada por defecto para cada app. |
| —cache-key | string | Divide la caché de build por entorno, rama o flavor de Android (por ejemplo prod, staging). Omítelo para usar una caché predeterminada compartida por app. |
| —no-skip-build-number-bump | boolean | Sobrescribe las credenciales guardadas para reactivar el incremento automático del build number solo para este build. |
| —skip-marketing-version-bump | boolean | Omite el incremento automático de la marketing version (CFBundleShortVersionString / versionName) si la app ya está publicada. |
| —sync-ios-version | boolean | iOS: sincroniza la MARKETING_VERSION de Xcode desde package.json antes de subir el proyecto. |
| —ai-analytics | boolean | Si el build falla, envía los logs a la IA de Capgo para el diagnóstico. En terminales interactivos se omite la confirmación inicial; en CI, se suben automáticamente y se imprime el análisis en stderr. |
| —no-prescan | boolean | Omite el escaneo automático previo al build |
| —prescan-ignore-fatal | boolean | Ejecuta el escaneo previo al build pero nunca lo bloquea (solo reporta) |
| —prescan-skip | string | Omite check(s) de prescan específicos por id (repetible o separado por comas). El resto de checks se ejecutan. |
| —prescan-warn | string | Cambia check(s) de prescan específicos a warning por id (repetible o separado por comas). El check se sigue ejecutando. |
| —fail-on-warnings | boolean | Trata los warnings del prescan como errores fatales |
| —send-logs-to-support | boolean | Si falla un build en CI/CD, sube automáticamente los logs de build al soporte de Capgo (sin necesidad de email). Se notifica al soporte de Capgo y te contactarán por email. Se suma a —ai-analytics. |
| —send-logs | boolean | Alias obsoleto para —send-logs-to-support |
| -a | string | clave API para vincular a tu cuenta |
| —supa-host | string | URL del host de Supabase personalizada (para self-hosting o desarrollo con Capgo) |
| —supa-anon | string | Clave anon personalizada de Supabase (para self-hosting) |
| —verbose | boolean | Activa la salida verbose con logs detallados |
Caché de build: Por defecto, Capgo restaura y guarda los artefactos nativos compilados (CocoaPods, Gradle y salidas relacionadas) por app. Usa --cache-key para mantener separados los cachés de RC y producción; usa --no-cache para un build limpio puntual. Las integraciones de API pueden pasar cache_key o cache_enabled: false en el payload de la solicitud de build. Consulta Caché de build y Troubleshooting: error al restaurar el caché.
🔹 Sync-ios-version
Sección titulada “ 🔹 Sync-ios-version”npx @capgo/cli@latest build sync-ios-versionSincroniza el MARKETING_VERSION de Xcode en iOS desde package.json.
Ejemplo:
npx @capgo/cli@latest build sync-ios-version --path .Opciones:
| Parámetro | Tipo | Descripción |
|---|---|---|
| —path | string | Ruta al directorio del proyecto (por defecto: directorio actual) |
| —check | boolean | Solo comprobación; devuelve error si MARKETING_VERSION está desincronizada |
🔹 Prescan
Sección titulada “ 🔹 Prescan”npx @capgo/cli@latest build prescanEscanea tu proyecto y credenciales guardadas en busca de errores que fallarían un cloud build, antes de subir nada.
Revisa credenciales (expiración, contraseñas, vinculación de perfiles), el estado del proyecto (cap sync, estructura de node_modules) y la config de la plataforma. Se ejecuta automáticamente en build request; este comando lo ejecuta de forma independiente (ej. en CI).
Consulta Checks de prescan para ver el catálogo completo de comprobaciones y cómo --skip / --warn reglas individuales.
Opciones:
| Parámetro | Tipo | Descripción |
|---|---|---|
| —platform | string | Plataforma de destino: ios o android (obligatorio) |
| —path | string | Ruta al directorio del proyecto (por defecto: directorio actual) |
| -a | string | clave API para vincular a tu cuenta |
| —android-flavor | string | Android: product flavor que usará el build |
| —ios-dist | string | iOS: modo de distribución para la validación |
| —json | boolean | Genera un reporte JSON legible por máquinas |
| —fail-on-warnings | boolean | Devuelve un error si se encuentran warnings (CI) |
| —ignore-fatal | boolean | Modo diagnóstico: reporta todo pero siempre exit 0 |
| —skip | string | Omite checks específicos por id (repetible o por comas) |
| —warn | string | Convierte checks específicos en warnings por id (repetible o por comas) |
| —verbose | boolean | Activa la salida verbose con logs detallados |
| —supa-host | string | URL del host de Supabase personalizada (para self-hosting o desarrollo con Capgo) |
| —supa-anon | string | Clave anon personalizada de Supabase (para self-hosting) |
🔹 Last-output
Sección titulada “ 🔹 Last-output”npx @capgo/cli@latest build last-outputLee el registro de salida del build escrito por un proceso anterior build request --output-record.
Por defecto imprime el JSON completo, un campo único con —field, o el QR en ASCII
code con —qr. Útil en CI para obtener la URL de descarga o el QR para
publicarlo en un PR o issue.
Ejemplos:
npx @capgo/cli build last-output —path /tmp/build.json
npx @capgo/cli build last-output —path /tmp/build.json —field outputUrl
npx @capgo/cli build last-output —path /tmp/build.json —qr
Opciones:
| Parámetro | Tipo | Descripción |
|---|---|---|
| —path | string | Ruta al registro JSON generado por —output-record (obligatorio) |
| —field | string | Imprime un campo específico (uno de: jobId, appId, platform, buildMode, status, outputUrl, qrCodeAscii, qrCodePngPath, finishedAt, schemaVersion) |
| —qr | boolean | Imprime el QR code en formato ASCII (atajo de —field qrCodeAscii) |
🔹 Credentials
Sección titulada “ 🔹 Credentials”Gestiona las credenciales de build guardadas localmente en tu máquina. 🔒 SEGURIDAD:
- Credenciales guardadas en ~/.capgo-credentials/credentials.json (global) o .capgo-credentials.json (local)
- Al compilar, se envía a Capgo pero NUNCA se almacena permanentemente
- Se elimina de Capgo inmediatamente después del build
- Los resultados del build pueden subirse opcionalmente para generar enlaces de descarga temporales 📚 DOCUMENTACIÓN: Configuración de iOS: https://capgo.app/docs/cli/cloud-build/ios/ Configuración de Android: https://capgo.app/docs/cli/cloud-build/android/
🔹 Apple-key
Sección titulada “ 🔹 Apple-key”Alias: asc-key
npx @capgo/cli@latest build credentials apple-keyCrea una clave API de equipo de App Store Connect con un asistente guiado para macOS (solo macOS). Abre una ventana nativa que te guía por la interfaz de App Store Connect de Apple en un navegador embebido, captura automáticamente el Issuer ID + Key ID, intercepta el archivo .p8 de un solo uso, lo valida con Apple y lo guarda en ~/.appstoreconnect/private_keys. Las estadísticas de progreso se envían a la analítica de Capgo (desactívalas con CAPGO_DISABLE_TELEMETRY). npx @capgo/cli build credentials apple-key —appId com.example.app
Ejemplo:
Example:Opciones:
| Parámetro | Tipo | Descripción |
|---|---|---|
| -a | string | clave API para vincular a tu cuenta |
| —appId | string | Guarda la clave capturada en estas credenciales de build de iOS de la app |
| —local | boolean | Guarda en el archivo .capgo-credentials.json del proyecto en lugar del archivo global |
| —json | boolean | Imprime como JSON el Key ID / Issuer ID / ruta .p8 capturados |
🔹 Guardar
Sección titulada “ 🔹 Save”npx @capgo/cli@latest build credentials saveGuarda las credenciales de build localmente para iOS o Android. Las credenciales se almacenan en:
- ~/.capgo-credentials/credentials.json (por defecto, global)
- .capgo-credentials.json en la raíz del proyecto (con el flag —local)
⚠️ REQUISITO ANTES DEL BUILD: Debes guardar las credenciales antes de solicitar un build.
🔒 Estas credenciales NUNCA se almacenan permanentemente en los servidores de Capgo.
Se eliminan inmediatamente al finalizar el build.
📚 Guías de configuración:
iOS: https://capgo.app/docs/cli/cloud-build/ios/
Android: https://capgo.app/docs/cli/cloud-build/android/
npx @capgo/cli build credentials save —platform ios
—certificate ./cert.p12 —p12-password “password”
—ios-provisioning-profile ./profile.mobileprovision
—apple-key ./AuthKey.p8 —apple-key-id “KEY123”
—apple-issuer-id “issuer-uuid” —apple-team-id “team-id” Ejemplo multi-target (app + widget extension): npx @capgo/cli build credentials save —platform ios
—ios-provisioning-profile ./App.mobileprovision
—ios-provisioning-profile com.example.widget=./Widget.mobileprovision
… npx @capgo/cli build credentials save —plataforma android
—keystore ./release.keystore —keystore-alias “my-key”
—keystore-key-password “key-pass”
—play-config ./service-account.json Almacenamiento local (por proyecto): npx @capgo/cli build credentials save —local —platform ios …
Ejemplo:
iOS Example:Opciones:
| Parámetro | Tipo | Descripción |
|---|---|---|
| —appId | string | App ID (ej. com.example.app) (obligatorio) |
| —platform | string | Plataforma: ios o android (obligatorio) |
| —certificate | string | iOS: Ruta al archivo de certificado .p12 |
| —ios-provisioning-profile | string | iOS: Ruta del provisioning profile o bundleId=path (repetible) |
| —p12-password | string | iOS: Contraseña del certificado (opcional si no tiene contraseña) |
| —apple-key | string | iOS: Ruta de la clave API .p8 de App Store Connect |
| —apple-key-id | string | iOS: Key ID de API de App Store Connect |
| —apple-issuer-id | string | iOS: Issuer ID de App Store Connect |
| —apple-team-id | string | iOS: Team ID de App Store Connect |
| —ios-distribution | string | iOS: Modo de distribución |
| —apple-id | string | iOS: email de Apple ID para subir app-specific passwords (alternativa a la clave API de App Store Connect) |
| —apple-app-specific-password | string | iOS: app-specific password (xxxx-xxxx-xxxx-xxxx) para subir a TestFlight |
| —apple-app-id | string | iOS: ID numérico de la app en App Store Connect (requerido junto con —apple-id y —apple-app-specific-password) |
| —keystore | string | Android: Ruta al archivo keystore (.keystore o .jks) |
| —keystore-alias | string | Android: Alias de la clave Keystore |
| —keystore-key-password | string | Android: Contraseña de la clave Keystore |
| —keystore-store-password | string | Android: Contraseña del almacén Keystore |
| —play-config | string | Android: Ruta al JSON de la cuenta de servicio de Play Store |
| —android-flavor | string | Android: Product flavor para el build (p. ej. production). Obligatorio si tu proyecto tiene varios flavors. |
| —in-app-update-priority | string | Android: Prioridad de actualización in-app de Google Play para futuros lanzamientos (entero 0–5; mayor = más urgente). Omítelo para no modificar el valor actual de Play. |
| —local | boolean | Guardar en .capgo-credentials.json en la raíz del proyecto en lugar de la global ~/.capgo-credentials/ |
| —output-upload | boolean | Sube los archivos de build (IPA/APK/AAB) al storage de Capgo e imprime los links de descarga |
| —no-output-upload | boolean | No subas los archivos de build (IPA/APK/AAB) al storage de Capgo |
| —output-retention | string | TTL del link de salida: 1h a 7d (por defecto: 1h). Ejemplos: 1h, 6h, 2d |
| —skip-build-number-bump | boolean | Omitir el incremento automático del número de versión/build de code en futuros builds |
| —no-skip-build-number-bump | boolean | Reactiva el incremento automático del número de build (comportamiento por defecto) |
| —skip-marketing-version-bump | boolean | Omitir el aumento automático de la versión de marketing en futuros builds cuando la app ya esté publicada |
| —no-skip-marketing-version-bump | boolean | Reactivar el incremento automático de la versión de marketing (predeterminado) |
📋 Listar
Sección titulada “ 📋 Lista”npx @capgo/cli@latest build credentials listLista las credenciales de build guardadas (contraseñas enmascaradas). Muestra qué credenciales hay guardadas actualmente (tanto globales como locales). Ejemplos: npx @capgo/cli build credentials list # Listar todas las apps npx @capgo/cli build credentials list —appId com.example.app # Listar app concreta
Opciones:
| Parámetro | Tipo | Descripción |
|---|---|---|
| —appId | string | App ID para listar (opcional, lista todos si se omite) |
| —local | boolean | Lista credenciales solo desde el archivo local .capgo-credentials.json |
🔹 Clear
Sección titulada “ 🔹 Clear”npx @capgo/cli@latest build credentials clearBorra las credenciales de build guardadas. Elimina las credenciales del almacenamiento. Usa —appId y —platform para apuntar a credenciales específicas. Ejemplos: npx @capgo/cli build credentials clear # Borrar todas las apps (global) npx @capgo/cli build credentials clear —local # Borrar credenciales locales npx @capgo/cli build credentials clear —appId com.example.app —platform ios
Opciones:
| Parámetro | Tipo | Descripción |
|---|---|---|
| —appId | string | App ID a limpiar (opcional, limpia todas las apps si se omite) |
| —platform | string | Plataforma a limpiar: ios o android (opcional, limpia todas las plataformas si se omite) |
| —local | boolean | Limpiar desde el archivo local .capgo-credentials.json en vez del global |
🔹 Actualizar
Sección titulada “ 🔹 Update”npx @capgo/cli@latest build credentials updateActualiza credenciales específicas sin tener que volver a proporcionarlas todas. Actualiza las credenciales existentes indicando solo los campos que quieras cambiar. La plataforma se detecta automáticamente según las opciones que proporciones. Ejemplos: npx @capgo/cli build credentials update —ios-provisioning-profile ./new-profile.mobileprovision npx @capgo/cli build credentials update —local —keystore ./new-keystore.jks
Opciones:
| Parámetro | Tipo | Descripción |
|---|---|---|
| —appId | string | App ID (se detecta automáticamente desde capacitor.config si se omite) |
| —platform | string | Plataforma: ios o android (autodetectada desde las opciones) |
| —local | boolean | Actualiza el archivo local .capgo-credentials.json en vez del global |
| —certificate | string | Ruta al archivo del certificado P12 |
| —ios-provisioning-profile | string | Ruta del provisioning profile o bundleId=path (repetible, aditivo por defecto) |
| —overwrite-ios-provisioning-map | boolean | Reemplaza todo el mapa de provisioning en lugar de fusionarlo (por defecto: merge) |
| —p12-password | string | Contraseña del certificado P12 |
| —apple-key | string | Ruta de la clave API de App Store Connect (archivo .p8) |
| —apple-key-id | string | Key ID de API de App Store Connect |
| —apple-issuer-id | string | ID de emisor de App Store Connect |
| —apple-team-id | string | Team ID de App Store Connect |
| —apple-id | string | iOS: email de Apple ID para subir app-specific passwords (alternativa a la clave API de App Store Connect) |
| —apple-app-specific-password | string | iOS: app-specific password (xxxx-xxxx-xxxx-xxxx) para subir a TestFlight |
| —apple-app-id | string | iOS: ID numérico de la app en App Store Connect (requerido junto con —apple-id y —apple-app-specific-password) |
| —ios-distribution | string | iOS: Modo de distribución |
| —keystore | string | Ruta al archivo keystore (.keystore o .jks) |
| —keystore-alias | string | Alias de la clave Keystore |
| —keystore-key-password | string | Contraseña de la clave del keystore |
| —keystore-store-password | string | Contraseña del almacén Keystore |
| —play-config | string | Ruta al JSON de la cuenta de servicio de Google Play |
| —android-flavor | string | Android: Product flavor para el build (p. ej. production). Obligatorio si tu proyecto tiene varios flavors. |
| —in-app-update-priority | string | Android: Prioridad de in-app update de Google Play para futuros releases (entero 0–5; mayor = más urgente). |
| —output-upload | boolean | Sube los archivos de build (IPA/APK/AAB) al storage de Capgo e imprime los links de descarga |
| —no-output-upload | boolean | No subas los archivos de build (IPA/APK/AAB) al storage de Capgo |
| —output-retention | string | TTL del enlace de salida: 1h a 7d. Ejemplos: 1h, 6h, 2d |
| —skip-build-number-bump | boolean | Omitir el incremento automático del número de versión/build de code en futuros builds |
| —no-skip-build-number-bump | boolean | Reactiva el incremento automático del número de build (comportamiento por defecto) |
| —skip-marketing-version-bump | boolean | Omitir el aumento automático de la versión de marketing en futuros builds cuando la app ya esté publicada |
| —no-skip-marketing-version-bump | boolean | Reactivar el incremento automático de la versión de marketing (predeterminado) |
🔹 Gestionar
Sección titulada “ 🔹 Gestionar”npx @capgo/cli@latest build credentials manageGestiona de forma interactiva las credenciales de build guardadas.
Explora credenciales, revisa la configuración, exporta un archivo .env listo para CI/CD
o elimina las credenciales de una plataforma. Usa la misma TUI que capgo init.
Ejemplos:
npx @capgo/cli build credentials manage
npx @capgo/cli build credentials manage —appId com.example.app
npx @capgo/cli build credentials manage —appId com.example.app —platform ios
npx @capgo/cli build credentials manage —local
Opciones:
| Parámetro | Tipo | Descripción |
|---|---|---|
| —appId | string | App ID a gestionar (opcional, pregunta cuál elegir si se omite) |
| —platform | string | Plataforma a gestionar: ios o android (opcional, pregunta cuál elegir si se omite) |
| —local | boolean | Solo busca el archivo local .capgo-credentials.json |
🔹 Migrate
Sección titulada “ 🔹 Migrate”npx @capgo/cli@latest build credentials migrateMigra el provisioning profile antiguo al nuevo formato multi-target. Convierte BUILD_PROVISION_PROFILE_BASE64 en CAPGO_IOS_PROVISIONING_MAP. Detecta automáticamente el bundle ID principal de tu proyecto Xcode. npx @capgo/cli build credentials migrate —platform ios
Ejemplo:
Example:Opciones:
| Parámetro | Tipo | Descripción |
|---|---|---|
| —appId | string | App ID (se detecta automáticamente desde capacitor.config si se omite) |
| —platform | string | Plataforma (solo se admite ios) |
| —local | boolean | Migra desde el archivo local .capgo-credentials.json en lugar del global |