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 cuándo 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 Controla ese intervalo (por defecto 10 minutos).

Tipo	Descripción	Uso
autoActualiza: atBackground	Verifica y descarga en cada verificación de primer plano, aplica cuando la aplicación se mueve al fondo	La mayoría de las aplicaciones; mínimo disturbio
autoActualiza: atInstall	Apply immediately only after a fresh install or native app store update; otherwise use atBackground	New users get latest; existing users use background apply
autoActualiza: onLaunch	Aplicar inmediatamente solo en arranque frío (killed → foreground); luego caer en la opción de atBackground	La balanza entre frescura y estabilidad de sesión
autoUpdate: always	Comprobar en cada transición de primer plano y aplicar inmediatamente siempre que esté disponible una actualización	Arreglos críticos, aplicaciones con estado simple
autoUpdate: onlyDownload	Comprobar y descargar automáticamente, emitir updateAvailableY nunca aplicar automáticamente	Aplicaciones que muestran su propia ventana de actualización o controlan exactamente cuándo llamar a set()

Configurar en capacitor.config.ts:

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

Consejo

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

Condiciones de Retraso

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

Estado	Descripción	Example
fecha	Espera hasta después de una fecha/hora específica	Sincronizar con la versión del servidor
fondo	Espera un mínimo de (ms) después de que la aplicación se ponga en segundo plano	Evita aplicar durante cambios rápidos de aplicación
versión nativa	Requiere una versión mínima de binario nativo	Block updates on incompatible native code
matar	Wait until the next app kill event	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

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

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	Blocks	Permite	Uso de caso
No hay	Nada	Cualquier versión del paquete objetivo	Actualización automática por defecto; actualización completa
Mayor que	Mayor que la versión version_buildpor ejemplo 1.2.3 -> 2.0.0	Mismo nivel mayor, por ejemplo 1.2.3 -> 1.9.0 O 1.2.3 -> 1.2.4	Prevenir cambios que rompan la compatibilidad con versiones nativas antiguas 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	Mantenga actualizaciones dentro de una línea menor nativa
patch	Cualquier cambio en el número mayor, menor o patch, 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	Modo más estricto: sin movimiento de versión de núcleo
metadata	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 metadata requiere una configuración cuidadosa. Consulte CLI comandos y Tipos de Actualización Sección titulada “Tipos de Entrega”

Cómo se transfiere

Cómo funciona se transfiere el paquete Tipos de Entrega

Tipo	Descripción	Cuándo usar
Paquete completo	Se descarga todo el paquete de JavaScript	Primera instalación, cambios grandes o cuando no está disponible el delta
Delta	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

Tip

Cuando se utilizan modos de aplicación instantánea ("atInstall, onLauncho alwaysHabilite) Actualizaciones delta to minimize download time and improve UX.

Referencia Rápida

Categoría	Tipos
Aplicar el reloj	off, atBackground, atInstall, onLaunch, always, onlyDownload
Condiciones de retraso	date, background, nativeVersion, kill
Actualización de versión	none, major, minor, patch, metadata
Entrega	Paquete completo, Delta

Relacionado

• Comportamiento de la actualización — Configurar el momento de aplicación y los retrasos
• Alcance de versión — Ruta de versión basada en canal
• Actualizaciones Delta Actualizaciones Delta
• Channels — Configuración y prioridad del canal

Continúa desde Tipos de actualizaciones

Si estás utilizando Tipos de actualizaciones para planificar la entrega de live update, conecta con Capgo Actualizaciones en vivo para el flujo de trabajo del producto en Capgo Actualizaciones en vivo Overview para los detalles de implementación en Resumen Features para los detalles de implementación en Características Comportamiento de la Actualización para el detalle de implementación en Comportamiento de la Actualización, y Getting Started para el detalle de implementación en Empezar.