Tipos de Actualización

Capgo admite varios tipos de actualizaciones por cable (OTA). Esta página enumera y explica todos ellos para que puedas elegir la combinación adecuada para tu aplicación.

Aplicar Tiempo

Controles cuando una actualización se aplica después de que se descarga. El plugin verifica actualizaciones cuando la aplicación se mueve al primer plano y en un temporizador repetido mientras la aplicación permanece abierta. periodCheckDelay controles que intervalo (por defecto 10 minutos).

Tipo	Descripción	Uso de Caso
autoUpdate: atBackground	Verificar y descargar en cada comprobación de primer plano, aplicar cuando la aplicación se mueve al segundo plano	La mayoría de las aplicaciones; mínima interrupción
autoUpdate: atInstall	Aplicar inmediatamente solo después de una instalación fresca o actualización de tienda de aplicaciones nativa; de lo contrario, utilice atBackground	Nuevos usuarios obtienen la versión más reciente; usuarios existentes utilizan aplicar en segundo plano
autoUpdate: onLaunch	Aplicar inmediatamente solo en arranque frío (matar → primer plano); luego caer en la aplicación a fallar a atBackground	Equilibrio entre frescura y estabilidad de sesión
__CAPGO_KEEP_0__ always	Verificar en cada transición de primer plano y aplicar inmediatamente siempre que esté disponible una actualización	Arreglos críticos, aplicaciones con estado simple
__CAPGO_KEEP_0__ onlyDownload	Verificar y descargar automáticamente, emitir updateAvailable, y nunca aplicar automáticamente	Aplicaciones que muestran su propio prompt de actualización o controlan exactamente cuándo llamar set()

Configurar en capacitor.config.ts:

plugins: {
  CapacitorUpdater: {
    autoUpdate: 'atBackground', // default; true is still accepted
    // or: 'off' | 'atInstall' | 'onLaunch' | 'always' | 'onlyDownload'
  }
}

Consejo

Para obtener detalles completos y manejo de pantalla de bienvenida, consulte Comportamiento de Actualización.

Condiciones de Retraso

Condiciones que deben cumplirse antes de que se instale una actualización. Utilice setMultiDelay para combinarlas (todas las condiciones deben satisfacerse).

Condición	Descripción	Ejemplo
fecha	Espera hasta después de una fecha/hora específica	Coordina con la liberación del lado del servidor
fondo	Espera un mínimo de duración (ms) después de que la aplicación esté en segundo plano	Evita aplicar durante cambios rápidos de aplicación
nativeVersion	Requiere una versión mínima de binario nativo	Bloquea actualizaciones en binarios nativos incompatibles code
kill	Espera hasta el próximo evento de matar la aplicación	Aplica solo en reinicio completo

import { CapacitorUpdater } from '@capgo/capacitor-updater';

await CapacitorUpdater.setMultiDelay({
  delayConditions: [
    { kind: 'date', value: '2023-06-01T00:00:00.000Z' },
    { kind: 'background', value: '60000' },
  ],
});

Peligro

La kill La condición desencadena después del primer evento de muerte, no el próximo de fondo como los demás. Esto se corregirá en una futura versión.

Bloqueo de Versión (Política de Canal)

Controla actualizaciones semver a un canal le entregará automáticamente. Establecido a través de --disable-auto-update en canales.

Estrategia	Bloquea	Permite	Uso de Caso
ninguno	Nada	Cualquier versión de paquete objetivo	Predeterminado; actualización completa automática
mayor	Mayor que la versión mayor version_buildpor ejemplo 1.2.3 -> 2.0.0	Igual que la versión mayor, por ejemplo 1.2.3 -> 1.9.0 o 1.2.3 -> 1.2.4	Prevenir cambios que rompen de llegar a nativos antiguos code
menor	Diferente mayor o menor que version_build, por ejemplo 1.2.3 -> 1.3.0	Igual mayor y menor, por ejemplo 1.2.3 -> 1.2.4	Mantener actualizaciones dentro de una línea nativa menor
patch	Cualquier cambio de número mayor, menor o de parche, por ejemplo 1.0.0 -> 1.0.1	Solo cambios en la sufija mientras MAJOR.MINOR.PATCH se mantiene igual, por ejemplo 1.0.0-beta.1 -> 1.0.0-beta.2 o 1.0.0+build.1 -> 1.0.0+build.2	Modo más estricto: sin movimiento de versión de núcleo
metadatos	Faltante min_update_version, o version_build debajo de ella	Paquete objetivo cuyo min_update_version es menor o igual a version_build	Reglas de compatibilidad personalizadas por paquete

Estas comprobaciones comparan el paquete objetivo con la base nativa enviada como version_build, no el paquete descargado y actualmente instalado enviado como version_name.

npx @capgo/cli channel set production --disable-auto-update major

Cuidado

patch y requiere una configuración cuidadosa. Consulte metadata __CAPGO_KEEP_0__ comandos CLI commands Tipos de versión Sección titulada “Tipos de versión” Cómo se transfiere

el paquete a la dispositivo.

and require careful setup. See __CAPGO_KEEP_0__ commands

and	Descripción	Cuándo usar
Paquete completo	Se descarga todo el paquete JS	Primera instalación, cambios grandes o cuando no está disponible el delta
Delta (manifesto)	Solo se descargan los archivos modificados	Actualizaciones más rápidas y amigables con la banda ancha

# Full bundle (default)
npx @capgo/cli bundle upload --channel production

# Delta updates
npx @capgo/cli bundle upload --channel production --delta

Consejo

Cuando se utiliza los modos de aplicación instantánea (atInstall, onLaunch, o always), habilite Actualizaciones Delta para minimizar el tiempo de descarga y mejorar la experiencia del usuario.

Referencia rápida

Categoría	Tipos
Tiempo de aplicación	off, atBackground, atInstall, onLaunch, always, onlyDownload
Condiciones de retraso	date, background, nativeVersion, kill
Bloqueo de versión	none, major, minor, patch, metadata
Entrega	Paquete completo, Delta (manifesto)

Relacionado

• Actualizar Comportamiento — Configurar el momento de aplicación y los retrasos
• Versión Dirigida — Ruta de versión basada en canales
• Actualizaciones de Delta (manifesto) — Habilitar descargas parciales
• Canales — Configuración y precedencia de canales

Sigue adelante desde Tipos de Actualización

Si estás utilizando Tipos de Actualización para planificar la entrega de actualizaciones en vivo, conecta con Capgo Actualizaciones en Vivo para el flujo de trabajo del producto en Capgo Actualizaciones en Vivo, Resumen para el detalle de implementación en Resumen, Características para el detalle de implementación en Características Comportamiento de Actualización para los detalles de implementación en Update Behavior, y Inicio para los detalles de implementación en Inicio.