Tipos de Actualización

Copiar un prompt de configuración con los pasos de instalación y la guía de markdown completa para este plugin.

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

Aplicar Tiempo

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

Tipo	Descripción	Uso de caso
Predeterminado	__CAPGO_KEEP_0__ Descargar en segundo plano, aplicar cuando el usuario ponga en segundo plano o cierre la aplicación	La mayoría de las aplicaciones; mínima interrupción
directUpdate: `atInstall`	__CAPGO_KEEP_0__ Aplicar inmediatamente solo en instalación fresca o actualización de tienda	Nuevos usuarios obtienen la última versión; usuarios existentes utilizan el flujo predeterminado
directUpdate: `onLaunch`	__CAPGO_KEEP_0__ Aplicar inmediatamente en instalación, actualización de tienda o después de que el usuario cierre la aplicación	Equilibrio entre frescura y estabilidad de sesión
actualizaciónDirecta: `always`	Aplicar inmediatamente cada vez que se descargue una actualización (incluyendo al reanudar)	Arreglos críticos, aplicaciones con estado simple

Configurar en capacitor.config.ts:

plugins: {
  CapacitorUpdater: {
    directUpdate: false, // default
    // or: 'atInstall' | 'onLaunch' | 'always'
  }
}

Condiciones de retraso

Condiciones que deben cumplirse antes de una actualización se instala. 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 code
kill	Espera a la siguiente 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' },
  ],
});

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

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

Estrategia	Bloquea	Permite	Uso de Caso
ninguno	Nada	Todas las actualizaciones	Actualización automática completa protegida
__CAPGO_KEEP_0__	0.0.0 → 1.0.0	Máximo	Misma versión mayor (por ejemplo, 1.x → 1.y)
Prevenir cambios que rompan la compatibilidad con versiones nativas antiguas	0.0.0 → 1.1.0, 1.1.0 → 1.2.0	Menor	Misma versión menor (por ejemplo, 1.2.x → 1.2.y)
Control más estricto dentro de una versión mayor	Parche	Cualquier cambio excepto parche	Solo 0.0.311 → 0.0.314
Muy estricto; solo actualizaciones de parche	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

Tipos de entrega

Cómo se transfiere el paquete se transfiere a la dispositivo. Tipo

Descripción	Cuándo usar	Paquete completo
Se descarga el paquete JS completo	Primera instalación, grandes cambios o cuando no está disponible el delta	for details.
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

Referencia rápida

Categoría	Tipos
Aplicar retardo	Predeterminado, `atInstall`, `onLaunch`, `always`
Condiciones de retraso	`date`, `background`, `nativeVersion`, `kill`
Bloqueo de versión	`none`, `major`, `minor`, `patch`, `metadata`
Entrega	Paquete completo, Delta (manifesto)

Comportamiento de actualización — Configuración de aplicar retardo y demoras
Versión de destino — Ruta de versión basada en canal
Actualizaciones de delta (manifest) — Habilitar descargas parciales
Canales — Configuración y precedencia de canales