Tipos de actualización

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

Aplicar Momento

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 los controles que establecen 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; mínimo interrupción
__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 (matado → frente); luego caiga en 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 updateAvailabley nunca se aplican automáticamente	Las aplicaciones que muestran su propia solicitud 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 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 la aplicación
versión nativa	Requiere una versión mínima de binario nativo	Bloquear actualizaciones en binarios nativos incompatibles con code
Peligro	Peligro	El

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

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

Requiere una versión mínima de binario nativo

Bloquear actualizaciones en binarios nativos incompatibles con __CAPGO_KEEP_0__ kill Peligro

El

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

Táctica	Bloquea	Permite	Uso de Caso
ninguno	Nada	Cualquier versión de paquete objetivo	Predeterminado; actualización completa
principal	Más principal que version_build, por ejemplo 1.2.3 -> 2.0.0	Lo mismo principal, por ejemplo 1.2.3 -> 1.9.0 o 1.2.3 -> 1.2.4	Prevenir cambios que rompan desde versiones nativas antiguas code
menor	Diferente principal o menor que version_build, por ejemplo 1.2.3 -> 1.3.0	Lo mismo principal y menor, por ejemplo 1.2.3 -> 1.2.4	Mantener actualizaciones dentro de una línea menor nativa
corrección	Cualquier cambio en el número mayor, menor o de parche, por ejemplo 1.0.0 -> 1.0.1	Solo cambios de sufijo 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 core
metadatos	Faltante min_update_version, o version_build debajo de él	Bundle objetivo cuyo min_update_version es menor o igual a version_build	Reglas de compatibilidad personalizadas por bundle

Estos controles comparan el paquete objetivo contra la base nativa enviada como version_buildno el paquete descargado actualmente instalado enviado como version_name.

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

Cuidado

patch y metadata requieren una configuración cuidadosa. Consulte CLI comandos y Versiones objetivo para obtener más detalles.

Tipos de entrega

¿Cómo se transfiere el paquete a la 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 (manifesto)	Solo se descargan los archivos modificados	La mayoría de las actualizaciones; más rápido y amigable 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

Al utilizar 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
Aplicar retardo	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

• Comportamiento de actualización — Configurar retardo de aplicación y retrasos
• Versión Dirigida — Ruta de versión basada en canal
• Actualizaciones de Delta (manifest) — Habilitar descargas parciales
• Canales — Configuración y precedencia de canales

Sigue 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 el detalle de implementación en Comportamiento de Actualización, y Empezar para el detalle de implementación en Empezar.