Tipos de actualización
Copia un prompt de configuración con los pasos de instalación y la guía completa en markdown para este plugin.
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.
Momento de aplicación
Sección titulada “Apply Timing”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).
| Tipo | Descripción | Caso de uso |
|---|---|---|
autoUpdate: atBackground | Comprobar y descargar en cada verificación de primer plano, aplicar cuando la app pase a segundo plano | La mayoría de las apps; interrupción mínima |
autoUpdate: atInstall | Aplicar inmediatamente solo tras una instalación nueva o una actualización de la app nativa en la tienda; de lo contrario, usar atBackground | Nuevos usuarios obtienen la última versión; los existentes aplican en segundo plano |
autoUpdate: onLaunch | Se aplica de inmediato solo en cold start (killed → foreground); luego recurre 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 | Correcciones críticas, 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 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 de retraso
Sección titulada “Condiciones de retraso”Condiciones que deben cumplirse antes se instala una actualización. Usa setMultiDelay para combinarlas (deben cumplirse todas las condiciones).
| Condición | Descripción | Ejemplo |
|---|---|---|
| date | Esperar hasta después de una fecha/hora específica | Coordinar con la publicación del servidor |
| background | Esperar una duración mínima (ms) tras pasar la app a segundo plano | Evita aplicar durante cambios rápidos de app |
| nativeVersion | Requerir una versión mínima del binario nativo | Bloquear actualizaciones en code nativo incompatible |
| kill | Esperar al próximo evento de cierre de la app | 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 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.
| Estrategia | Bloqueos | Permite | Caso de uso |
|---|---|---|---|
| ninguno | Nada | Cualquier versión objetivo del bundle | Por defecto; auto-update completo |
| 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 los breaking changes lleguen a code nativos antiguos |
| menor | Versión major o minor distinta a version_build, por ejemplo 1.2.3 -> 1.3.0 | Misma major y minor, por ejemplo 1.2.3 -> 1.2.4 | Mantén las actualizaciones en una misma línea minor nativa |
| parche | Cualquier cambio en major, minor o patch, por ejemplo 1.0.0 -> 1.0.1 | Solo 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.2 | Modo más estricto: sin cambios en la versión core |
| metadatos | Faltante min_update_version, o version_build debajo de él | Bundle de destino cuyo min_update_version es menor o igual que 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 instalado actualmente enviado como version_name.
npx @capgo/cli channel set production --disable-auto-update majorTipos de entrega
Sección titulada “Tipos de entrega”Cómo el 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 updatesnpx @capgo/cli bundle upload --channel production --deltaReferencia rápida
Sección titulada “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
Sección titulada “Relacionado”- Comportamiento de actualización — Configura el momento y los retrasos de aplicación
- Segmentación por versión — Enrutamiento de versiones por canal
- Actualizaciones delta — Descarga solo archivos modificados
- Canales — Configuración y precedencia de canales
Continuar desde Tipos de actualización
Sección titulada «Continuar desde Tipos de actualización»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.