Construir
Copiar un prompt de configuración con los pasos de instalación y la guía de markdown completa para este plugin.
🏗️ Administre 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 solicitudes de construcción nativas en la nube actualmente están en una versión beta limitada y el acceso está restringido. Los credenciales de construcción nunca se almacenan en los servidores Capgo: se utilizan solo para la construcción y luego se eliminan. Los resultados de la construcción pueden subirse opcionalmente con enlaces de descarga con plazo de validez limitado.
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”Pass --output-record para persistir la URL de descarga y el 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🧭 Imprime ‘sí’ y sale con code 1 si se requiere una compilación nativa; en caso contrario imprime ‘no’ y sale 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 | API clave 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 monorepos (separadas por comas) |
| —node-modules | string | Rutas a directorios node_modules para monorepos (separadas por comas) |
| —verbose | boolean | Habilitar salida de depuración detallada |
| —supa-host | string | URL de host personalizado de Supabase (para autohosteo o Capgo desarrollo) |
| —supa-anon | string | Clave anonima personalizada de Supabase (para autohosteo) |
🚀 Iniciar
Sección titulada “ 🚀 Iniciar”Alias: onboarding
npx @capgo/cli@latest build initConfigurar credenciales de compilación de forma interactiva (iOS: certificados + perfiles automatizados; Android: keystore + Google OAuth proporciona cuenta de servicio de GCP y envía invitación a la consola de Play)
Opciones:
| Parámetro | Tipo | Descripción |
|---|---|---|
| -a | string | La clave API para vincular a tu cuenta |
| -p | string | Plataforma para incorporar (ios o android). Si se omite, detecta automáticamente cuando solo existe un carpeta nativa; solicita en caso contrario. |
| —supa-host | string | URL de host personalizado de Supabase (para auto-hospedaje o Capgo desarrollo) |
| —no-analytics | boolean | Deshabilitar análisis de construcción de onboarding y reproducción de terminal para esta ejecución |
🔹 Solicitud
Sección titulada “ 🔹 Solicitud”npx @capgo/cli@latest build requestSolicitar una compilación nativa desde Capgo Cloud. Este comando comprimirá el directorio de proyecto y lo subirá a Capgo para su construcción. La compilación se procesará y se enviará directamente a tiendas de aplicaciones. Las credenciales nunca se almacenan en los servidores de 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 para compilar (predeterminado: directorio actual) |
| —módulos-nodo | string | Rutas de directorios de módulos nodo para repositorios monorepo (separados por comas) |
| —plataforma | string | Plataforma objetivo: ios o android (obligatorio) |
| —modo-de-construcción | string | Modo de construcción: depuración o lanzamiento (por defecto: lanzamiento) |
| —certificado-base64 | string | iOS: Certificado Base64 codificado (.p12) |
| —contraseña-p12 | string | iOS: Contraseña del certificado (opcional si el certificado no tiene contraseña) |
| —id-de-apple | string | iOS: Correo electrónico de Apple ID para subidas de 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 subidas a TestFlight |
| —id-de-aplicación-de-apple | string | iOS: Id numérico de aplicación de App Store Connect (requerido junto con —id-de-apple y —contraseña-de-aplicación-específica-de-apple) |
| —apple-key-id | string | iOS: App Store Connect API Key ID |
| —apple-issuer-id | string | ID de emisor de App Store Connect para iOS |
| —apple-key-content | string | iOS: Base64-encoded App Store Connect API key (.p8) |
| —app-store-connect-team-id | string | ID de equipo de App Store Connect para iOS |
| —ios-scheme | string | Esquema de Xcode para iOS (predeterminado: App) |
| —ios-target | string | Objetivo de Xcode para leer configuraciones de compilación (predeterminado: mismo que el esquema) |
| —distribución-ios | string | Modo de distribución de iOS |
| —perfil-de-provisión-ios | string | Ruta del perfil de provisión de iOS o configuración de mapa de bundleId=path (repetible) |
| —archivo-de-keystore-android | string | Android: Archivo de keystore codificado en Base64 |
| —alias-de-clave-de-keystore | string | Alias de clave de keystore de Android |
| —contraseña-de-clave-de-keystore | string | Contraseña de clave de keystore de Android |
| —contraseña-de-almacenamiento-de-keystore | string | Contraseña de almacenamiento de keystore de Android |
| —play-config-json | string | Configuración JSON de Play Store |
| —android-flavor | string | Flavor de Android: Seleccione el tipo de versión a compilar (por ejemplo, producción). Obligatorio si su proyecto tiene varias versiones. |
| —in-app-update-priority | string | Prioridad de actualización en-aplicación de Play Store 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-playstore-upload | boolean | No subir 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 subir, envíe la versión de la tienda para revisión en lugar de dejarla como borrador/inactiva. Android marca la versión de Play Store como completada; iOS envía la versión procesada de TestFlight a la revisión de la Tienda de App. |
| —nombre-de-lanzamiento-en-la-tienda | string | Nombre de lanzamiento en 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-lanzamiento-en-la-tienda | string | Notas de lanzamiento en la tienda predeterminadas. Android utiliza esto como el registro de cambios de Play; iOS lo utiliza como el texto de '¿Qué hay de nuevo?' de la App Store por defecto. |
| —notas-de-lanzamiento-en-la-tienda-locale | string | Notas de lanzamiento en 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 | string | iOS: nombres o IDs de grupos de pruebas externos separados por comas para la distribución de beta externa. |
| —lanzamiento-automatico-de-ios | boolean | iOS: liberar 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-de-salida | boolean | Habilitar la sobrescritura del comportamiento de subida de archivos para esta compilación (habilitado). Precedencia: CLI > entorno > credenciales guardadas |
| —no-subir-archivo-de-salida | boolean | Habilitar la sobrescritura del comportamiento de subida de archivos para esta compilación (desactivado). Precedencia: CLI > entorno > credenciales guardadas |
| —retención-de-archivo-de-salida | string | Sobrescribir la vida útil de la enlace de archivo de salida para esta compilación (1h a 7d). Ejemplos: 1h, 6h, 2d. Precedencia: CLI > entorno > credenciales guardadas |
| —grabar-registro-de-salida | string | Después de una compilación exitosa, escribir 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 PNG QR code también se escribe junto a ese camino con la .qr.png —no-saltar-número-de-compilación build last-output. |
| Sobrescribir credenciales guardadas para reactivar la incrementación automática del número de compilación para esta compilación solo. | boolean | —saltar-número-de-marketing-de-compilación |
| —no-saltar-número-de-compilación-de-marketing | boolean | Saltar el aumento automático de la versión de marketing (CFBundleShortVersionString / versionName) cuando la aplicación ya está lanzada. |
| —sync-ios-version | boolean | iOS: sincronice la versión de marketing de Xcode desde package.json antes de subir el proyecto. |
| —ai-análisis | boolean | Al fallar la compilación, envía 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 | Saltar la escaneo automático previo a la compilación |
| —prescan-ignore-fatal | boolean | Ejecuta el escaneo previo a la compilación pero nunca bloquee la compilación (solo informe) |
| —prescan-skip | string | Saltar la verificación específica de escaneo (s) por id (repetible o separado por comas). Las otras verificaciones aún se ejecutan. |
| —prescan-warn | string | Descendera específicas comprobaciones de prescans a advertencias por id (repetibles o separados por comas). La comprobación sigue funcionando. |
| –falla-en-advertencias | boolean | Tratar advertencias de prescans como fatales |
| –enviar-registros-a-soporte | boolean | En una falla de construcción CI/CD, subir automáticamente los registros de construcción a Capgo soporte (no se requiere correo electrónico). Capgo soporte se notifica y seguirá con correo electrónico. Aditivo a –análisis-de-inteligencia-artificial. |
| –enviar-registros | boolean | Alias deprecado para –enviar-registros-a-soporte |
| -a | string | API clave para vincular a su cuenta |
| –supa-host | string | URL de host personalizado de Supabase (para auto-hospedaje o Capgo desarrollo) |
| –supa-anon | string | Clave de anonimato personalizada de Supabase (para auto-hospedaje) |
| —verbose | boolean | Habilitar la salida detallada con registro de depuración |
🔹 Sync-ios-version
Sección titulada “ 🔹 Sync-ios-version”npx @capgo/cli@latest build sync-ios-versionSincronizar la versión de iOS Xcode MARKETING_VERSION desde package.json.
Ejemplo:
npx @capgo/cli@latest build sync-ios-version --path .Opciones:
| Parámetro | Tipo | Descripción |
|---|---|---|
| —ruta | string | Ruta del directorio del proyecto (por defecto: directorio actual) |
| —verificar | boolean | Verificar solo; salir con cero cuando MARKETING_VERSION esté fuera de sincronización |
🔹 Prescaneo
Sección titulada “ 🔹 Prescaneo”npx @capgo/cli@latest build prescanEscanea 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 sincronizado, nodo módulos), y configuración de plataforma. Se ejecuta automáticamente dentro build request; esta orden ejecuta el comando de forma independiente (por ejemplo, en CI).
Ver Prescan verifica para obtener la lista completa de verificaciones y cómo utilizar --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 |
| —android-flavor | string | Android: sabor del producto que el build utilizará |
| —ios-dist | string | iOS: modo de distribución para validar contra |
| —json | boolean | Genera un informe legible por máquinas en formato JSON |
| —fail-on-warnings | boolean | Salir con código no cero cuando se encuentran advertencias (CI) |
| —ignore-fatal | boolean | Modo de diagnóstico: informa todo pero siempre sale con código 0 |
| —saltar | string | Saltar comprobaciones específicas por id (repetibles o separadas por comas) |
| —advertencia | string | Descargar comprobaciones específicas a advertencia por id (repetibles o separadas por comas) |
| —detallado | boolean | Habilitar salida detallada con registro de depuración |
| —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) |
🔹 Último-resultado
Sección titulada “ 🔹 Último-resultado”npx @capgo/cli@latest build last-outputLeer el registro de salida de compilación escrito por un 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 el código QR para volver a publicarlo 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 |
|---|---|---|
| —path | string | Ruta al registro JSON escrito por —output-record (requerido) |
| —field | string | Imprimir un campo único (uno de: jobId, appId, plataforma, modo de compilación, estado, outputUrl, qrCodeAscii, qrCodePngPath, finishedAt, schemaVersion) |
| —código QR | boolean | Imprimir el código QR ASCII renderizado code (atajo para —field qrCodeAscii) |
🔹 credenciales
Sección titulada “ 🔹 Credenciales”Gestionar credenciales de compilación almacenadas localmente en tu máquina. 🔒 SEGURIDAD:
- 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
- Eliminadas de Capgo inmediatamente después de la compilación
- Los resultados de compilación pueden ser cargados opcionalmente para obtener enlaces de descarga a plazo limitado 📚 DOCUMENTACIÓN: iOS setup: https://capgo.app/docs/cli/nube-compilar/ios/ Configuración de Android: https://capgo.app/docs/cli/nube-compilar/android/
🔹 Apple-key
Sección titulada “ 🔹 Apple-key”Alias: asc-key
npx @capgo/cli@latest build credentials apple-keyCreate an App Store Connect team API key with a guided macOS helper (macOS only). Opens a native window that walks you through Apple’s App Store Connect UI in an embedded browser, auto-captures the Issuer ID + Key ID, intercepts the one-time .p8, validates it against Apple, and saves it to ~/.appstoreconnect/private_keys. Progress statistics are forwarded to Capgo analytics (disable with CAPGO_DISABLE_TELEMETRY). npx @capgo/cli build credentials apple-key —appId com.example.app
Ejemplo:
Example:Opciones:
| Parámetro | 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 ID / clave de emisor / ruta de archivo .p8 capturada en formato 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/nube-compilar/iOS/
Android: https://capgo.app/docs/cli/nube-compilar/Android/
npx @capgo/cli compilar credenciales guardar —plataforma ios
—certificado ./cert.p12 —contraseña de p12 “contraseña”
—perfil de provisión de iOS ./profile.mobileprovision
—clave de Apple ./AuthKey.p8 —clave de Apple-Id “KEY123”
—identificador de emisor de Apple “issuer-uuid” —identificador de equipo de Apple “team-id” Ejemplo de múltiples objetivos (aplicación + extensión de widget): npx @capgo/cli compilar credenciales guardar —plataforma ios
– perfil de provisión ios ./App.mobileprovision
– perfil de provisión ios com.example.widget=./Widget.mobileprovision
npm @capgo/cli build credentials save —plataforma android
– llave de registro ./release.keystore —llave de registro-alias “my-key”
– contraseña de llave de registro “key-pass”
– configuración de Google Play ./service-account.json Almacenamiento local (por proyecto): npm @capgo/cli build credentials save —local —plataforma ios …
Ejemplo:
iOS Example:Opciones:
| Parámetro | Tipo | Descripción |
|---|---|---|
| __CAPGO_KEEP_0__ | string | ID de la aplicación (por ejemplo, com.example.app) (obligatorio) |
| __CAPGO_KEEP_0__ | string | Plataforma: ios o android (obligatorio) |
| __CAPGO_KEEP_0__ | string | iOS: Ruta al archivo de certificado .p12 |
| __CAPGO_KEEP_0__ | string | iOS: Ruta al perfil de configuración o bundleId=path (repetible) |
| __CAPGO_KEEP_0__ | string | iOS: Contraseña del certificado (opcional si el certificado no tiene contraseña) |
| __CAPGO_KEEP_0__ | string | iOS: Ruta al archivo .p8 de App Store Connect API |
| —clave de Apple | string | iOS: Identificador de clave de App Store Connect API |
| —identificador de emisor de Apple | string | iOS: Identificador de emisor de App Store Connect |
| —identificador de equipo de Apple | string | iOS: Identificador de equipo de App Store Connect |
| —distribución de iOS | string | iOS: Modo de distribución |
| —correo electrónico de Apple ID | string | iOS: Correo electrónico de Apple ID para subir contraseñas específicas de la aplicación (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 |
| —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 de keystore |
| —keystore-store-password | string | Android: Contraseña del almacén de keystore |
| —play-config | string | Android: Ruta al archivo JSON de servicio de tienda de Play |
| —android-flavor | 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). Omite 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/ |
| —output-upload | 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 |
| —saltar-aumento-de-número-de-construcción | boolean | Saltar el aumento automático del número de construcción/version code en futuras construcciones |
| —no-saltar-aumento-de-número-de-construcción | boolean | Rehabilitar el aumento automático del número de construcción (comportamiento predeterminado) |
| —saltar-aumento-de-versión-de-marketing | boolean | Saltar el aumento automático de la versión de marketing en futuras construcciones cuando la aplicación ya está liberada |
| —no-saltar-aumento-de-versión-de-marketing | boolean | Rehabilitar el aumento automático de la versión de marketing (comportamiento predeterminado) |
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 # Listar todas las aplicaciones npx @capgo/cli build credentials list —appId com.example.app # Listar aplicación específica
Opciones:
| Parámetro | Tipo | Descripción |
|---|---|---|
| —appId | string | ID de aplicación para listar (opcional, lista todas si omitido) |
| —local | boolean | Lista 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 a 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 | Clear desde local .capgo-credentials.json en lugar de global |
🔹 Actualizar
Sección titulada “ 🔹 Actualizar”npx @capgo/cli@latest build credentials updateActualizar credenciales específicas sin proporcionar todas ellas de nuevo. 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 credenciales actualizar —ios-provisioning-profile ./new-profile.mobileprovision npx @capgo/cli build credenciales actualizar —local —keystore ./new-keystore.jks
Opciones:
| Parámetro | Tipo | Descripción |
|---|---|---|
| —appId | string | ID de la aplicación (detectada automáticamente desde capacitor.config si omitido) |
| —plataforma | string | Plataforma: ios o android (determinada automáticamente desde opciones) |
| —local | boolean | Actualizar archivo local .capgo-credentials.json en lugar de global |
| —certificado | string | Ruta del archivo de certificado P12 |
| —perfil-de-provisión-ios | string | Ruta del perfil de provisión o bundleId=path (repetible, aditivo por defecto) |
| —sobreescribir-mapa-de-provisión-ios | boolean | Reemplazar el mapa de provisión completo en lugar de fusionar (por defecto: fusionar) |
| —contraseña-p12 | string | Contraseña del certificado P12 |
| —clave de Apple | string | Ruta a la clave API de App Store Connect (archivo .p8) |
| —clave de Apple ID | string | ID de clave de App Store Connect API |
| —ID de emisor de Apple | string | ID de emisor de App Store Connect |
| —ID de equipo de Apple | string | ID de equipo de App Store Connect |
| —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 API de App Store Connect) |
| —contraseña de aplicación específica de Apple | string | iOS: contraseña específica de aplicación (xxxx-xxxx-xxxx-xxxx) para subir a TestFlight |
| —apple-app-id | string | iOS: Identificador numérico de la tienda de aplicaciones de Apple (requerido junto con —apple-id y —apple-app-specific-password) |
| —ios-distribution | string | iOS: Modo de distribución |
| —keystore | string | Ruta al archivo del almacén de claves (.keystore o .jks) |
| —keystore-alias | string | Alias de la clave del almacén de claves |
| —keystore-key-password | string | Contraseña de la clave del almacén de claves |
| —keystore-store-password | string | Contraseña del almacén de claves |
| —configuracion-de-juego | string | Ruta al archivo JSON de servicio de Google Play |
| —sabor-android | string | Android: Sabor de producto para construir (por ejemplo, producción). Obligatorio si su proyecto tiene varios sabores. |
| —prioridad-de-actualizacion-en-aplicacion | string | Android: Prioridad de actualización de Google Play en aplicaciones para futuras versiones (entero 0–5; mayor = más urgente). |
| —subir-archivo-de-resultado | boolean | Subir archivos de resultado (IPA/APK/AAB) a Capgo almacenamiento y imprimir enlaces de descarga |
| —no-subir-archivo-de-resultado | boolean | No subir archivos de resultado (IPA/APK/AAB) a Capgo almacenamiento |
| —retencion-de-archivo-de-resultado | string | TTL de enlace de archivo: 1h a 7d. Ejemplos: 1h, 6h, 2d |
| —saltar-número-de-compilación | boolean | Saltar el incremento automático del número de versión de compilación code en futuras compilaciones |
| —no-saltar-número-de-compilación | boolean | Rehabilitar el incremento automático del número de versión de compilación (comportamiento predeterminado) |
| —saltar-número-de-versión-de-marketing | boolean | Saltar el incremento automático del número de versión de marketing en futuras compilaciones cuando la aplicación ya esté liberada |
| —no-saltar-número-de-versión-de-marketing | boolean | Rehabilitar el incremento automático del número de versión de marketing (comportamiento predeterminado) |
🔹 Administrar
Título de la sección “ 🔹 Administrar”npx @capgo/cli@latest build credentials manageAdministre interactivamente las credenciales de construcción guardadas.
Navegue por las credenciales almacenadas, vea qué está configurado, exporte un archivo .env listo para CI/CD,ór elimine las credenciales de una plataforma. Reutiliza el mismo TUI que capgo init.
Ejemplos:
npx @capgo/cli credenciales de construcción administre
npx @capgo/cli credenciales de construcción administre —appId com.example.app
npx @capgo/cli credenciales de construcción administre —appId com.example.app —plataforma ios
npx @capgo/cli credenciales de construcción administre —local
Opciones:
| Parámetro | Tipo | Descripción |
|---|---|---|
| —appId | string | ID de aplicación para administrar (opcional, solicita elegir si se omite) |
| —plataforma | string | Plataforma para administrar: ios o android (opcional, solicita elegir si se omite) |
| —local | boolean | Sólo navegue por .capgo-credentials.json locales |
🔹 Migrar
Sección titulada “ 🔹 Migrar”npx @capgo/cli@latest build credentials migrateMigrar el perfil de provisión legado al nuevo formato de múltiples objetivos. Convierte BUILD_PROVISION_PROFILE_BASE64 a CAPGO_IOS_PROVISIONING_MAP. Descubre automáticamente el ID de la aplicación principal desde tu proyecto de Xcode. npx @capgo/cli build credentials migrate —plataforma ios
Ejemplo:
Example:Opciones:
| Parámetro | Tipo | Descripción |
|---|---|---|
| —appId | string | ID de la aplicación (detectado automáticamente de capacitor.config si se omite) |
| —platform | string | Plataforma (solo se admite ios) |
| —local | boolean | Migrar desde local .capgo-credentials.json en lugar de global |