📦 Empaquetar

📦 Administre paquetes de aplicaciones para la implementación en Capgo Cloud, incluyendo la carga, verificación de compatibilidad y cifrado.

⬆️ Cargar

Alias: u

npx @capgo/cli@latest bundle upload

⬆️ Cargar un nuevo paquete de aplicación a Capgo Cloud para su distribución. La versión debe ser > 0.0.0 y única. Las versiones eliminadas no pueden ser reutilizadas por motivos de seguridad. Opción externa: Almacene solo un enlace de URL (útil para aplicaciones >200MB o requisitos de privacidad). Capgo nunca inspecciona contenido externo. Agregue cifrado para seguridad sin confianza.

Ejemplo:

npx @capgo/cli@latest bundle upload com.example.app --path ./dist --channel production,beta

Opciones:

Param	Tipo	Descripción
-a	string	API clave para vincular a tu cuenta
-p	string	Ruta del folder para subir, si no se proporciona se utilizará el webDir configurado en capacitor.config
-c	string	Canales para vincular. Utiliza comas para múltiples canales, por ejemplo producción,beta
—rollout	string	Establece el paquete subido como objetivo de rollout de este canal a un porcentaje del 0 al 100
—porcentaje-de-despliegue-bps	string	Establezca el porcentaje de despliegue del paquete subido en puntos base desde 0 a 10000
—ttl-de-caché-de-toma-de-decisión-en-segundos	string	Cloudflare TTL de caché de decisión de despliegue en segundos
-e	string	Enlace a una URL externa en lugar de subir a Capgo Cloud
—clave-de-sesión-IV	string	Establezca la clave de sesión y IV para la URL del paquete
—región-de-S3	string	Región para su bucket de S3
—clave-de-llave-S3	string	API clave de API para su punto final de S3
—s3-apisecret	string	API secreto para tu punto de conexión S3
—s3-endpoint	string	URL del punto de conexión S3
—s3-bucket-name	string	Nombre para tu contenedor de S3 de AWS
—s3-port	string	Puerto para tu punto de conexión S3
—no-s3-ssl	boolean	Deshabilitar SSL para la carga de S3
—key-v2	string	Ruta personalizada para la clave de firma privada (sistema v2)
—clave-datos-v2	string	Clave de firma privada (sistema v2)
—url-empaquetado	boolean	Imprime la URL del paquete en la salida estándar
—sin-clave	boolean	Ignora la clave de firma y envía la actualización en claro
—sin-verificación-code	boolean	Ignora la verificación de si notifyAppReady() se llama en el origen code y el índice presente en la carpeta raíz
—mostrar-sesión-iv	boolean	Muestra en la consola la clave IV y la sesión utilizadas para cifrar la actualización
-b	string	Número de versión del paquete a subir
—enlace	string	Enlace a recurso externo (por ejemplo GitHub release)
—comentario	string	Comentario sobre esta versión, podría ser una nota de lanzamiento, un hash de commit, un mensaje de commit, etc.
—min-versión-de-actualización	string	Versión mínima requerida para actualizar a esta versión. Se utiliza solo si se establece la actualización automática a metadata en el canal
—auto-min-actualización-versión	boolean	Establece la versión de actualización mínima basada en paquetes nativos
—ignorar-verificación-de-metadata	boolean	Ignora la verificación de metadata (node_modules) al subir
—fallar-en-incompatible	boolean	Fallar la subida (salir con código no cero) en lugar de subir cuando el paquete es incompatible con los paquetes nativos del canal actual. En una terminal interactiva todavía se puede elegir una construcción nativa; declinar falla.
—ignora-verificación-de-sumatorio	boolean	Ignora la verificación de sumatorio al subir
—forzar-verificación-de-sumatorio-crc32	boolean	Forzar verificación de sumatorio CRC32 para subir (sobreescribir la detección automática)
—tiempo	string	Tiempo para el proceso de subida en segundos
—multipart	boolean	[DEPRECATED] Utilice —tus en su lugar. Utiliza el protocolo multipart para subidas a S3
—zip	boolean	Sube el paquete utilizando zip a Capgo cloud (legado)
—tus	boolean	Sube el paquete utilizando TUS a Capgo cloud
—tamaño-de-pieza—	string	Tamaño de pieza en bytes para subidas resumibles de TUS (predeterminado: auto)
—parcial—	boolean	[DEPRECATED] Utilice —delta en su lugar. Subir actualizaciones incrementales
—parcial-solo—	boolean	[DEPRECATED] Utilice —delta-solo en su lugar. Subir solo actualizaciones incrementales, saltar paquete completo
—delta—	boolean	Subir actualizaciones delta (solo archivos modificados) para actualizaciones instantáneas y muy rápidas en lugar de descargas grandes de zip
—delta-solo—	boolean	Subir solo actualizaciones delta sin paquete completo para la máxima velocidad (útil para aplicaciones grandes)
—sin-delta—	boolean	Deshabilitar actualizaciones delta incluso si se habilitan actualizaciones instantáneas
—checksum cifrado	string	Un checksum cifrado (firma). Se utiliza solo cuando se sube un paquete externo.
—establecer-bundle	boolean	Establecer el paquete en capacitor.config.json
—subir-seco	boolean	Subir el proceso de paquete de manera seca: agregar la fila en la base de datos sin subir archivos ni actualizar canales (Usado por Capgo para pruebas internas)
—archivo-json-de-paquete	string	Rutas a archivos json de paquete para repositorios monolíticos (separadas por comas)
—módulos-nodo	string	Rutas a directorios de módulos nodo para repositorios monolíticos (separadas por comas)
—cifrar-parte	boolean	Cifrar archivos de actualización delta (habilitado automáticamente para actualizadores > 6.14.4)
borrar-bundle-enlazado-al-subir	boolean	Localiza el bundle enlazado actual en el canal al que estás intentando subir, y lo elimina
patrones-no-brotli	string	Archivos a excluir de la compresión Brotli (globs separados por comas, por ejemplo, “.jpg,.png”)
deshabilitar-brotli	boolean	Deshabilitar completamente la compresión Brotli incluso si la versión del actualizador lo permite
existe-una-versión-ok	boolean	Salir con éxito si ya existe una versión del bundle, útil para flujos de trabajo de CI/CD con repositorios monolíticos
asignar-automaticamente	boolean	Permitir que los dispositivos se unan automáticamente a este canal (actualiza la configuración del canal)
—preview-qr	boolean	Print a terminal QR code for this bundle preview after upload
—enviar-notificación-de-actualización	boolean	Enviar una notificación de comprobación de actualización nativa a dispositivos después de actualizar los paquetes de canales vinculados
—anfitrión-supabase	string	URL de anfitrión personalizado de Supabase (para autoalojamiento o desarrollo Capgo)
—anon-supabase	string	Clave anonimizada personalizada de Supabase (para autoalojamiento)
—verbose	boolean	Habilitar la salida detallada con registro de depuración

🧪 Compatibilidad

npx @capgo/cli@latest bundle compatibility

🧪 Verifique la compatibilidad de un paquete con un canal específico en Capgo Cloud para asegurarse de que las actualizaciones sean seguras.

Ejemplo:

npx @capgo/cli@latest bundle compatibility com.example.app --channel production

Opciones:

Parámetro	Tipo	Descripción
-a	string	API clave para vincular a su cuenta
-c	string	Canal para verificar la compatibilidad con
—texto	boolean	Mostrar texto en lugar de emojis
—package-json	string	Rutas a archivos package.json para proyectos monorepo (separados por comas)
—node-modules	string	Rutas a directorios node_modules para proyectos monorepo (separados por comas)
—supa-host	string	URL de host personalizado de Supabase (para autohosteo o Capgo desarrollo)
—supa-anon	string	Clave anonima personalizada de Supabase (para autohosteo)

🔹 Tipo de liberación

npx @capgo/cli@latest bundle releaseType

🧭 Imprimir “nativo” o “OTA” según la compatibilidad con los metadatos más recientes de un canal.

Ejemplo:

npx @capgo/cli@latest bundle releaseType com.example.app --channel production

Opciones:

Parámetro	Tipo	Descripción
-a	string	API key to link to your account
-c	string	Canal para comparar contra
—package-json	string	Rutas a archivos package.json para proyectos monorepo (separadas por comas)
—node-modules	string	Rutas a directorios node_modules para proyectos monorepo (separadas por comas)
—supa-host	string	URL de host personalizado de Supabase (para autohosteo o desarrollo Capgo)
—supa-anon	string	Clave anonima personalizada de Supabase (para autohosteo)

🗑️ Eliminar

Alias: d

npx @capgo/cli@latest bundle delete

🗑️ Eliminar un paquete específico de Capgo Cloud, opcionalmente dirigido a una sola versión.

Ejemplo:

npx @capgo/cli@latest bundle delete BUNDLE_ID com.example.app

Opciones:

Parámetro	Tipo	Descripción
-a	string	La clave API 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)

📋 Lista

Alias: l

npx @capgo/cli@latest bundle list

📋 Lista todos los paquetes subidos para una aplicación en Capgo Cloud.

Ejemplo:

npx @capgo/cli@latest bundle list com.example.app

Opciones:

Parámetro	Tipo	Descripción
-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)

🧹 Limpiar

Alias: c

npx @capgo/cli@latest bundle cleanup

🧹 Elimina paquetes antiguos en Capgo Cloud, conservando el número especificado de versiones recientes. Los paquetes vinculados a canales se preservan a menos que se utilice —ignore-channel.

Ejemplo:

npx @capgo/cli@latest bundle cleanup com.example.app --bundle=1.0 --keep=3

Opciones:

Parámetro	Tipo	Descripción
-b	string	Versión del paquete del aplicación a eliminar
-a	string	API clave para vincular a tu cuenta
-k	string	Número de versiones a mantener
-f	boolean	Eliminación forzada
—ignore-channel	boolean	Elimina paquetes incluso si están vinculados a canales (ADVERTENCIA: elimina canales también)
—supa-host	string	URL de host personalizado de Supabase (para autohosteo o Capgo desarrollo)
—supa-anon	string	Clave de anonimato personalizada de Supabase (para autohosteo)

🔒 Cifrar

npx @capgo/cli@latest bundle encrypt

🔒 Cifra un paquete zip para almacenamiento seguro externo. Devuelve ivSessionKey para subir/descifrar. Obtén checksum usando ‘paquete zip —json’.

Ejemplo:

npx @capgo/cli@latest bundle encrypt ./myapp.zip CHECKSUM

Opciones:

Parámetro	Tipo	Descripción
—clave	string	Ruta personalizada para la clave de firma privada
—clave-datos	string	Clave de firma privada
-j	boolean	Salida en formato JSON
—package-json	string	Rutas a archivos package.json para monorepos (separadas por comas)

🔓 Desencriptar

npx @capgo/cli@latest bundle decrypt

🔓 Desencripta un paquete cifrado (principalmente para pruebas). Imprime la clave de sesión base64 para su verificación.

Ejemplo:

npx @capgo/cli@latest bundle decrypt ./myapp_encrypted.zip CHECKSUM

Opciones:

Parámetro	Tipo	Descripción
—llave	string	Ruta personalizada para la llave de firma privada
—llave-datos	string	Llave de firma privada
—checksum	string	Checksum del paquete, para verificar la integridad del paquete
—package-json	string	Rutas a archivos package.json para proyectos monorepos (separados por comas)

🔹 Zip

npx @capgo/cli@latest bundle zip

🗜️ Crea un archivo zip de tu paquete de la aplicación. Devuelve un checksum para uso con cifrado. Utiliza —json para obtener un resultado legible por máquinas.

Ejemplo:

npx @capgo/cli@latest bundle zip com.example.app --path ./dist

Opciones:

Parámetro	Tipo	Descripción
-p	string	Ruta del folder para subir, si no se proporciona se utilizará el webDir establecido en capacitor.config
-b	string	Número de versión para empaquetar para nombrar el archivo zip
-n	string	Nombre del archivo zip
-j	boolean	Salida en JSON
—no-code-comprobación	boolean	Ignorar la comprobación de si notifyAppReady() se llama en el origen code y el índice presente en la carpeta raíz
—key-v2	boolean	Usar cifrado v2
—package-json	string	Rutas a los archivos package.json para repositorios monolíticos (separados por comas)