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 Retraso

Controles cuando una actualización se aplica después de que se descarga.

Tipo	Descripción	Uso de Caso
autoUpdate: atBackground	Descargar en segundo plano, aplicar cuando el usuario ponga el fondo o cierre la aplicación	La mayoría de las aplicaciones; interrupción mínima
autoUpdate: atInstall	Aplicar inmediatamente solo en instalación fresca o actualización de tienda	Nuevos usuarios obtienen la versión más reciente; usuarios existentes utilizan el flujo por defecto
autoUpdate: onLaunch	Aplicar inmediatamente en instalación, actualización de tienda o después de que la aplicación se cierre	Equilibrio entre frescura y estabilidad de sesión
autoUpdate: always	Aplicar inmediatamente siempre que se descargue una actualización (incluyendo al reanudar)	Soluciones críticas, aplicaciones con estado simple
autoUpdate: onlyDownload	Descargar automáticamente y emitir updateAvailable pero nunca aplicar o establecer el siguiente paquete 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'
  }
}

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	Evite aplicar durante cambios rápidos de la aplicación
nativeVersion	Requiere una versión mínima de binario nativo	Bloquear actualizaciones en binarios nativos incompatibles code
kill	Espera hasta 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

La kill La condición se activa después del primer evento de matar la aplicación, no el siguiente. Este problema se solucionará en una futura versión.

Versión Bloqueada (Política de Canal)

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

Estrategia	Bloquea	Permite	Uso de Caso
ninguno	Nothing	Todas las actualizaciones	Predeterminado; actualización automática completa
mayor	0.0.0 → 1.0.0	Mismo mayor (por ejemplo 1.x → 1.y)	Evitar cambios que rompan en versiones nativas antiguas
menor	0.0.0 → 1.1.0, 1.1.0 → 1.2.0	Mismo menor (por ejemplo 1.2.x → 1.2.y)	Control más estricto dentro de un mayor
corrección de parche	Cualquier cambio excepto la corrección de parche	Solo 0.0.311 → 0.0.314	Muy estricto; solo actualizaciones de parche
metadata	Actualizaciones sin min_update_version	Actualizaciones con metadatos de compatibilidad explícitos	Reglas de compatibilidad personalizadas por paquete

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

Precaución

patch y metadata requieren una configuración cuidadosa. Consulte CLI comandos y Version Targeting para más detalles.

Tipos de entrega

Cómo se transfiere el paquete se transfiere al dispositivo. Tipo

Descripción	Cuándo usar	Paquete completo
El paquete JS completo se descarga	Entire JS bundle is downloaded	Primero instale, cambios grandes, o cuando delta no esté disponible
Delta (manifiesto)	Solo se descargan los archivos modificados	La mayoría de las actualizaciones; más rápido y amigable con la banda

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

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

Consejo

Cuando se utilicen modos de aplicación instantánea (atInstall, onLaunch, o always), habilite Actualizaciones de delta para minimizar el tiempo de descarga y mejorar la UX.

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

• Actualizar Comportamiento – Configurar el momento y los retrasos de aplicación
• Objetivo de Versión – Ruta de versión basada en canales
• 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, conecte 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 Inicio Rápido para el detalle de implementación en Inicio Rápido.