Tipos de actualización

Capgo admite varios tipos de actualizaciones over-the-air (OTA). En esta página los enumeramos y explicamos para que elijas la combinación ideal para tu app.

Momento de aplicación

Controles cuando la actualización se aplica tras la descarga. El plugin busca actualizaciones al pasar la app al primer plano y mediante un timer mientras la app esté abierta. periodCheckDelay controla ese intervalo (por defecto 10 minutos).

Tipo	Descripción	Caso de uso
autoUpdate: atBackground	Comprobar y descargar en cada check de foreground, aplicar al pasar la app a background	La mayoría de las apps; mínima interrupción
autoUpdate: atInstall	Aplicar inmediatamente solo tras una instalación limpia o update de la app store; de lo contrario usar atBackground	Nuevos usuarios reciben la última; usuarios actuales usan background apply
autoUpdate: onLaunch	Se aplica de inmediato solo en cold start (killed → foreground); luego vuelve a atBackground	Equilibrio entre frescura y estabilidad de la sesión
autoUpdate: always	Comprueba en cada transición a foreground y aplica de inmediato si hay una actualización	Fixes críticos, apps con estado simple
autoUpdate: onlyDownload	Comprueba y descarga automáticamente, emite updateAvailable, y nunca aplica automáticamente	Apps que muestran su propio prompt de actualización o controlan 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'
  }
}

Consejo

Para más detalles y el manejo de splashscreen, consulta Comportamiento de actualización.

Condiciones de retraso

Condiciones que deben cumplirse para antes instalar una actualización. Usa setMultiDelay para combinarlas (deben cumplirse todas).

Condición	Descripción	Ejemplo
fecha	Esperar a una fecha/hora específica	Coordinar con el release del servidor
background	Esperar un tiempo mínimo (ms) tras pasar a background	Evitar la aplicación durante cambios rápidos de app
nativeVersion	Requerir una versión mínima del binario nativo	Bloquear updates en code nativo incompatible
kill	Esperar al próximo evento de kill de la app	Aplicar solo tras un 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 tras el primer evento de cierre, no en el siguiente proceso en segundo plano como los demás. Se corregirá en una futura versión.

Bloqueo de versiones (Channel Policy)

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

Estrategia	Bloqueos	Permite	Caso de uso
ninguno	Nada	Cualquier versión del bundle	Por defecto; auto-update total
major	Major superior a version_build, por ejemplo 1.2.3 -> 2.0.0	Mismo major, por ejemplo 1.2.3 -> 1.9.0 o 1.2.3 -> 1.2.4	Evita que cambios disruptivos lleguen a versiones antiguas de code
minor	Major o minor diferente a version_build, por ejemplo 1.2.3 -> 1.3.0	Mismo major y minor, por ejemplo 1.2.3 -> 1.2.4	Keep updates inside one native minor line
patch	Cualquier cambio en major, minor o patch, por ejemplo 1.0.0 -> 1.0.1	Solo cambian los sufijos 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.2	Modo más estricto: sin cambios en la versión core
metadatos	Falta min_update_version, o version_build debajo de este	Bundle de destino cuyo min_update_version es menor o igual a version_build	Reglas 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 e instalado actualmente enviado como version_name.

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

Atención

patch y metadata requiere una configuración cuidadosa. Ver comandos de CLI y Segmentación de versiones para más detalles.

Tipos de entrega

How the el bundle se transfiere al dispositivo.

Tipo	Descripción	Cuándo usarlo
Bundle completo	Se descarga todo el bundle de JS	Primera instalación, cambios grandes o si no hay delta disponible
Delta	Solo se descargan los archivos modificados	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 usar modos de aplicación instantánea (atInstall, onLaunch, o always), activa Actualizaciones delta para minimizar el tiempo de descarga y mejorar la UX.

Referencia rápida

Categoría	Tipos
Momento de aplicación	off, atBackground, atInstall, onLaunch, always, onlyDownload
Condiciones de retraso	date, background, nativeVersion, kill
Bloqueo de versiones	none, major, minor, patch, metadata
Entrega	Bundle completo, Delta

Relacionado

• Comportamiento de actualización — Configura tiempos y retrasos
• Segmentación de versiones — Enrutamiento por canales
• Actualizaciones Delta — Descarga solo archivos cambiados
• Canales — Configuración y precedencia de canales

Continúa desde Tipos de actualización

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