🔹 construir
Copia un prompt de configuración con los pasos de instalación y la guía de markdown completa para este plugin.
🏗️ Administra construcciones nativas de iOS/Android a través de Capgo Cloud.
Acceso y salida de construcción
Sección titulada “Acceso y salida de construcción”Las construcciones en la nube nativas están disponibles en cada Capgo plan. Las credenciales de construcción nunca se almacenan en los servidores de Capgo: se utilizan solo para la construcción y luego se eliminan. Los resultados de la construcción se pueden cargar opcionalmente con enlaces de descarga con límite de tiempo.
Guardar credenciales primero
Sección titulada “Guardar credenciales primero”npx @capgo/cli build credentials save --appId YOUR_APP_ID --platform iosnpx @capgo/cli build credentials save --appId YOUR_APP_ID --platform androidCapturar una URL de salida en CI
Sección titulada “Capturar una URL de salida en CI”Pasarlo --output-record para persistir la URL de descarga y el código QR code, luego utilice 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🧭 Imprimir “sí” y salir con code 1 si se requiere una compilación nativa; de lo contrario, imprimir “no” y salir con code 0. Las fallas de comando salen con code 2.
Ejemplo:
npx @capgo/cli@latest build needed com.example.app --channel production --verboseOpciones:
| Param | Tipo | Descripción |
|---|---|---|
| -a | string | API clave para vincular a tu cuenta |
| -c | string | Canales para comparar. Por defecto, utiliza CapacitorUpdater.defaultChannel o el canal público por defecto |
| —package-json | string | Rutas a archivos package.json para repositorios monolíticos (separados por comas) |
| —node-modules | string | Rutas a directorios node_modules para repositorios monolíticos (separados por comas) |
| —verbose | boolean | Habilite la salida detallada con registros |
| —supa-host | string | URL de host de Supabase personalizado (para autohospedaje o desarrollo Capgo) |
| —supa-anon | string | Clave de anonimo de Supabase personalizada (para autohospedaje) |
Alias: onboarding
npx @capgo/cli@latest build initConfigura credenciales de compilación de manera interactiva (iOS: certificados + perfiles automatizados; Android: keystore + Google OAuth provee cuenta de servicio de GCP y convierte a invitado de la consola de Play)
Opciones:
| Param | Tipo | Descripción |
|---|---|---|
| -a | string | API clave para vincular a tu cuenta |
| -p | string | Plataforma para incorporar (ios o android). Si se omite, auto-detecta cuando solo existe un carpeta nativa; solicita en caso contrario. |
| —supa-host | string | URL de host de Supabase personalizado (para auto-hospedaje o Capgo desarrollo) |
| —no-analytics | boolean | Deshabilitar análisis de onboarding de compilación y reproducción de terminal para esta ejecución |
🔹 Solicitud
Sección titulada “ 🔹 Solicitud”npx @capgo/cli@latest build requestRealiza una solicitud de compilación nativa desde Capgo Cloud. Esta orden comprimirá tu directorio de proyecto y lo subirá a Capgo para su compilación. La compilación se procesará y se enviará directamente a las tiendas de aplicaciones. Las credenciales nunca se almacenan en los servidores de Capgo; se eliminan después de la compilación. Guardalas antes de solicitar una compilación:
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 |
|---|---|---|
| —ruta | string | Ruta al directorio del proyecto para compilar (predeterminado: directorio actual) |
| —módulos-nodo | string | Rutas a directorios de node_modules para monorepos (separadas por comas) |
| —plataforma | string | Plataforma objetivo: ios o android (obligatorio) |
| —modo-compilar | string | Modo de compilación: depuración o liberación (por defecto: liberación) |
| —certificado-compilar-base64 | string | iOS: Certificado base64 codificado (.p12) |
| ---contraseña-p12 | string | iOS: Contraseña de certificado (opcional si el certificado no tiene contraseña) |
| ---apple-id | string | iOS: correo electrónico de Apple ID para subir contraseñas de aplicación (alternativa a la clave API de App Store Connect) |
| —apple-app-specific-password | string | iOS: contraseña de aplicación (xxxx-xxxx-xxxx-xxxx) para subir a TestFlight |
| ---apple-app-id | string | iOS: Identificador numérico de la aplicación de App Store Connect (requerido junto con —apple-id y —apple-app-specific-password) |
| ---apple-key-id | string | iOS: App Store Connect API ID de clave |
| ---apple-issuer-id | string | iOS: Identificador del emisor de App Store Connect |
| —apple-key-content | string | iOS: Base64-encoded App Store Connect API key (.p8) |
| —app-store-connect-team-id | string | iOS: Identificador de equipo de App Store Connect |
| —ios-scheme | string | iOS: Esquema de Xcode para compilar (por defecto: App) |
| —ios-target | string | iOS: objetivo Xcode para leer configuraciones de compilación (predeterminado: mismo que esquema) |
| —ios-distribution | string | iOS: Modo de distribución |
| —ios-provisioning-profile | string | iOS: Ruta del perfil de configuración o bundleId=mapping de path (repetible) |
| —archivo-keystore-android | string | Android: archivo de keystore Base64 codificado |
| —alias-clave-keystore | string | Android: alias de clave de keystore |
| —contraseña-clave-keystore | string | Android: contraseña de clave de keystore |
| —contraseña-almacenamiento-keystore | string | Android: contraseña de almacenamiento de keystore |
| —configuración-play-json | string | Android: archivo JSON de servicio de Google Play Base64 codificado |
| —sabor-android | string | Android: sabor de producto para compilar (por ejemplo, producción). Requerido si su proyecto tiene varios sabores. |
| ---android-track | string | Android: Pista de Google Play para esta carga (interna, alpha, beta, producción). Por defecto sin —submit-to-store-review: interna. Con —submit-to-store-review y sin pista configurada: producción. Precedencia: CLI > entorno > credenciales guardadas |
| ---android-release-status | string | Android: Estado de publicación de Google Play (borrador, completado, enProceso, suspendido). Por defecto sin —submit-to-store-review: borrador. Con —submit-to-store-review y sin estado configurado: completado. Precedencia: CLI > entorno > credenciales guardadas |
| ---in-app-update-priority | string | Prioridad de actualización en aplicación para Android (entero 0–5; mayor = más urgente). Consulte https://developer.android.com/guide/playcore/in-app-updates. Precedencia: CLI > entorno > credenciales guardadas |
| ---no-playstore-upload | boolean | Saltar subida a Play Store para esta compilación (anula la configuración de Play Store guardada). Requiere —output-upload. |
| ---submit-to-store-review | boolean | Después de cargar, enviar la versión de la tienda para revisión en lugar de dejarla como un borrador/compilación inactiva. En Android, esto se configura por defecto en la pista de producción con el estado de publicación completado (sobreescribir con —android-track / PLAY_STORE_TRACK y —android-release-status / PLAY_STORE_RELEASE_STATUS). En iOS, se envía la compilación procesada de TestFlight para revisión en la tienda de App Store. |
| —store-release-name | string | Nombre de lanzamiento de la tienda/versión. Android envía esto como el nombre de la versión de Google Play; iOS lo utiliza como la versión de la App Store cuando se crea o se reutiliza la versión editable. |
| —store-release-notes | string | Default store release notes. Android uses this as the Play changelog; iOS uses it as the fallback App Store What’s New text. |
| —store-release-notes-locale | string | Nota de lanzamiento de tienda localizada (repetible), por ejemplo —store-release-notes-locale es-ES=“Correcciones de errores” |
| ---grupos-de-pruebas-de-ios | string | iOS: nombres o IDs de grupo de prueba externo separados por comas, opcionales, para distribución beta externa. |
| ---lanzamiento-automatico-de-ios | boolean | iOS: lanzar automáticamente la versión de la App Store después de la aprobación de Apple. Por defecto, el lanzamiento es manual. |
| ---no-lanzamiento-automatico-de-ios | boolean | iOS: mantener la versión de la App Store esperando un lanzamiento manual después de la aprobación de Apple. |
| ---subir-archivo | boolean | Superar el comportamiento de subida de salida para esta compilación solo (habilitar). Precedencia: CLI > entorno > credenciales guardadas |
| ---sin-subir-archivo | boolean | Superar el comportamiento de subida de salida para esta compilación solo (desactivar). Precedencia: CLI > entorno > credenciales guardadas |
| ---retención-de-archivo | string | Superar el TTL de enlace de salida para esta compilación solo (1h a 7d). Ejemplos: 1h, 6h, 2d. Precedencia: CLI > entorno > credenciales guardadas |
| ---grabar-registro | string | Después de una compilación exitosa, escriba un registro JSON (id de trabajo, estado, URL de salida, código QR Ascii, ruta de archivo PNG de código QR, fecha de finalización) a un camino. Un archivo PNG de código QR code también se escribe junto a ese camino con la .qr.png suffix. Leer los campos de vuelta con build last-output. |
| —no-cache | boolean | Saltar restauración de caché de compilación and No guarde una nueva entrada de caché para esta compilación. La caché de compilación está habilitada por defecto por aplicación. |
| —clave-de-caché | string | Divida la caché de compilación por entorno, rama o sabor de Android (por ejemplo) prod, stagingOmitir para una caché compartida por defecto por aplicación. |
| —no-saltar-número-de-compilación-bump | boolean | Sobreescribir credenciales guardadas para reactivar el incremento automático del número de compilación para esta compilación solo. |
| —saltar-bump-de-versión-de-mercadeo | boolean | Evita el aumento automático de la versión de marketing (CFBundleShortVersionString / versionName) si la aplicación ya está lanzada. |
| —sync-ios-version | boolean | iOS: sincronice MARKETING_VERSION de Xcode desde package.json antes de subir el proyecto. |
| —ai-analytics | boolean | Al fallar la compilación, envíe registros a Capgo AI para el diagnóstico. En terminales interactivos, esto salta la confirmación previa; en CI, se sube automáticamente y se imprime el análisis en stderr. |
| —no-prescan | boolean | Saltarse la escaneo automático de pre-compilación |
| —prescan-ignore-fatal | boolean | Ejecutar el escaneo previo al build pero nunca bloquear el build (solo informar) |
| —prescan-skip | string | Saltar la verificación específica de escaneo por id (repetible o separado por comas). Las otras verificaciones aún se ejecutan. |
| —prescan-warn | string | Baja la verificación de prescan específica a advertencia por id (repetible o separado por comas). La verificación sigue ejecutándose. |
| —fail-on-warnings | boolean | Tratar las advertencias de escaneo como fatales |
| —send-logs-to-support | boolean | Al fallar una compilación de CI/CD, subir automáticamente los registros de compilación a Capgo soporte (no se requiere correo electrónico). Capgo soporte se notifica y seguirá con un correo electrónico. Aditivo a —ai-analytics. |
| —enviar-registros | boolean | Alias deprecado para —enviar-registros-a-soporte |
| -a | string | API clave para vincular a tu cuenta |
| —supa-host | string | URL de host personalizado de Supabase (para autohospedaje o Capgo desarrollo) |
| —supa-anon | string | Clave anonima personalizada de Supabase (para autohospedaje) |
| —verbose | boolean | Habilita la salida detallada con registros de depuración |
Caché de compilación: Capgo restaura y guarda artefactos nativos compilados (CocoaPods, Gradle y resultados relacionados) por defecto por aplicación. Utiliza --cache-key para mantener separados los cachés de RC y producción; use --no-cache para una compilación limpia de un solo uso. API integraciones pueden pasar cache_key o cache_enabled: false in the build request payload. See Build cache o Troubleshooting: wrong cache restore.
🔹 Sync-ios-version
Sección titulada “ 🔹 Sincronizar-versión-ios”npx @capgo/cli@latest build sync-ios-versionSincronice la versión de MARKETING del Xcode iOS local desde package.json.
Ejemplo:
npx @capgo/cli@latest build sync-ios-version --path .Opciones:
| Parámetro | Tipo | Descripción |
|---|---|---|
| —ruta | string | Ruta al directorio del proyecto (por defecto: directorio actual) |
| —verificar | boolean | Verificar solo; salir con código no cero cuando MARKETING_VERSION no está sincronizado |
🔹 Prescanner
Sección titulada “ 🔹 Prescan”npx @capgo/cli@latest build prescanRevisa tu proyecto y credenciales guardadas para problemas que fallarían una construcción en la nube — antes de subir nada.
Verifica credenciales (vencimiento, contraseñas, pareja de perfil), estado del proyecto (cap sincronización, disposición de node_modules) y configuración de plataforma. Se ejecuta automáticamente dentro de build requestEste comando se ejecuta de forma independiente (por ejemplo, en CI).
Ver Prescan verifica para el catálogo de comprobación completa y cómo --skip / --warn reglas individuales.
Opciones:
| Parámetro | Tipo | Descripción |
|---|---|---|
| —plataforma | string | Plataforma objetivo: ios o android (obligatorio) |
| —ruta | string | Ruta al directorio del proyecto (por defecto: directorio actual) |
| -a | string | API clave para vincular a tu cuenta |
| —flavor-android | string | Android: se utilizará el sabor del producto |
| —dist-ios | string | iOS: modo de distribución para validar contra |
| —json | boolean | Genera un informe JSON legible por máquinas |
| —falla-en-advertencias | boolean | Salir con código no cero cuando se encuentran advertencias (CI) |
| —ignora-fatal | boolean | Modo de diagnóstico: informar todo pero siempre salir con 0 |
| —saltar | string | Saltar una o varias comprobaciones específicas por id (repetibles o separadas por comas) |
| —advertencia | string | Baja la verificación específica a advertencia por id (repetible o separado por comas) |
| —detallado | boolean | Habilitar la salida detallada con registro detallado |
| —supa-host | string | URL de host personalizado de Supabase (para auto-hospedaje o desarrollo Capgo) |
| —supa-anon | string | Clave anónima de Supabase personalizada (para autohospedaje) |
🔹 Último-resultado
Título de la sección “ 🔹 Último-resultado”npx @capgo/cli@latest build last-outputLea el registro de salida de construcción escrito por un resultado anterior build request --output-record.
Muestra el JSON completo por defecto, un campo único con —field, o el código QR
code con —qr. Útil en CI para obtener la URL de descarga o QR para volver a publicar en una PR o problema.
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 | Description |
|---|---|---|
| —ruta | string | Ruta al registro JSON escrito por —output-record (obligatorio) |
| —campo | string | Imprimir un campo único (uno de: jobId, appId, plataforma, modo de compilación, estado, URL de salida, qrCodeAscii, qrCodePngPath, finishedAt, schemaVersion) |
| —qr | boolean | Imprimir el código QR ASCII renderizado code (atajo para —campo qrCodeAscii) |
🔹 Creditenciales
Sección titulada “ 🔹 Creditenciales”Gestiona las credenciales de compilación almacenadas localmente en tu máquina. 🔒 SEGURIDAD:
- Las credenciales se guardan en ~/.capgo-credentials/credentials.json (global) o .capgo-credentials.json (local)
- Al compilar, se envían a Capgo pero NUNCA se almacenan permanentemente
- Se eliminan de Capgo inmediatamente después de la compilación
- Salidas de compilación pueden ser cargadas opcionalmente para enlaces de descarga a tiempo limitado https://capgo.app/docs/cli/nube-compilar/ios/ Configuración de Android: https://capgo.app/docs/cli/nube-compilar/android/
🔹 Apple-key
Título de sección “ 🔹 Apple-key”Alias: asc-key
npx @capgo/cli@latest build credentials apple-keyCrear una clave de equipo de App Store Connect API con una asistente de macOS guiado (solo macOS). Abre una ventana nativa que te guía a través de la interfaz de usuario de Apple App Store Connect en un navegador incorporado, captura automáticamente el ID de emisor + ID de clave, intercepta el archivo .p8 de una sola vez, lo valida contra Apple y lo guarda en ~/.appstoreconnect/private_keys. Las estadísticas de progreso se envían a Capgo analytics (desactivar con CAPGO_DISABLE_TELEMETRY). npx @capgo/cli build credentials apple-key —appId com.example.app
Ejemplo:
Example:Opciones:
| Param | Tipo | Descripción |
|---|---|---|
| -a | string | API clave para vincular a tu cuenta |
| —appId | string | Guardar la clave capturada en las credenciales de compilación de la aplicación iOS |
| —local | boolean | Guardar en el archivo .capgo-credentials.json del proyecto en lugar del archivo global |
| —json | boolean | Imprimir la clave ID / ID de emisor / ruta de .p8 capturada como JSON |
🔹 Guardar
Sección titulada “ 🔹 Guardar”npx @capgo/cli@latest build credentials saveGuardar credenciales de compilación 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 la bandera —local)
⚠️ REQUERIDO ANTES DE COMPILAR: Debe guardar credenciales antes de solicitar una compilación.
🔒 Estas credenciales nunca se almacenan en los servidores Capgo permanentemente.
Se eliminan inmediatamente después de que se complete la compilación.
📚 Guías de configuración:
- iOS: https://capgo.app/docs/cli/build-nube/ios/
- Android: https://capgo.app/docs/cli/nube-construcción/android/
npx @capgo/cli build credentials save —plataforma ios
–certificado ./cert.p12 –contraseña-p12 “contraseña”
–perfil-de-provisión-ios ./profile.mobileprovision
–clave-Apple ./AuthKey.p8 –clave-Apple-id “KEY123”
–id-de-emisor-Apple “issuer-uuid” –id-de-equipo-Apple “team-id” Ejemplo de múltiples objetivos (aplicación + extensión de widget): npx @capgo/cli build credentials save –plataforma ios
–perfil-de-provisión-ios ./App.mobileprovision
–perfil-de-provisión-ios com.example.widget=./Widget.mobileprovision
… npx @capgo/cli build credentials save –plataforma android
—keystore ./release.keystore —keystore-alias “mi-clave”
–contraseña-de-llave-keystore “key-pass”
–configuración-de-juego ./service-account.json Almacenamiento local (por proyecto): npx @capgo/cli build credentials save –local –plataforma ios …
Ejemplo:
iOS Example:Opciones:
| Param | Tipo | Descripción |
|---|---|---|
| —appId | string | App ID (e.g., com.example.app) (required) |
| —plataforma | string | Plataforma: ios o android (obligatorio) |
| —certificado | string | iOS: Ruta al archivo de certificado .p12 |
| —perfil de provisión de ios | string | iOS: Ruta de perfil de configuración o bundleId=ruta (repetible) |
| —p12-password | string | iOS: Contraseña de certificado (opcional si el certificado no tiene contraseña) |
| —apple-key | string | iOS: Ruta al .p8 clave de App Store Connect API |
| —apple-key-id | string | iOS: ID de clave de App Store Connect API |
| —apple-issuer-id | string | iOS: ID de emisor de App Store Connect |
| —apple-team-id | string | iOS: ID de equipo de App Store Connect |
| —ios-distribution | string | iOS: Modo de distribución |
| —apple-id | string | iOS: Correo electrónico de Apple ID para subir contraseñas de aplicación (alternativa a la clave de App Store Connect API) |
| —apple-app-specific-password | string | iOS: Contraseña de aplicación (xxxx-xxxx-xxxx-xxxx) para subir a TestFlight |
| —apple-app-id | string | iOS: Identificador numérico de aplicación de App Store Connect (requerido junto con —apple-id y —apple-app-specific-password) |
| —keystore | string | Android: Ruta del archivo de keystore (.keystore o .jks) |
| —keystore-alias | string | Android: Alias de la clave de 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 | string | Android: Ruta a la cuenta de servicio de Play Store JSON |
| —sabor-android | string | Android: Sabor de producto para compilar (por ejemplo, producción). Requerido si su proyecto tiene múltiples sabores. |
| —in-app-update-priority | string | Prioridad de actualización en-app de Google Play para futuras versiones (entero 0–5; mayor = más urgente). Omitir para dejar el valor existente de Play sin cambios. |
| —local | boolean | Guardar en .capgo-credentials.json en la raíz del proyecto en lugar de ~/.capgo-credentials global |
| —subir-a-archivo | boolean | Subir salidas de compilación (IPA/APK/AAB) a Capgo almacenamiento y imprimir enlaces de descarga |
| —no-output-upload | boolean | No subir salidas de compilación (IPA/APK/AAB) a Capgo almacenamiento |
| —output-retention | string | Enlace de salida TTL: 1h a 7d (por defecto: 1h). Ejemplos: 1h, 6h, 2d |
| —skip-build-number-bump | boolean | Saltarse el incremento automático del número de compilación/code en futuras compilaciones |
| —no-skip-build-number-bump | boolean | Reactivar el incremento automático del número de compilación (comportamiento predeterminado) |
| —skip-marketing-version-bump | boolean | Saltarse el incremento automático de la versión de marketing en futuras compilaciones cuando la aplicación ya está liberada |
| —no-skip-marketing-version-bump | boolean | Re-enable automatic marketing version bump (default behavior) |
npx @capgo/cli@latest build credentials listLista de credenciales de compilación guardadas (contraseñas ocultas). Muestra qué credenciales están actualmente guardadas (tanto globales como locales). Ejemplos: npx @capgo/cli build credentials list # Lista todas las aplicaciones npx @capgo/cli build credentials list —appId com.example.app # Lista la aplicación específica
Opciones:
| Parámetro | Tipo | context |
|---|---|---|
| —appId | string | ID de la aplicación para listar (opcional, lista todos si se omite) |
| —local | boolean | Listar credenciales locales desde solo .capgo-credentials.json |
🔹 Borrar
Título de la sección “ 🔹 Borrar”npx @capgo/cli@latest build credentials clearBorrar credenciales de construcción guardadas. Eliminar credenciales del almacenamiento. Usar —appId y —platform para dirigir credenciales específicas. Ejemplos: npx @capgo/cli build credentials clear # Borrar todas las aplicaciones (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 | ID de aplicación para borrar (opcional, borra todas las aplicaciones si se omite) |
| —plataforma | string | Plataforma a borrar: ios o android (opcional, borra todas las plataformas si se omite) |
| —local | boolean | Borra desde el archivo local .capgo-credentials.json en lugar del global |
🔹 Actualizar
Sección titulada “ 🔹 Actualizar”npx @capgo/cli@latest build credentials updateActualizar credenciales específicas sin proporcionar todas ellas nuevamente. Actualizar credenciales existentes proporcionando solo los campos que deseas cambiar. La plataforma se detecta automáticamente desde las opciones que proporcionas. 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 | ID de la aplicación (detectado automáticamente de capacitor.config si omitido) |
| —plataforma | string | Plataforma: ios o android (detectada automáticamente de opciones) |
| —local | boolean | Actualizar credenciales locales .capgo-credentials.json en lugar de globales |
| —certificado | string | Ruta al archivo de certificado P12 |
| —ios-provisioning-profile | string | Ruta al perfil de provisión o bundleId=path (repetible, aditivo por defecto) |
| —sobreescribir-mapa-de-provisión-ios | boolean | Sustituye el mapa de provisión completo en lugar de fusionarlo (por defecto: fusionar) |
| —contraseña-p12 | string | Contraseña del certificado P12 |
| —clave-apple | string | Ruta de la clave de App Store Connect API (archivo .p8) |
| —clave-apple-id | string | ID de la clave de App Store Connect API |
| —id-emisor-apple | string | ID del emisor de App Store Connect |
| —id-de-equipo-apple | string | ID del equipo de App Store Connect |
| —apple-id | string | iOS: correo electrónico de Apple ID para subir contraseñas de aplicación (alternativa a la clave API de App Store Connect) |
| —apple-app-specific-password | string | iOS: Contraseña de aplicación específica (xxxx-xxxx-xxxx-xxxx) para subir a TestFlight |
| —apple-app-id | string | iOS: Identificador numérico de aplicación de 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 de keystore (.keystore o .jks) |
| —keystore-alias | string | Alias de la clave de keystore |
| —keystore-key-password | string | Contraseña de la llave de almacenamiento |
| —contraseña-de-almacenamiento | string | Contraseña de almacenamiento |
| —play-config | string | Ruta al archivo JSON de servicio de Google Play |
| —flavor-de-android | string | Android: Sabor de producto para construir (por ejemplo, producción). Requerido si su proyecto tiene varios sabores. |
| —in-app-update-priority | string | Android: Prioridad de actualización en aplicación de Google Play para futuras versiones (entero 0–5; mayor = más urgente). |
| —subir-a-archivo | boolean | Subir salidas de compilación (IPA/APK/AAB) a Capgo almacenamiento y imprimir enlaces de descarga |
| —no-output-upload | boolean | No subir resultados de compilación (IPA/APK/AAB) a almacenamiento Capgo |
| —output-retention | string | TTL de enlace de salida: 1h a 7d. Ejemplos: 1h, 6h, 2d |
| —skip-build-number-bump | boolean | Saltarse el incremento automático del número de compilación/code/ en futuras compilaciones |
| —no-skip-build-number-bump | boolean | Rehabilitar el incremento automático del número de compilación (comportamiento predeterminado) |
| —skip-marketing-version-bump | boolean | Saltarse el incremento automático de la versión de marketing en futuras compilaciones cuando la aplicación ya esté liberada |
| —no-skip-marketing-version-bump | boolean | Re-enable automatic marketing version bump (default behavior) |
🔹 Gestiona
Sección titulada “ 🔹 Gestiona”npx @capgo/cli@latest build credentials manageGestiona interactivamente las credenciales de construcción guardadas.
Navega por las credenciales almacenadas, visualiza qué está configurado, exporta un archivo .env listo para CI/CD, o elimina las credenciales de una plataforma. Reutiliza la misma IU de TUI como 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 | Description |
|---|---|---|
| Descripción | string | —appId del aplicación a gestionar (opcional, solicita elegir si se omite) |
| —plataforma | string | Plataforma a administrar: ios o android (opcional, solicita elegir si se omite) |
| —local | boolean | Solo navega por archivos locales .capgo-credentials.json |
🔹 Migrar
Section titled “ 🔹 Migrate”npx @capgo/cli@latest build credentials migrateMigrate legacy provisioning profile to the new multi-target format. Converts BUILD_PROVISION_PROFILE_BASE64 to CAPGO_IOS_PROVISIONING_MAP. Discovers the main bundle ID from your Xcode project automatically. npx @capgo/cli build credentials migrate —platform ios
Example:
Example:Opciones:
| Param | Tipo | Descripción |
|---|---|---|
| —appId | string | ID de la aplicación (detectado automáticamente desde capacitor.config si omitido) |
| —plataforma | string | Plataforma (solo ios está soportado) |
| —local | boolean | Migrar desde local .capgo-credentials.json en lugar de global |