Saltar al contenido

Tipos de actualización

Capgo soporta varios tipos de actualizaciones OTA (over-the-air). Esta página enumera y explica todos ellos para que puedas elegir la combinación adecuada para tu app.

Controles cuando una actualización se aplica después de ser descargada. El plugin busca actualizaciones cuando la app pasa a primer plano y mediante un temporizador repetitivo mientras la app permanece abierta. periodCheckDelay controla ese intervalo (por defecto 10 minutos).

TipoDescripciónCaso de uso
autoUpdate: atBackgroundComprobar y descargar en cada verificación de primer plano, aplicar cuando la app pase a segundo planoLa mayoría de las apps; interrupción mínima
autoUpdate: atInstallAplicar inmediatamente solo tras una instalación nueva o una actualización de la app nativa en la tienda; de lo contrario, usar atBackgroundNuevos usuarios obtienen la última versión; los existentes aplican en segundo plano
autoUpdate: onLaunchSe aplica de inmediato solo en cold start (killed → foreground); luego recurre a atBackgroundEquilibrio entre frescura y estabilidad de la sesión
autoUpdate: alwaysComprueba en cada transición a foreground y aplica de inmediato si hay una actualizaciónCorrecciones críticas, apps con estado simple
autoUpdate: onlyDownloadComprueba y descarga automáticamente, emite updateAvailable, y nunca aplica automáticamenteApps que muestran su propio prompt de actualización o controlan exactamente cuándo llamar set()

Configúralo en capacitor.config.ts:

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

Condiciones que deben cumplirse antes se instala una actualización. Usa setMultiDelay para combinarlas (deben cumplirse todas las condiciones).

CondiciónDescripciónEjemplo
dateEsperar hasta después de una fecha/hora específicaCoordinar con la publicación del servidor
backgroundEsperar una duración mínima (ms) tras pasar la app a segundo planoEvita aplicar durante cambios rápidos de app
nativeVersionRequerir una versión mínima del binario nativoBloquear actualizaciones en code nativo incompatible
killEsperar al próximo evento de cierre de la appAplicar 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 versiones (política de canales)

Sección titulada “Bloqueo de versión (política de canal)”

Controla qué actualizaciones semver a channel will auto-deliver. Set via --disable-auto-update en canales.

EstrategiaBloqueosPermiteCaso de uso
ningunoNadaCualquier versión objetivo del bundlePor defecto; auto-update completo
majorMajor superior a version_build, por ejemplo 1.2.3 -> 2.0.0Mismo major, por ejemplo 1.2.3 -> 1.9.0 o 1.2.3 -> 1.2.4Evita que los breaking changes lleguen a code nativos antiguos
menorVersión major o minor distinta a version_build, por ejemplo 1.2.3 -> 1.3.0Misma major y minor, por ejemplo 1.2.3 -> 1.2.4Mantén las actualizaciones en una misma línea minor nativa
parcheCualquier cambio en major, minor o patch, por ejemplo 1.0.0 -> 1.0.1Solo cambia el sufijo mientras que 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.2Modo más estricto: sin cambios en la versión core
metadatosFaltante min_update_version, o version_build debajo de élBundle de destino cuyo min_update_version es menor o igual que version_buildReglas de compatibilidad personalizadas por bundle

Estas comprobaciones comparan el bundle de destino con la base nativa enviada como version_build, no con el bundle descargado instalado actualmente enviado como version_name.

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

Cómo el el bundle se transfiere al dispositivo.

TipoDescripciónCuándo usarlo
Bundle completoSe descarga todo el bundle de JSPrimera instalación, cambios grandes o si no hay delta disponible
DeltaSolo se descargan los archivos modificadosMost updates; faster and bandwidth-friendly
Ventana de terminal
# Full bundle (default)
npx @capgo/cli bundle upload --channel production
# Delta updates
npx @capgo/cli bundle upload --channel production --delta
CategoríaTipos
Momento de aplicaciónoff, atBackground, atInstall, onLaunch, always, onlyDownload
Condiciones de retrasodate, background, nativeVersion, kill
Bloqueo de versionesnone, major, minor, patch, metadata
EntregaBundle completo, Delta

Si estás usando Tipos de actualización para planificar la entrega de live update, conéctalo con Live Updates de Capgo para el flujo de trabajo del producto en Capgo Live Updates, Resumen para el detalle de implementación en Overview, Funcionalidades para el detalle de implementación en Features, Comportamiento de actualización para el detalle de implementación en Update Behavior, y Primeros pasos para los detalles de implementación en Getting Started.