🔹 Construye

🏗️ Manage native iOS/Android builds through Capgo Cloud.

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

npx @capgo/cli build credentials save --appId YOUR_APP_ID --platform ios
npx @capgo/cli build credentials save --appId YOUR_APP_ID --platform android

Capturar una URL de salida en CI

Para persistir la URL de descarga y el código QR __CAPGO_KEEP_0__, luego utilice --output-record to persist the download URL and QR code, then use build last-output Ventana de terminal

npx @capgo/cli build request APP_ID --platform android --output-upload --output-record /tmp/build.json
npx @capgo/cli build last-output --path /tmp/build.json --field outputUrl

🔹 Sección titulada “Necesario”

npx @capgo/cli@latest build needed

🧭 Imprimir “sí” y salir con code 1 si es necesario un compilado nativo; 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 --verbose

Opciones:

Parámetro	Tipo	Descripción
-a	string	Clave 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

Alias: onboarding

npx @capgo/cli@latest build init

Configurar credenciales de compilación de manera interactiva (iOS: certificados + perfiles automatizados; Android: keystore + invitación de Google OAuth y cuenta de servicio de GCP)

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 en caso contrario.
---supa-host	string	URL de host personalizado de Supabase (para auto-hosting o desarrollo Capgo)
---no-analytics	boolean	Deshabilitar la recopilación de análisis de onboarding y la reproducción del terminal para esta ejecución

🔹 Solicitud

npx @capgo/cli@latest build request

Solicite una compilación nativa desde Capgo Cloud. Este comando comprimirá su 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 Capgo; se eliminan después de la compilación. Guarde sus credenciales antes de solicitar una compilación:

npx @capgo/cli build credentials save --appId APP_ID --platform ios

Ejemplo:

npx @capgo/cli@latest build request com.example.app --platform ios --path .

Opciones:

Parametro	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 monorepo (separadas 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)
—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-electrónico-de-id-de-la-maquina-de-apple	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-maquina-de-apple	string	iOS: Contraseña de aplicación específica (xxxx-xxxx-xxxx-xxxx) para subir a TestFlight
—id-de-aplicación-de-la-maquina-de-apple	string	iOS: Identificador numérico de la aplicación de App Store Connect (obligatorio 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: objetivo de Xcode para leer configuraciones de compilación (por defecto: 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=path de mapeo (repetible)
—archivo-de-keystore-android	string	Android: Archivo de keystore codificado en Base64
—alias-de-clave-de-keystore	string	Android: Alias de clave de keystore
—contraseña-de-clave-de-keystore	string	Android: Contraseña de clave de keystore
—contraseña-de-almacenamiento-de-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	Saltarse la subida a Play Store para esta compilación (anula la configuración de Play guardada). Requiere —output-upload.
—enviar-a-la-revisión-de-la-tienda	boolean	Después de la subida, envíe 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 (sobreescriba 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	Nombre/versión de la versión de la tienda. Android envía esto como el nombre de la versión de Google Play; iOS lo utiliza como el nombre de 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.
—notas-de-la-versión-de-la-tienda-locale	string	Notas de la versión de la tienda localizadas (repetibles), por ejemplo —notas-de-la-versión-de-la-tienda-locale es-ES=“Correcciones de errores” —notas-de-la-versión-de-la-tienda-locale fr-FR=“Correcciones”.
—grupos-de-pruebas-de-ios-testflight	string	iOS: nombres o IDs de grupo de TestFlight separados por comas opcionales para la distribución de beta externa.
—ios-automatic-release	boolean	iOS: liberar automáticamente la versión de la Tienda de Aplicaciones 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 la Tienda de Aplicaciones esperando una liberación manual después de la aprobación de Apple.
—output-upload	boolean	Superar el comportamiento de carga de salida para esta compilación solo (habilitar). Precedencia: CLI > entorno > credenciales guardadas
—no-output-upload	boolean	Superar el comportamiento de carga de salida para esta compilación solo (desactivar). Precedencia: CLI > entorno > credenciales guardadas
—output-retention	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
—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 restaurar caché de build	boolean	y No guarde una nueva entrada de caché para este build. El caché de build está habilitado por defecto por aplicación. Particionar el caché de build por entorno, rama o sabor de Android (por ejemplo
No omitir para un caché compartido por defecto por aplicación.	string	No incrementar automáticamente el número de build para este build. prod, stagingNo incrementar automáticamente la versión de marketing para este build.
No omitir para un caché compartido por defecto por aplicación.	boolean	Rehabilitar credenciales guardadas para reactivar el incremento automático del número de build para este build solo.
No incrementar automáticamente la versión de marketing para este build.	boolean	Saltar la versión de marketing automática (CFBundleShortVersionString / versionName) cuando la aplicación ya está lanzada.
—sync-ios-version	boolean	iOS: sincronice la versión MARKETING de Xcode desde package.json antes de subir el proyecto.
—ai-analytics	boolean	Al fallar la compilación, envía los registros a Capgo AI para el diagnóstico. En terminales interactivos, esto salta la confirmación previa; en CI, sube automáticamente y 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 comprobación de escaneo específica(s) por id (repetible o separado por comas). Las otras comprobaciones aún se ejecutan.
—prescan-warn	string	Descender a la versión específica de la comprobación de prescan (repetible o separado por comas). La comprobación aún se ejecuta.
—fail-on-warnings	boolean	Tratar las advertencias de prescan como fatales
—send-logs-to-support	boolean	Al fallar un proceso de compilación 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.
—send-logs	boolean	Alias deprecado para —send-logs-to-support
-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

Cache de construcción: Capgo restaura y guarda artefactos nativos compilados (CocoaPods, Gradle y resultados relacionados) por defecto por aplicación. Utilice --cache-key para mantener separados los cachés RC y de producción; utilice --no-cache para una construcción de una sola vez. Las integraciones de API pueden pasar cache_key o cache_enabled: false Fragmento de texto HTML de una cadena de UI de Capgo más larga (clave de padre `alternatives_cta_questions`). Página/área: página de comparación de alternativas de actualización en vivo de Capacitor. Rol: párrafo de marketing o legal largo. Visto en: página alternatives.astro. Preservar términos de producto y marca de Capgo exactamente. Clave de mensaje `alternatives_cta_questions` (Preguntas de CTA de alternativas). | Fragmento de texto HTML de una cadena de UI de Capgo más larga (clave de padre `appflow_cta_questions`). Página/área: copia de marketing de comparación/migración de Appflow. Rol: párrafo de marketing o legal largo. Visto en: página ionic-appflow.astro. Preservar términos de producto y marca de Capgo exactamente. Clave de mensaje `appflow_cta_questions` (Preguntas de CTA de Appflow). | Fragmento de texto HTML de una cadena de UI de Capgo más larga (clave de padre `capwesome_cta_questions`). Página/área: página de comparación de Capawesome. Rol: párrafo de marketing o legal largo. Visto en: página capwesome.astro. Preservar términos de producto y marca de Capgo exactamente. Clave de mensaje `capwesome_cta_questions` (Preguntas de CTA de Capwesome). | Fragmento de texto HTML de una cadena de UI de Capgo más larga (clave de padre `consulting_faq_subtitle`). Página/área: página de servicios de consultoría. Rol: subtítulo o etiqueta de sección. Visto en: página consulting.astro. Preservar términos de producto y marca de Capgo exactamente. Clave de mensaje `consulting_faq_subtitle` (Subtítulo de FAQ de consultoría). | Página/área: copia de marketing de comparación/migración de Appflow. Rol: etiqueta de UI corta o elemento de navegación. Visto en: página ionic-appflow.astro, página ionic-enterprise-plugins.astro, página soluciones/ionic-enterprise-plugins.astro. Clave de mensaje `appflow_plugins_or` (Appflow Plugins o). en el payload de solicitud de construcción. Consulte Cache de construcción y el contexto de depuración: restauración de caché incorrecta.

🔹 Sync-ios-version

npx @capgo/cli@latest build sync-ios-version

Sincronice la versión local 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 al directorio del proyecto (por defecto: directorio actual)
—verificar	boolean	Verificar solo; salir con cero cuando MARKETING_VERSION esté fuera de sincronización

🔹 Prescanner

npx @capgo/cli@latest build prescan

Escanea 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 de disposición) y configuración de plataforma. Se ejecuta automáticamente dentro de build request; esta orden ejecuta el comando de forma independiente (por ejemplo, en CI). Ver Prescanner verifica para obtener el catálogo de verificación completo y cómo hacerlo --skip / --warn reglas individuales.

Opciones:

Param	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
—sabor android	string	Android: sabor del producto que utilizará la compilación
—ios-dist	string	iOS: modo de distribución para validar contra
—json	boolean	Generar un informe JSON legible por máquinas
—fail-on-warnings	boolean	Salir con código no cero cuando se encuentran advertencias (CI)
—ignore-fatal	boolean	Modo de diagnóstico: informar todo pero siempre salir con código 0
—skip	string	Saltar una o varias comprobaciones específicas por id (repetibles o separadas por comas)
—warn	string	Descargar específico de la verificación (s) a advertencia por id (repetible o separado por comas)
—verbose	boolean	Habilitar la salida detallada con registro de depuración
—supa-host	string	URL de host personalizado de Supabase (para auto-hospedaje o desarrollo Capgo)
—supa-anon	string	Clave de anonimato personalizada de Supabase (para auto-hospedaje)

🔹 Último registro de salida

npx @capgo/cli@latest build last-output

Sección titulada “ 🔹 Last-output” build request --output-record. Imprime 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
—ruta	string	Ruta del registro JSON escrito por —registro-de-entrada (obligatorio)
—campo	string	Imprimir un campo único (uno de: jobId, appId, plataforma, modo de compilación, estado, outputUrl, qrCodeAscii, qrCodePngPath, finishedAt, schemaVersion)
—qr	boolean	Imprimir el código QR ASCII renderizado code (atajo para —campo qrCodeAscii)

🔹 Credenciales

Gestione las credenciales de compilación almacenadas localmente en su máquina. 🔒 SEGURIDAD:

• Las credenciales se guardan en ~/.capgo-credentials/credentials.json (global) o .capgo-credentials.json (local)
• Cuando se compila, se envían a Capgo pero NUNCA se almacenan permanentemente
• Se eliminan de Capgo inmediatamente después de la compilación
• Los resultados de compilación pueden cargarse opcionalmente para obtener enlaces de descarga a tiempo limitado 📚 DOCUMENTACIÓN: iOS setup: https://capgo.app/docs/cli/cloud-build/ios/ Configuración de Android: https://capgo.app/docs/cli/cloud-build/android/

🔹 Apple-key

Alias: asc-key

npx @capgo/cli@latest build credentials apple-key

Crear una clave de equipo de App Store Connect API con una asistente 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 único, lo valida contra Apple y lo guarda en ~/.appstoreconnect/private_keys. Las estadísticas de progreso se envían a Capgo de análisis (desactiva con CAPGO_DISABLE_TELEMETRY). npx @capgo/cli construye credenciales de apple-key —appId com.example.app

Ejemplo:

Example:

Opciones:

Parámetro	Tipo	Descripción
-a	string	Clave de equipo de App Store Connect API para vincular a tu cuenta
appId	string	Guardar la clave capturada en las credenciales de compilación de esta 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 / emisor ID / ruta de archivo .p8 como JSON

🔹 Guardar

npx @capgo/cli@latest build credentials save

Guardar credenciales de compilación localmente para iOS o Android. Las credenciales se almacenan en:

• ~/.capgo-credentials/credentials.json (por defecto, global)
• capgo-credenciales.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 build credenciales guardar —plataforma ios
  —certificado ./cert.p12 —contraseña-p12 “contraseña”
  —perfil-de-provisión-ios ./perfil.mobileprovision
  —clave-Apple ./AuthKey.p8 —clave-Apple-id “KEY123”
  —id-de-emisor-Apple “issuer-uuid” —id-de-equipo-Apple “equipo-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
  —keystore ./release.keystore —keystore-alias “mi-clave”
  —keystore-key-password “contraseña-de-clave”
  —play-config ./service-account.json Almacenamiento local (por proyecto): npx @capgo/cli build credentials save —local —plataforma ios …

Ejemplo:

iOS Example:

Opciones:

Parámetro	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
—provisioning-ios	string	iOS: Ruta al perfil de configuració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 archivo de clave .p8 de App Store Connect API
—clave-apple-id	string	iOS: ID de clave de App Store Connect API
—apple-issuer-id	string	iOS: Identificador de emisor de App Store Connect
—apple-team-id	string	iOS: Identificador 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 específica (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)
—keystore	string	Android: Ruta al archivo del keystore (.keystore o .jks)
—keystore-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	string	Android: Ruta al archivo JSON de la cuenta de servicio de Play Store
—android-flavor	string	Android: Sabor del producto para compilar (por ejemplo, producción). Obligatorio 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	Guardar en .capgo-credenciales.json en la raíz del proyecto en lugar de ~/.capgo-credenciales/
---subir-archivos-de-archivo	boolean	Subir archivos de salida (IPA/APK/AAB) a Capgo almacenamiento y imprimir enlaces de descarga
---no-subir-archivos-de-archivo	boolean	No subir archivos de salida (IPA/APK/AAB) a Capgo almacenamiento
---retención-de-archivo	string	Enlace de archivo TTL: 1h a 7d (por defecto: 1h). Ejemplos: 1h, 6h, 2d
---saltarse-numero-de-construcción-aumento	boolean	Saltar el aumento automático del número de construcción/version code en futuras construcciones
---sin-saltar-número-de-contrucción-bump	boolean	Reactivar el incremento automático del número de construcción (comportamiento predeterminado)
---saltar-versión-de-marketing-bump	boolean	Saltar el incremento automático de la versión de marketing en futuras construcciones cuando la aplicación ya está liberada
---sin-saltar-versión-de-marketing-bump	boolean	Reactivar el incremento automático de la versión de marketing (comportamiento predeterminado)

📋 Lista

npx @capgo/cli@latest build credentials list

Lista 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 la aplicación para listar (opcional, lista todas si se omite)
—local	boolean	Listar credenciales desde el archivo local .capgo-credentials.json solo

🔹 Borrar

npx @capgo/cli@latest build credentials clear

Clear saved build credentials. Remove credentials from storage. Use —appId and —platform to target specific credentials. Examples: npx @capgo/cli build credentials clear # Clear all apps (global) npx @capgo/cli build credentials clear —local # Clear local credentials 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 eliminar (opcional, elimina todas las aplicaciones si se omite)
—plataforma	string	Plataforma a eliminar: ios o android (opcional, elimina todas las plataformas si se omite)
—local	boolean	Eliminar de local .capgo-credentials.json en lugar de global

🔹 Actualizar

npx @capgo/cli@latest build credentials update

Actualizar 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 se proporcionan. Ejemplos: npx @capgo/cli build credenciales update —ios-provisioning-profile ./new-profile.mobileprovision npx @capgo/cli build credenciales update —local —keystore ./new-keystore.jks

Opciones:

Parámetro	Tipo	Descripción
—appId	string	ID de la aplicación (detectado automáticamente desde capacitor.config si omitido)
—plataforma	string	Plataforma: ios o android (detectada automáticamente desde opciones)
—local	boolean	Actualice el archivo local .capgo-credentials.json en lugar del 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	Sustituir el mapa de provisión completo en lugar de fusionarlo (por defecto: fusionar)
—contraseña-p12	string	Contraseña del certificado P12
—llave-de-apple	string	Ruta de la llave de App Store Connect API (.p8 archivo)
—identificador-de-llave-de-apple	string	App Store Connect API ID de clave
—apple-issuer-id	string	ID de emisor de App Store Connect
—apple-team-id	string	ID de equipo de App Store Connect
—apple-id	string	iOS: Correo electrónico de Apple ID para subir contraseñas de aplicación específica (alternativa a la clave de App Store Connect API)
—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: ID numérica 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 del 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
—play-config	string	Ruta del archivo JSON del servicio de Google Play
—android-flavor	string	Android: Sabor de producto para construir (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-archivos-de-archivo	boolean	Subir archivos de salida (IPA/APK/AAB) a Capgo almacenamiento y imprimir enlaces de descarga
—no-subir-archivos-de-archivo	boolean	No subir archivos de salida (IPA/APK/AAB) a Capgo almacenamiento
—retención-de-enlace-de-archivo	string	TTL de enlace de archivo: 1h a 7d. Ejemplos: 1h, 6h, 2d
—saltarse-incremento-de-número-de-construcción	boolean	Saltarse el incremento automático del número de construcción/version code en futuras construcciones
—no-saltarse-incremento-de-número-de-construcción	boolean	Rehabilitar el incremento automático del número de compilación (comportamiento predeterminado)
–saltarse-actualización-de-versión-de-marketing	boolean	Saltarse la actualización automática de versión de marketing en futuras compilaciones cuando la aplicación ya esté liberada
–no-saltarse-actualización-de-versión-de-marketing	boolean	Rehabilitar la actualización automática de versión de marketing (comportamiento predeterminado)

🔹 Gestionar

npx @capgo/cli@latest build credentials manage

Gestionar interactivamente las credenciales de compilación guardadas. Navegar por las credenciales almacenadas, ver qué está configurado, exportar un archivo .env listo para CI/CD, o 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 —platform 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 para gestionar: ios o android (opcional, solicita elegir si se omite)
—local	boolean	Solo navega por credenciales locales .capgo-credentials.json

🔹 Migrar

npx @capgo/cli@latest build credentials migrate

Migrar 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 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 desde capacitor.config si se omite)
—plataforma	string	Plataforma (solo ios está soportado)
—local	boolean	Migrar desde local .capgo-credentials.json en lugar de global