🔹 Construir
Copia un prompt de configuración con los pasos de instalación y la guía de markdown completa para este plugin.
🏗️ Manage native iOS/Android builds through Capgo Cloud.
Acceso y salida de construcción
Sección titulada “Acceso y salida de construcción”Native cloud build requests are currently in limited beta and access is restricted. Build credentials are never stored on Capgo servers: they are used only for the build and then deleted. Build outputs can optionally be uploaded with time-limited download links.
Guarde las credenciales primero
Sección titulada “Guarde 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 androidCapturar una URL de salida en CI
Sección titulada “Capturar una URL de salida en CI”Para --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 neededImprimir ‘sí’ y salir con code 1 si se requiere una compilación nativa; en caso contrario, imprimir ‘no’ y salir con code 0. Las fallas de comandos salen con code 2.
Ejemplo:
npx @capgo/cli@latest build needed com.example.app --channel production --verboseOpciones:
| Parámetro | Tipo | Descripción |
|---|---|---|
| -a | string | Llave API para vincular a tu cuenta |
| -c | string | Canal para comparar con. Por defecto, CapacitorUpdater.defaultChannel o el canal público por defecto |
| —package-json | string | Rutas a archivos package.json para repositorios monolíticos (separadas por comas) |
| —node-modules | string | Rutas a directorios node_modules para repositorios monolíticos (separadas por comas) |
| —verbose | boolean | Habilitar la salida detallada con registro de depuración |
| —supa-host | string | URL de host personalizado de Supabase (para autohosteo o desarrollo Capgo) |
| —supa-anon | string | Clave anonima personalizada de Supabase (para autohosteo) |
🚀 Iniciar
Sección titulada “ 🚀 Inicio”Alias: onboarding
npx @capgo/cli@latest build initConfigurar credenciales de compilación de manera interactiva (iOS: certificados + perfiles automatizados; Android: keystore + Google OAuth proporciona cuenta de servicio de GCP y convierte a invitado de la consola de Play)
Opciones:
| Parámetro | Tipo | Descripción |
|---|---|---|
| -a | string | Clave API para vincular a tu cuenta |
| -p | string | Plataforma para la onboarding (ios o android). Si se omite, auto-detecta cuando solo existe una carpeta nativa; solicita de lo contrario. |
| —supa-host | string | URL de host personalizado de Supabase (para auto-hosting o desarrollo Capgo) |
| —no-analytics | boolean | Deshabilitar la recopilación de analytics de build y la reproducción del terminal para esta ejecución |
🔹 Solicitud
Sección titulada “ 🔹 Solicitud”npx @capgo/cli@latest build requestSolicitar una compilación nativa desde Capgo Cloud. Esta orden de comando comprimirá el directorio de proyecto y lo subirá a Capgo para la compilación. La compilación se procesará y se enviará directamente a las tiendas de aplicaciones. Las credenciales nunca se almacenan en los servidores Capgo; se eliminan después de la compilación. Guardelas 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 del directorio del proyecto a compilar (por defecto: directorio actual) |
| —módulos-nodo | string | Rutas de los directorios módulos-nodo para repositorios monolíticos (separadas por comas) |
| —plataforma | string | Plataforma objetivo: ios o android (obligatorio) |
| —modo de construcción | string | Modo de construcción: depuración o liberación (por defecto: liberación) |
| —base64-certificado-de-construcción | string | iOS: Certificado Base64 codificado .p12 |
| —contraseña-de-p12 | string | iOS: Contraseña del certificado (opcional si el certificado no tiene contraseña) |
| —correo-de-id-de-la-manzana | string | iOS: Correo electrónico de Apple ID para subir contraseñas de aplicación específicas (alternativa a la clave de App Store Connect API) |
| —contraseña-de-aplicación-específica-de-la-manzana | string | iOS: Contraseña de aplicación específica (xxxx-xxxx-xxxx-xxxx) para subir a TestFlight |
| —id-de-aplicación-de-la-manzana | 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: Identificador de clave de App Store Connect API |
| —apple-issuer-id | string | iOS: Identificador de 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 del equipo de App Store Connect |
| —ios-scheme | string | iOS: Esquema de Xcode para compilar (por defecto: App) |
| —ios-target | string | iOS: Xcode target para leer configuraciones de compilación (predeterminado: mismo que el esquema) |
| —ios-distribución | string | iOS: Modo de distribución |
| —perfil-de-provisión-ios | string | iOS: Ruta del perfil de provisión o bundleId=mapping de path (repetible) |
| —archivo-de-keystore-android | string | Android: Archivo de keystore codificado en Base64 |
| —alias-de-clave-del-keystore | string | Android: Alias de clave del keystore |
| —contraseña-de-clave-del-keystore | string | Android: Contraseña de clave del keystore |
| —contraseña-del-almacenamiento-del-keystore | string | Android: Contraseña del almacén de claves |
| —play-config-json | string | Android: Cuenta de servicios de Google Play codificada en Base64 |
| —android-flavor | string | Android: Sabor del producto para construir (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 establecida: 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 establecido: completado. Precedencia: CLI > entorno > credenciales guardadas |
| —in-app-update-priority | string | Android: Prioridad de actualización en aplicación para esta versión (entero 0–5; mayor = más urgente). Consulte https://developer.android.com/guide/playcore/in-app-updates. Precedencia: CLI > entorno > credenciales guardadas |
| —no-subir-a-play-store | boolean | Saltar la subida a Play Store para esta compilación (anula la configuración de Play guardada). Requiere —output-upload. |
| —presentar-en-revisión-de-la-tienda | boolean | Después de la subida, presenta la versión de la tienda para la revisión en lugar de dejarla como un borrador/compilación inactiva. En Android, esto se establece por defecto en el track de producción con el estado de liberació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 a la revisión de la App Store. |
| —nombre-de-la-versión-de-la-tienda | string | Etiqueta de versión 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. |
| —notas-de-la-versión-de-la-tienda | string | Notas de la versión de la tienda por defecto. Android utiliza esto como el changelog de Play; iOS lo utiliza como el texto de '¿Qué hay de nuevo?' de la App Store por defecto. |
| —notas-de-la-versión-de-la-tienda-locale | string | Notas de la versión de la tienda localizadas (repetibles), por ejemplo —store-release-notes-locale es-US=“Correcciones” —store-release-notes-locale fr-FR=“Correcciones”. |
| —grupos-de-pruebas-de-ios-testflight | string | iOS: nombres o IDs de grupo de TestFlight separados por comas, opcionales, para distribución de beta externa. |
| —ios-automatic-release | boolean | iOS: liberar automáticamente la versión de App Store después de la aprobación de Apple. Por defecto, la liberación es manual. |
| —no-ios-automatic-release | boolean | iOS: mantener la versión de App Store esperando la liberación manual después de la aprobación de Apple. |
| —output-upload | boolean | Sobreescribir el comportamiento de carga de salida para esta compilación solo (activar). Precedencia: CLI > entorno > credenciales guardadas |
| —no-output-upload | boolean | Sobreescribir el comportamiento de carga de salida para esta compilación solo (desactivar). Precedencia: CLI > entorno > credenciales guardadas |
| —output-retention | string | Sobreescribir el TTL de enlace de salida para esta compilación solo (1h a 7d). Ejemplos: 1h, 6h, 2d. Precedencia: CLI > entorno > credenciales guardadas |
| —output-record | string | After un build exitoso, escriba un registro JSON (jobId, estado, outputUrl, qrCodeAscii, qrCodePngPath, finishedAt) a un camino. Un PNG QR code también se escribe junto a ese camino con el .qr.png Lee campos de vuelta con build last-output. |
| No pase por el número de build incrementado | boolean | Sobreescriba credenciales guardadas para reactivar el incremento automático del número de build para este build solo. |
| No pase por el incremento de la versión de marketing (CFBundleShortVersionString / versionName) cuando la aplicación ya está liberada. | boolean | Sincronice la versión de iOS |
| Sincronice la versión de Xcode MARKETING_VERSION desde package.json antes de subir el proyecto. | boolean | Envíe logs a __CAPGO_KEEP_0__ AI para diagnóstico en caso de falla de build. En terminales interactivos, esto salta la confirmación previa; en CI, sube automáticamente y imprime el análisis en stderr. |
| No escanee automáticamente antes de construir | boolean | On build failure, send logs to Capgo AI for diagnosis. In interactive terminals this skips the upfront confirmation; in CI this auto-uploads and prints the analysis to stderr. |
| Skip the automatic pre-build scan | boolean | Skip the automatic pre-build scan |
| ---ignorar-fatal | boolean | Ejecutar la escaneo previo al build pero nunca bloquear el build (solo informar) |
| ---saltarse | string | Saltarse una o varias comprobaciones de escaneo previo por id (repetibles o separados por comas). Las demás comprobaciones aún se ejecutan. |
| ---advertir | string | Descender una o varias comprobaciones de escaneo previo a advertencia por id (repetibles o separados por comas). La comprobación aún se ejecuta. |
| ---fallar-en-advertencias | boolean | Considerar las advertencias de escaneo previo como fatales |
| ---enviar-registros-a-soporte | boolean | En un fallo de build de CI/CD, subir automáticamente los registros del build a Capgo soporte (no se requiere correo electrónico). Capgo soporte se notifica y seguirá con un correo electrónico. Aditivo a —ai-análisis. |
| ---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 auto-hospedaje o Capgo desarrollo) |
| —supa-anon | string | Clave anonima personalizada de Supabase (para auto-hospedaje) |
| —verbose | boolean | Habilitar salida detallada con registro de depuración |
🔹 Versión de sincronización de iOS
Ventana de terminalnpx @capgo/cli@latest build sync-ios-versionSincronice la versión de 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 | Sólo verificar; salir con código no cero cuando la versión de MARKETING_VERSION no está sincronizada |
🔹 Preescaneo
Sección titulada “ 🔹 Preescaneo”npx @capgo/cli@latest build prescanEscanea tu proyecto y credenciales guardadas para problemas que fallarían un build 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 request; este comando lo ejecuta de forma independiente (por ejemplo, en CI).
Ver Preescaneo verifica para obtener el catálogo de verificación completo 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) |
| __CAPGO_KEEP_0__ clave para vincular a tu cuenta | string | API key to link to your account |
| Android: sabor del producto que se utilizará para la compilación | string | —modo-distribución-ios |
| iOS: modo de distribución para validar contra | string | —json |
| —json | boolean | Genera un informe JSON legible por máquinas |
| __CAPGO_KEEP_0__ | boolean | Salir con un código no cero cuando se encuentran advertencias (CI) |
| __CAPGO_KEEP_0__ | boolean | Modo de diagnóstico: informar todo pero siempre salir con 0 |
| __CAPGO_KEEP_0__ | string | Saltar una o varias comprobaciones específicas por id (repetibles o separadas por comas) |
| __CAPGO_KEEP_0__ | string | Descender una o varias comprobaciones específicas a advertencia por id (repetibles o separadas por comas) |
| __CAPGO_KEEP_0__ | boolean | Habilitar la salida detallada con registro de depuración |
| __CAPGO_KEEP_0__ | string | URL de host personalizado de Supabase (para auto-hospedaje o desarrollo Capgo) |
| —supa-anon | string | Clave anonima personalizada de Supabase (para auto-hospedaje) |
🔹 Último registro de salida
Sección titulada “ 🔹 Último registro de salida”npx @capgo/cli@latest build last-outputLea el registro de salida de la construcción escrito por un registro anterior build request --output-record.
Muestra el JSON completo por defecto, un campo único con —field, o el código QR ASCII
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 | Descripción |
|---|---|---|
| —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) |
🔹 Creditencia
Sección titulada “ 🔹 Creditencia”Gestionar las credenciales de compilación almacenadas localmente en tu máquina. 🔒 SEGURIDAD:
- Las credenciales guardadas en ~/.capgo-credentials/credentials.json (global) o .capgo-credentials.json (local)
- Al compilar, se envían a Capgo pero NUNCA se almacenan permanentemente
- Eliminado de Capgo inmediatamente después de la compilación
- Los resultados de la compilación pueden subirse opcionalmente para obtener enlaces de descarga temporal 📚 DOCUMENTACIÓN: iOS configuración: 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 la 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 ayuda guiada de macOS (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, 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:
| Parametro | 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 iOS de esta aplicación |
| —local | boolean | Guardar en el archivo .capgo-credentials.json del proyecto en lugar del archivo global |
| ---json | boolean | Imprimir la clave de ID de captura / ID de emisor / ruta de archivo .p8 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 de 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/cloud-build/ios/
Android: https://capgo.app/docs/cli/cloud-build/android/
npx @capgo/cli build credenciales guardar —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”
—identificador-de-emisor-apple “issuer-uuid” —identificador-de-equipo-apple “team-id” Ejemplo de múltiples objetivos (aplicación + extensión de widget): npx @capgo/cli build credenciales guardar —plataforma ios
—perfil-de-provisión-ios ./App.mobileprovision
—perfil-de-provisión-ios com.example.widget=./Widget.mobileprovision
… npx @capgo/cli build credenciales guardar —plataforma android
—almacenamiento-keystore ./release.keystore —alias-keystore “my-key”
—contraseña-keystore “key-pass”
—configuración-de-juego ./service-account.json Almacenamiento local (por proyecto): npx @capgo/cli build credenciales guardar —local —plataforma ios …
Ejemplo:
iOS Example:Opciones:
| Param | Tipo | Descripción |
|---|---|---|
| —appId | string | ID de la aplicación (por ejemplo, com.example.app) (obligatorio) |
| —plataforma | string | Plataforma: ios o android (obligatorio) |
| —certificado | string | iOS: Ruta al archivo de certificado .p12 |
| —perfil-de-provisión-ios | string | iOS: Ruta del perfil de provisión o bundleId=path (repetible) |
| —contraseña-p12 | string | iOS: Contraseña del certificado (opcional si el certificado no tiene contraseña) |
| —clave-apple | string | iOS: Ruta al .p8 clave de Apple Store Connect API |
| —clave-identificador-apple | string | iOS: Identificador de clave de Apple Store Connect API |
| —identificador-emisor-apple | string | iOS: Identificador del emisor de Apple Store Connect |
| —identificador-de-equipo-apple | string | iOS: Identificador del equipo de Apple Store Connect |
| ---ios-distribución | string | iOS: Modo de distribución |
| ---correo-de-id-de-apple | string | iOS: Correo electrónico de ID de Apple para subir contraseñas de aplicación específicas (alternativa a la clave de App Store Connect API) |
| ---contraseña-de-aplicación-específica-de-apple | string | iOS: Contraseña de aplicación específica (xxxx-xxxx-xxxx-xxxx) para subir a TestFlight |
| ---id-de-aplicación-de-apple-store | string | iOS: ID numérico de aplicación de App Store Connect (requerido junto con —correo-de-id-de-apple y —contraseña-de-aplicación-específica-de-apple) |
| ---keystore | string | Android: Ruta al archivo de keystore (.keystore o .jks) |
| ---alias-de-keystore | string | Android: Alias de la clave de keystore |
| ---clave-de-llave-de-almacenamiento | string | Android: Contraseña de la clave de almacenamiento del keystore |
| ---contraseña-de-almacenamiento | string | Android: Contraseña de almacenamiento del keystore |
| ---configuración-de-play | string | Android: Ruta al archivo JSON de servicio de cuenta de Play Store |
| ---sabor-de-android | string | Android: Sabor de producto para compilar (por ejemplo, producción). Requerido si su proyecto tiene varios sabores. |
| ---prioridad-de-actualización-en-aplicación | string | Android: Prioridad de actualización en aplicación de Google Play para futuras versiones (entero 0–5; mayor = más urgente). Omite para dejar el valor existente de Play sin cambios. |
| ---local | boolean | Guarda en .capgo-credenciales.json en la raíz del proyecto en lugar de ~/.capgo-credenciales/ |
| ---subir-archivo--- | boolean | Subir salidas de compilación (IPA/APK/AAB) a almacenamiento Capgo y imprimir enlaces de descarga |
| ---no-subir-archivo--- | boolean | No subir salidas de compilación (IPA/APK/AAB) a almacenamiento Capgo |
| ---retencion-de-archivo--- | string | Tiempo de vida de enlace de salida: 1h a 7d (por defecto: 1h). Ejemplos: 1h, 6h, 2d |
| ---saltar-aumento-de-numero-de-compilacion--- | boolean | Saltar el aumento automático del número de compilación/code/ en futuras compilaciones |
| ---no-saltar-aumento-de-numero-de-compilacion--- | boolean | Rehabilitar el aumento automático del número de compilación (comportamiento por defecto) |
| ---saltar-aumento-de-versión-de-marketing--- | boolean | Saltar el aumento automático de la versión de marketing en futuras compilaciones cuando la aplicación ya está liberada |
| ---sin-salto-de-actualización-de-versión-de-marketing | boolean | Rehabilitar la actualización automática de versión de marketing (comportamiento por defecto) |
npx @capgo/cli@latest build credentials listLista de credenciales de construcció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 aplicación específica
Opciones:
| Parámetro | Tipo | Descripción |
|---|---|---|
| —appId | string | ID de la aplicación para listar (opcional, lista todas si se omite) |
| —local | boolean | Listar credenciales desde el archivo local .capgo-credentials.json solo |
🔹 Borrar
Sección titulada “ 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 la aplicación para borrar (opcional, borra todas las aplicaciones si se omite) |
| —platform | string | Plataforma a borrar: ios o android (opcional, borra todas las plataformas si se omite) |
| —local | boolean | Borrar desde el archivo local .capgo-credentials.json en lugar del global |
🔹 Actualizar
Título de la sección “ 🔹 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 se proporcionan. 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 se omite) |
| —plataforma | string | Plataforma: ios o android (detectada automáticamente de opciones) |
| —local | boolean | Actualizar local .capgo-credentials.json en lugar de global |
| —certificado | string | Ruta al archivo de certificado P12 |
| —perfil de provisión de ios | string | Ruta del perfil de configuración o bundleId=path (repetible, aditivo por defecto) |
| —sobreescribir-ios-provisioning-map | boolean | Sustituye el mapa de configuración completo en lugar de fusionarlo (por defecto: fusionar) |
| —p12-password | string | Contraseña del certificado P12 |
| —apple-key | string | Ruta de la clave API de App Store Connect (.p8 archivo) |
| —apple-key-id | string | ID de la clave API de App Store Connect |
| —apple-issuer-id | string | ID del emisor de App Store Connect |
| —apple-team-id | string | ID de equipo de App Store Connect |
| —apple-id | string | Correo electrónico de Apple ID para subir contraseñas de app específicas (alternativa al ID de equipo de App Store Connect API) |
| —apple-app-specific-password | string | Contraseña de app específica (xxxx-xxxx-xxxx-xxxx) para subir a TestFlight |
| —apple-app-id | string | ID numérico de aplicación de App Store Connect (requerido junto con —apple-id y —apple-app-specific-password) |
| —ios-distribution | string | Modo de distribución de iOS |
| —keystore | string | Ruta al archivo de keystore (.keystore o .jks) |
| —keystore-alias | string | Alias de clave del keystore |
| —contraseña-de-clave-del-keystore | string | Contraseña de clave del keystore |
| —contraseña-de-almacenamiento-del-keystore | string | Contraseña de almacenamiento del keystore |
| —configuración-de-play | string | Ruta al archivo JSON de servicio de Google Play |
| —sabor-de-android | string | Android: Sabor de producto para compilar (por ejemplo, producción). Requerido si su proyecto tiene varios sabores. |
| —prioridad-de-actualización-en-aplicación | 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 resultados de compilación (IPA/APK/AAB) a Capgo almacenamiento y imprimir enlaces de descarga |
| No subir resultados de compilación (IPA/APK/AAB) a __CAPGO_KEEP_0__ almacenamiento | boolean | Do not upload build outputs (IPA/APK/AAB) to Capgo storage |
| Saltar el incremento automático del número de compilación/__CAPGO_KEEP_0__ en futuras compilaciones | string | No saltar el incremento automático del número de compilación |
| Saltar el incremento automático de la versión de marketing en futuras compilaciones cuando la aplicación ya esté liberada | boolean | Skip automatic build number/version code incrementing on future builds |
| Reactivar el comportamiento por defecto de incremento automático del número de compilación | boolean | Reactivar el comportamiento por defecto de incremento automático de la versión de marketing |
| No subir resultados de compilación (IPA/APK/AAB) a __CAPGO_KEEP_0__ almacenamiento | boolean | No subir resultados de compilación (IPA/APK/AAB) a __CAPGO_KEEP_0__ almacenamiento |
| Opción de retención de enlace de salida: 1h a 7d. Ejemplos: 1h, 6h, 2d | boolean | Rehabilitar la actualización automática de versión de marketing (comportamiento predeterminado) |
🔹 Gestionar
Título de la sección “ 🔹 Gestionar”npx @capgo/cli@latest build credentials manageGestionar interactivamente las credenciales de construcción guardadas.
Navegar por las credenciales almacenadas, ver qué está configurado, exportar un archivo .env listo para CI/CD,úrn eliminar 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 —plataforma ios
npx @capgo/cli build credentials manage —local
Opciones:
| Parámetro | Tipo | Descripción |
|---|---|---|
| —appId | string | ID de la aplicación para gestionar (opcional, solicita elegir si se omite) |
| ---plataforma | string | Plataforma a gestionar: ios o android (opcional, solicita elegir si se omite) |
| ---local | boolean | Sólo navega por archivos locales .capgo-credentials.json |
🔹 Migrar
Sección titulada “ 🔹 Migrar”npx @capgo/cli@latest build credentials migrateMigrar perfil de provisión legado al nuevo formato multi-diseño. Convierte BUILD_PROVISION_PROFILE_BASE64 a CAPGO_IOS_PROVISIONING_MAP. Descubre automáticamente el ID principal del paquete de su proyecto de Xcode. npx @capgo/cli build credentials migrate —plataforma ios
Ejemplo:
Example:Opciones:
| Param | Tipo | Descripción |
|---|---|---|
| —appId | string | ID de la aplicación (detectado automáticamente desde capacitor.config si se omite) |
| —plataforma | string | Plataforma (solo se admite ios) |
| —local | boolean | Migrar desde local .capgo-credentials.json en lugar de global |