📦 paquete

📦 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 una URL de enlace (ú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

Incrementar automáticamente la siguiente versión semver gratuita desde el canal (o la última versión de aplicación remota) cuando no se pase --bundleÚtil en CI cuando package.json ya coincide con una versión Capgo que tiene:

npx @capgo/cli@latest bundle upload --channel=production --auto-bump
npx @capgo/cli@latest bundle upload --auto-bump major
npx @capgo/cli@latest bundle upload --auto-bump minor   # default when the flag has no value
npx @capgo/cli@latest bundle upload --auto-bump patch   # alias: fix
npx @capgo/cli@latest bundle upload --auto-bump metadata
npx @capgo/cli@latest bundle upload --channel=production --auto-bump ai

Con --auto-bump ai, Capgo Cloudflare Los trabajadores de IA comparan los archivos de paquete locales con el delta de manifiesto de canal anterior Capgo, infiere major | minor | patch | metadatay imprime una breve razón en el CLI registro. Si no existe ninguna versión Capgo anterior, la IA se omite y el incremento se establece en patch.

Opciones:

Parámetro	Tipo	Descripción
-a	string	API clave para vincular a tu cuenta
-p	string	Ruta del carpeta para subir, si no se proporciona se utilizará la carpeta webDir configurada en capacitor.config
-c	string	Canales a vincular. Utiliza comas para múltiples canales, por ejemplo producción,beta
—despliegue	string	Establece el paquete subido como objetivo de despliegue de este canal a un porcentaje del 0 al 100
—estable	boolean	En un canal configurado para rollout, reemplaza el fallback estable en lugar de establecer el objetivo de rollout
—porcentaje-de-rolloout-en-bps	string	Establece el porcentaje de rollout del paquete cargado en puntos base desde 0 a 10000
—ttl-de-cache-de-rolloout-en-segundos	string	Cloudflare TTL de cache de decisión de rollout en segundos
-e	string	Enlaza a una URL externa en lugar de cargar en Capgo Cloud
—clave-de-sesión-y-IV	string	Establece la clave de IV y de sesión para la URL del paquete
—región-de-S3	string	Región para tu contenedor S3
—clave-API-de-S3	string	llave API para su punto de conexión S3
—s3-apisecret	string	llave secreta API para su punto de conexión S3
—s3-endpoint	string	dirección URL del punto de conexión S3
—s3-bucket-name	string	nombre para su contenedor de S3 de AWS
—s3-port	string	puerto para su 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)
—key-data-v2	string	Clave de firma privada (sistema v2)
—bundle-url	boolean	Imprime la URL del paquete en la salida estándar
—no-key	boolean	Ignora la clave de firma y envía la actualización clara
—no-code-check	boolean	Ignora la comprobación de si notifyAppReady() se llama en la fuente code y el índice presente en la carpeta raíz
—display-iv-session	boolean	Muestra en la consola la clave de IV y la sesión utilizadas para cifrar la actualización
-b	string	Número de versión del paquete para subir
—auto-bump	string	Incrementa automáticamente desde el paquete vinculado del canal, o la última versión remota de la aplicación. Nivel: mayor, menor (por defecto), parche (alias reparo), metadatos o ai (Workers AI infiere el nivel del delta de manifest local vs anterior; cae en parche si no hay una versión anterior Capgo). Incrementa hasta encontrar un nombre libre (los nombres eliminados ocupan nombres). No se puede combinar con —paquete (-b)
—link	string	Enlace a recurso externo (por ejemplo, GitHub release)
—comment	string	Comentario sobre esta versión, podría ser una nota de lanzamiento, un hash de commit, un mensaje de commit, etc.
—min-update-version	string	Versión mínima requerida para actualizar a esta versión. Se utiliza solo si se establece la actualización automática en metadatos en el canal
—auto-min-update-version	boolean	Establece la versión de actualización mínima basada en paquetes nativos
—ignore-metadata-check	boolean	Ignores la verificación de metadatos (node_modules) al subir
—fail-on-incompatible	boolean	Fallar la subida (salir con código no cero) en lugar de subir cuando el paquete es incompatible con los paquetes nativos actuales del canal. En una terminal interactiva, todavía puedes elegir una compilación nativa; rechazar falla.
—ignore-checksum-check	boolean	Ignores la verificación de checksum cuando se sube
—force-crc32-checksum	boolean	Forzar el checksum CRC32 para la subida (sobreescribir la detección automática)
—timeout	string	Tiempo de espera para el proceso de subida en segundos
—multipart	boolean	[DEPRECATED] Use —tus en su lugar. Utiliza el protocolo multipart para subidas a S3
—zip	boolean	Sube el paquete utilizando zip a Capgo cloud (legacy)
—tus	boolean	Sube el paquete utilizando TUS a Capgo cloud
—tus-chunk-size	string	Tamaño de chunk en bytes para subidas de TUS resumibles (predeterminado: auto)
—partial	boolean	[DEPRECATED] Utiliza —delta en su lugar. Sube actualizaciones incrementales
—partial-only	boolean	[DEPRECATED] Utiliza —delta-only en su lugar. Sube solo actualizaciones incrementales, ignora el paquete completo
—delta	boolean	Sube actualizaciones delta (solo archivos modificados) para actualizaciones instantáneas y muy rápidas en lugar de descargas grandes de zip
—delta-only	boolean	Subir solo actualizaciones delta sin el paquete completo para la máxima velocidad (útil para aplicaciones grandes)
—no-delta	boolean	Deshabilitar actualizaciones delta incluso si se han habilitado las actualizaciones instantáneas
—encrypted-checksum	string	Un checksum cifrado (firma). Se utiliza solo cuando se sube un paquete externo.
—auto-set-bundle	boolean	Establecer el paquete en capacitor.config.json
—dry-upload	boolean	Subir el proceso del paquete de manera seca: agregar la fila en la base de datos sin subir archivos ni actualizar canales (Usado por Capgo para pruebas internas)
—package-json	string	Rutas a archivos package.json para repositorios monolíticos (separados por comas)
—node-modules	string	Rutas a los directorios node_modules para proyectos monorepo (separados por comas)
—encrypt-partial	boolean	Cifrar archivos de actualizaciones delta (habilitado automáticamente para updater > 6.14.4)
—delete-linked-bundle-on-upload	boolean	Localiza el paquete vinculado actualmente en el canal al que intenta subir y lo elimina
—no-brotli-patterns	string	Archivos a excluir de la compresión Brotli (globs separados por comas, por ejemplo, “.jpg,.png”)
—disable-brotli	boolean	Deshabilita completamente la compresión Brotli incluso si la versión del updater lo permite
—version-exists-ok	boolean	Salir con éxito si ya existe la versión del paquete, útil para flujos de trabajo de CI/CD con repositorios monolíticos
—autoasignar	boolean	Permitir a los dispositivos unirse automáticamente a este canal (actualizar la configuración del canal)
—preview de 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 los dispositivos después de actualizar los paquetes vinculados de canales
—supa-host personalizado	string	URL de host personalizado de Supabase (para autohosteo o desarrollo Capgo)
—supa-anon personalizado	string	Clave anon personalizada de Supabase (para autohosteo)
—verbose	boolean	Habilite 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 tu 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 monorepos (separadas por comas)
—node-modules	string	Rutas a directorios node_modules para proyectos monorepos (separadas por comas)
—supa-host	string	URL de host personalizado de Supabase (para autohospedaje o Capgo desarrollo)
—supa-anon	string	Clave anonima personalizada de Supabase (para autohospedaje)

🔹 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 clave para vincular a tu cuenta
–c	string	Canales para comparar
–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 autohospedaje o desarrollo Capgo)
—supa-anon	string	Clave anonima personalizada de Supabase (para autohospedaje)

🗑️ 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:

Param	Tipo	Descripción
-a	string	API clave para vincular a tu cuenta
—supa-host	string	URL de host personalizado de Supabase (para autohospedaje o Capgo desarrollo)
—supa-anon	string	Clave anonima personalizada de Supabase (para autohospedaje)

📋 Lista

Alias: l

npx @capgo/cli@latest bundle list

📋 Listar 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 tu cuenta
—supa-host	string	URL de host personalizado de Supabase (para autohospedaje o Capgo desarrollo)
—supa-anon	string	Clave anonima personalizada de Supabase (para autohospedaje)

🧹 Limpiar

Alias: c

npx @capgo/cli@latest bundle cleanup

🧹 Elimina paquetes antiguos en Capgo Cloud, manteniendo 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:

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

🔒 Cifrar

npx @capgo/cli@latest bundle encrypt

🔒 Cifra un archivo zip para almacenamiento seguro externo. Devuelve ivSessionKey para subir/descifrar. Obtén el checksum usando ‘bundle 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 proyectos monorepos (separadas por comas)

🔓 Desencriptar

npx @capgo/cli@latest bundle decrypt

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

Ejemplo:

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

Opciones:

Param	Tipo	Descripción
—clave	string	Ruta personalizada para la clave de firma privada
—clave-de-datos	string	Clave de firma privada
—checksum	string	Checksum del paquete, para verificar la integridad del paquete
—package-json	string	Rutas a archivos package.json para repositorios monolíticos (separadas por comas)

🔹 Zip

npx @capgo/cli@latest bundle zip

🗜️ Crea un archivo zip de tu paquete de la aplicación. Devuelve el checksum para uso con la cifrado. Utiliza —json para 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 directorio para subir, si no se proporciona se utilizará la carpeta webDir configurada en capacitor.config
-b	string	Número de versión del paquete para nombrar el archivo zip
-n	string	Nombre del archivo zip
-j	boolean	Salida en formato JSON
—no-code-check	boolean	Ignorar la comprobación de si se llama a notifyAppReady() en el archivo de origen code y el índice presente en la carpeta raíz
—key-v2	boolean	Usar cifrado v2
—package-json	string	Rutas a archivos package.json para monorepos (separadas por comas)