Tipos de actualizaciones

Instale

Capgo admite varios tipos de actualizaciones por aire (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 descargarla. 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 ese intervalo (por defecto 10 minutos).

Tipo	Descripción	Uso
autoUpdate: `atBackground`	Verificar y descargar en cada verificación de primer plano, aplicar cuando la aplicación se mueve al segundo plano	La mayoría de las aplicaciones; interrupción mínima
__CAPGO_KEEP_0__ `atInstall`	Aplicar inmediatamente solo después de una instalación fresca o actualización de tienda de aplicaciones nativa; en caso contrario, utilice `atBackground`	Los nuevos usuarios obtienen la versión más reciente; los usuarios existentes utilizan aplicar en segundo plano
__CAPGO_KEEP_0__ `onLaunch`	Aplicar inmediatamente solo en arranque frío (killed → foreground); luego caiga en la opción de `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	Las 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'
  }
}

Condiciones de retraso

Condiciones que deben cumplirse antes de que se active la actualización Se instala una actualización. Utilice setMultiDelay para combinarlos (deben satisfacerse todas las condiciones).

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
Versión nativa	Requiere una versión mínima de binario nativo	Bloquear actualizaciones en binarios nativos incompatibles con code
kill	Esperar a la próxima señal de muerte de la aplicación	Aplicar 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' },
  ],
});

Bloqueo de versión (Política de canal)

Controla qué actualizaciones semver un canal auto-enviará. 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	Más mayor que `version_build`, por ejemplo `1.2.3 -> 2.0.0`	Con el mismo mayor, por ejemplo `1.2.3 -> 1.9.0` o `1.2.3 -> 1.2.4`	evitar cambios que rompan la compatibilidad con versiones antiguas de code
menor	Diferente mayor o menor que `version_build`, por ejemplo `1.2.3 -> 1.3.0`	Con el mismo mayor y menor, por ejemplo `1.2.3 -> 1.2.4`	Mantener actualizaciones dentro de una línea menor de __CAPGO_KEEP_0__
patch	Cualquier cambio en el número mayor, menor o de parche, por ejemplo `1.0.0 -> 1.0.1`	Solo cambian los sufijos 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`	en modo estricto: sin movimiento de versión de núcleo
metadatos	faltante `min_update_version`o `version_build` debajo de él	Paquete objetivo cuyo `min_update_version` es menor o igual a `version_build`	Reglas de compatibilidad personalizadas por paquete

Estos controles comparan el paquete objetivo contra la base de línea nativa enviada como version_build, no el paquete descargado instalado enviado como version_name.

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

Tipos de entrega

Cómo se transfiere el paquete al dispositivo.

Tipo	Descripción	Cuándo usar
Paquete completo	Se descarga el paquete JS completo	Primera instalación, cambios grandes, o cuando no está disponible el delta
Delta (manifest)	Solo se descargan los archivos modificados	La mayoría de las 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

para minimizar el tiempo de descarga y mejorar la UX.

Categoría	Tipos
Aplicar el momento	`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)

— Configurar el momento de aplicación y los retrasos Entrega de empresa
Versión Dirigida — Ruta de Versión Basada en Canal
Actualizaciones (Delta) (manifest) — Habilitar Descargas Parciales
Canal Canal de Actualización

— Configuración y Precedencia de Canales

Continúa desde Tipos de Actualizaciones Si estás utilizando Tipos de Actualizaciones para planificar la entrega de actualizaciones en vivo, conecta con ella a las actualizaciones en vivo de Capgo 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 la Actualización para el detalle de implementación en Comportamiento de la Actualización, y Iniciar sesión Anterior