Tipos de Actualización

Capgo supports several types of over-the-air (OTA) updates. This page lists and explains all of them so you can choose the right combination for your app.

Actualizaciones sobre la red (OTA)

Controles cuando se aplica una actualización 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 ese intervalo (por defecto 10 minutos).

Tipo	Descripción	Uso de Caso
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
autoUpdate: atInstall	Sólo aplique inmediatamente después de una instalación fresca o actualización de la tienda de aplicaciones nativas; en caso contrario, utilice atBackground	Los nuevos usuarios obtienen la versión más reciente; los usuarios existentes utilizan la aplicación de fondo
autoUpdate: onLaunch	Sólo aplique inmediatamente al inicio frío (matado → frente); luego caiga hacia atrás a atBackground	Equilibrio entre frescura y estabilidad de sesión
autoUpdate: always	Verifique en cada transición de primer plano y aplique inmediatamente siempre que esté disponible una actualización	Arreglos críticos, aplicaciones con estado simple
autoUpdate: onlyDownload	Verifique y descargue automáticamente, emita updateAvailable, y nunca aplique automáticamente	Aplicaciones que muestran su propio prompt de actualización o controlan exactamente cuándo llamar set()

Configuración 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 la aplicación
versión nativa	Requiere una versión mínima de binario nativo	Bloquea actualizaciones en binarios nativos incompatibles code
Matar	Espera hasta que se produzca el próximo evento de matar 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' },
  ],
});

Peligro

El kill La condición se activa después del primer evento de matar, 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 las actualizaciones de semver un canal se entregará automáticamente. Establecido a través de --disable-auto-update en canales.

Estrategia	Bloques	Permite	Uso de Caso
ninguno	Nada	Cualquier versión de paquete objetivo	Predeterminado; actualización completa
mayor	Mayor que la mayor version_buildpor ejemplo 1.2.3 -> 2.0.0	Con el mismo número mayor, por ejemplo 1.2.3 -> 1.9.0 o 1.2.3 -> 1.2.4	Prevenir cambios importantes de llegar a nativos antiguos code
menor	Diferente número mayor o menor que version_buildpor ejemplo 1.2.3 -> 1.3.0	Con el mismo número mayor y menor, por ejemplo 1.2.3 -> 1.2.4	Mantener actualizaciones dentro de una línea de minor nativa
patch	Cualquier cambio de número mayor, menor o patch, por ejemplo 1.0.0 -> 1.0.1	Solo cambios de sufijo mientras MAJOR.MINOR.PATCH se mantiene idéntico, 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: no hay movimiento de versión de core
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

Estas comprobaciones comparan el paquete objetivo contra 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 metadata requiere una configuración cuidadosa. Consulte comandos CLI y Tipos de versión para obtener más detalles.

Tipos de entrega

How the bundle is transferred to the dispositivo. Tipo Descripción

Cuándo usar	Bundle completo	Se descarga el conjunto completo de JS.
Primera instalación, cambios grandes o cuando no está disponible el delta.	Delta (manifesto)	Solo se descargan los archivos modificados.
Actualizaciones más comunes; más rápido y amigable con la banda.	Entire JS bundle is downloaded	Most updates; faster and bandwidth-friendly

# 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 retardo	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
• Versionamiento objetivo — Ruta de versión basada en canal
• Actualizaciones (manifesto) Delta — 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 los detalles de implementación en Overview Características para los detalles de implementación en Características Comportamiento de Actualización para los detalles de implementación en Comportamiento de Actualización, y Inicio Rápido para los detalles de implementación en Inicio Rápido.