📦 paquete

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

⬆️ Subir

Alias: u

npx @capgo/cli@latest bundle upload

⬆️ Sube 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: Almacena solo un enlace de URL (útil para aplicaciones >200MB o requisitos de privacidad). Capgo nunca inspecciona contenido externo. Agrega cifrado para seguridad sin confianza.

Ejemplo:

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

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á la carpeta webDir configurada en capacitor.config
-c,	string	Canales para vincular
-e,	string	Vincular a una URL externa en lugar de subir a Capgo Cloud
—iv-session-key	string	Establecer la clave de inicialización y sesión para la URL de paquete externa
—región s3	string	Región para tu contenedor S3
—apikey s3	string	API clave de API para tu punto de conexión S3
—secret s3	string	API secreto para tu punto de conexión S3
—punto de conexión s3	string	URL del punto de conexión S3
—nombre del contenedor s3	string	Nombre para tu contenedor S3 de AWS
—puerto s3	string	Puerto para tu punto de conexión S3
—no-s3-ssl	boolean	Desactivar SSL para subir a 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	Ignorar la clave de firma y enviar actualización clara
—no-code-check	boolean	Ignorar la comprobació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 de sesión y de IV utilizada para cifrar la actualización
-b,	string	Número de versión del paquete a subir
—enlace	string	Enlace a un recurso externo (por ejemplo, GitHub versión)
—comentario	string	Comentario sobre esta versión, podría ser una nota de lanzamiento, un hash de commit, un mensaje de commit, etc.
—versión-minima-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
—versión-minima-de-actualización-auto	boolean	Establece la versión mínima de actualización basada en paquetes nativos
—ignora-verificación-de-metadatos	boolean	Ignora la verificación de metadatos (node_modules) al subir
—ignora-verificación-de-código-intacto	boolean	Ignora la verificación de código intacto al subir
—force-crc32-verificación-de-código-intacto	boolean	Forzar verificación de código intacto CRC32 para subir (sobreescribir la detección automática)
—tiempo-limite	string	Tiempo límite para el proceso de subida en segundos
—multipart	boolean	Usa protocolo multipart para subidas a S3 (DEPRECATED: usa —tus en su lugar)
—zip	boolean	Sube el paquete utilizando zip a Capgo cloud (legado)
—tus	boolean	Sube el paquete utilizando TUS a Capgo nube
—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 de zip grandes
—delta-only	boolean	Sube solo actualizaciones delta sin paquete completo para la máxima velocidad (útil para aplicaciones grandes)
—no-delta	boolean	Deshabilitar actualizaciones delta incluso si Direct Update está habilitado
—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 paquete de manera seca, es decir, no subirá los archivos pero agregará la fila en la base de datos (Usado por Capgo para pruebas internas)
—package-json	string	Rutas a archivos package.json para proyectos monorepos (separados por comas)
—node-modules	string	Rutas a directorios node_modules para proyectos monorepos (separados por comas)
—cifrar-parte	boolean	Cifra archivos de actualización delta (habilitado automáticamente para el actualizador > 6.14.4)
—eliminar-enlace-de-bolsa-en-carga	boolean	Ubica la bolsa enlazada actualmente en el canal a subir, y la elimina
—no-patron-de-brotli	string	Archivos a excluir de la compresión Brotli (globos separados por comas, por ejemplo, “.jpg,.png”)
—desactivar-brotli	boolean	Desactiva completamente la compresión Brotli incluso si la versión del actualizador lo soporta
—existe-versión-ok	boolean	Sale con éxito si la versión de la bolsa ya existe, útil para flujos de trabajo de CI/CD con repositorios monolíticos
—auto-asigna	boolean	Permitir que los dispositivos se unan automáticamente a este canal (actualiza la configuración del canal)
—supa-anfitrión	string	URL del anfitrión de Supabase personalizado (para hospedaje propio o Capgo desarrollo)
—supa-clave-anonima	string	Clave anónima de Supabase personalizada (para hospedaje propio)
—detallado	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 su cuenta
-c,	string	Canal para verificar la compatibilidad con
—texto	boolean	Texto de salida en lugar de emojis
—package-json	string	Rutas de archivos package.json para monorepos (separadas por comas)
—node-modules	string	Rutas de directorios node_modules para monorepos (separadas 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 clave para vincular a tu cuenta
-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 Capgo desarrollo)
—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	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)

📋 Lista

Alias: l

npx @capgo/cli@latest bundle list

📋 Lista de 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)

🧹 Limpieza

Alias: c

npx @capgo/cli@latest bundle cleanup

🧹 Elimina los 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:

Parámetro	Tipo	Descripción
-b,	string	Número de 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,	string	Eliminación forzada
—ignore-channel	boolean	Eliminar paquetes incluso si están vinculados a canales (ADVERTENCIA: elimina canales tambié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)

🔒 Cifrar

npx @capgo/cli@latest bundle encrypt

Cifra un archivo zip para almacenamiento seguro externo. Devuelve ivSessionKey para subir/descifrar. Obtén 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,	string	Salida en formato JSON
—package-json	string	Rutas a archivos package.json para repositorios monolíticos (separadas por comas)

🔓 Desencriptar

npx @capgo/cli@latest bundle decrypt

🔓 Descifra 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:

Parámetro	Tipo	Descripción
—clave	string	Ruta personalizada para la clave de firma privada
—key-data	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 proyectos monorepos (separadas por comas)

🔹 Zip

npx @capgo/cli@latest bundle zip

Crear un archivo zip de tu paquete de la aplicación. Devuelve checksum para uso con cifrado. Utiliza —json para salida 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,	string	Salida en JSON
—no-code-comprobación	boolean	Ignorar la comprobación de si notifyAppReady() se llama en el archivo de origen code y el índice presente en la carpeta raíz
—clave-v2	boolean	Usar cifrado v2
—package-json	string	Rutas a los archivos package.json para repositorios monolíticos (separadas por comas)