📦 paquete

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

⬆️ Subir

Alias: u

npx @capgo/cli@latest bundle upload

⬆️ Subir una nueva aplicación empaquetada 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: Almacenar solo un enlace de URL (útil para aplicaciones >200MB o requisitos de privacidad). Capgo nunca inspecciona contenido externo. Agregar cifrado para seguridad sin confianza.

Ejemplo:

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

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	Canal 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 la clave de sesión para la URL de paquete externa
—s3-region	string	Región para tu contenedor S3
—s3-apikey	string	llave API para tu punto de conexión S3
—s3-apisecret	string	llave secreta API 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)
—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 en claro
—no-code-check	boolean	Ignora la verificació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
—enlace	string	Enlace a recurso externo (por ejemplo, GitHub versión de lanzamiento)
—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 mínima 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 la metadata en el canal
—versión mínima de actualización automática	boolean	Establecer la versión mínima de actualización basada en paquetes nativos
—ignorar comprobación de metadata	boolean	Ignora la comprobación de metadata (node_modules) al subir
—ignorar comprobación de suma de verificación	boolean	Ignores el chequeo de checksum cuando se sube
–force-crc32-checksum	boolean	Forzar checksum CRC32 para la subida (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 subir a S3
–zip	boolean	Subir el paquete utilizando zip a Capgo cloud (legado)
–tus	boolean	Subir el paquete utilizando TUS a Capgo cloud
–tus-tamaño-de-pieza	string	Tamaño de bloque en bytes para subidas de archivos resumibles de TUS (predeterminado: auto)
—parcial	boolean	[DEPRECADO] Utilice —delta en su lugar. Subir actualizaciones incrementales
—parcial-solo	boolean	[DEPRECADO] Utilice —delta-solo en su lugar. Subir solo actualizaciones incrementales, omitir paquete completo
—delta	boolean	Subir actualizaciones delta (solo archivos modificados) para actualizaciones instantáneas y muy rápidas en lugar de descargas de archivos zip grandes
—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 Direct Update está habilitado
—checksum-verificado-criptografado	string	Un resumen 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 de 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)
—encrypt-partial	boolean	Cifrar archivos de actualización delta (habilitado automáticamente para actualizadores > 6.14.4)
—delete-linked-bundle-on-upload	boolean	Ubica el paquete actualmente vinculado 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 actualizador lo permite
—version-exists-ok	boolean	Sale con éxito si la versión del paquete ya existe, útil para flujos de trabajo CI/CD con repositorios monolíticos
—self-assign	boolean	Permite que los dispositivos se unan automáticamente a este canal (actualiza la configuración del canal)
—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)
—verbose	boolean	Habilitar salida detallada con registro de depuración

🧪 Compatibilidad

npx @capgo/cli@latest bundle compatibility

🧪 Verificar 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	Canales para verificar la compatibilidad con
—texto	boolean	Mostrar texto en lugar de emojis
—package-json	string	Rutas a archivos package.json para monorepos (separadas por comas)
–módulos-nodo	string	Rutas a directorios node_modules para monorepos (separadas por comas)
–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)

🔹 Tipo de Lanzamiento

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 monorepos (separadas por comas)
—módulos-nodo	string	Rutas a directorios node_modules para monorepos (separadas por comas)
—anfitrión-supabase	string	URL de anfitrión personalizado de Supabase (para auto-hospedaje o Capgo desarrollo)
—llave-anon-supabase	string	Eliminar

🗑️ Sección titulada “ Eliminar”

Ventana de terminal 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 de anonimato 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:

Parametro	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)

🧹 Limpieza

Alias: c

npx @capgo/cli@latest bundle cleanup

🧹 Eliminar paquetes antiguos en Capgo Cloud, conservando el número especificado de versiones recientes. Los paquetes vinculados a canales se conservan 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	clave de API para vincular a tu cuenta
-k,	string	Número de versiones a mantener
-f,	string	Forzar eliminación
—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 autohosteo o Capgo desarrollo)
—supa-anon	string	Clave de anonimo personalizada de Supabase (para autohosteo)

🔒 🔒 Cifrar

npx @capgo/cli@latest bundle encrypt

🔒 Cifra un paquete zip para almacenamiento externo seguro. 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
—llave	string	Ruta personalizada para la llave de firma privada
—llave-datos	string	Llave 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). 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
—clave	string	Ruta personalizada para la clave de firma privada
—clave-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 (separados por comas)

🔹 Zip

npx @capgo/cli@latest bundle zip

🗜️ Crea 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 folder a subir, si no se proporciona se utilizará el webDir establecido en capacitor.config
-b,	string	Versión del paquete para nombrar el archivo zip
-n,	string	Nombre del archivo zip
-j,	string	Salida en formato JSON
---sin-verificar-code---	boolean	Ignorar la verificación de si se llama notifyAppReady() en la fuente code y el índice presente en la carpeta raíz
---clave-v2	boolean	Usar cifrado v2
---package-json	string	Rutas a archivos package.json para proyectos monorepos (separados por comas)

Sigue desde el paquete

Si estás utilizando paquete para planificar la seguridad y la conformidad, conecta con Cifrado para el detalle de implementación en Criptografía, Cumplimiento para el detalle de implementación en Cumplimiento, Capgo Escáner de Seguridad para el flujo de trabajo del producto en Capgo Escáner de Seguridad, Capgo Seguridad para el flujo de trabajo del producto en Capgo Seguridad, y Capgo Centro de Confianza para el flujo de trabajo del producto en Capgo Centro de Confianza.