Tipos de Actualizaciones

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

Aplicar Tiempo

Controles cuando una actualización se aplica después de descargarla. El plugin verifica actualizaciones cuando la aplicación se mueve al primer plano y en un temporizador repetido mientras la aplicación permanece abierta. periodCheckDelay los controles que establecen ese intervalo (por defecto 10 minutos).

Tipo	Descripción	Uso
contexto: Página/área: Soluciones de Capgo. Rol: Etiqueta de UI corta o elemento de navegación. Visto en: página soluciones/cordova-to-capacitor-ai.astro. Clave de mensaje `solutions_cordova_to_capacitor_ai_table_use_case` (Solutions Cordova To Capacitor Ai Table Use Case). atBackground	actualizarAutomáticamente: «Verificar y descargar en cada verificación de primer plano, aplicar cuando la aplicación se mueve al segundo plano»	La mayoría de las aplicaciones; interrupción mínima
autoUpdate: atInstall	Aplicar inmediatamente solo después de una instalación fresca o actualización de tienda de aplicaciones nativa; en caso contrario, utilice atBackground	Los nuevos usuarios obtienen la versión más reciente; los usuarios existentes utilizan aplicar en segundo plano
autoUpdate: onLaunch	Aplicar inmediatamente solo en arranque frío (killed → foreground); luego caiga en la opción de atBackground	Equilibrio entre frescura y estabilidad de sesión
autoUpdate: always	Verificar en cada transición de primer plano y aplicar inmediatamente siempre que esté disponible una actualización	Arreglos críticos, aplicaciones con estado simple
autoUpdate: onlyDownload	Verificar y descargar automáticamente, emitir updateAvailabley nunca aplicar 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 produzca el evento ‘before’ (antes de que se produzca el evento). Page/area: Capgo marketing website. Role: Long marketing or legal paragraph. Seen in: page contributing.astro. Message key `create_an_issue_and_discuss_before_working_on_a_new_feature` (Create An Issue And Discuss Before Working On A New Feature). | HTML text fragment from a longer Capgo UI string (parent key `mention_issue_before_working`). Page/area: Capgo marketing website. Role: Website copy sentence. Seen in: page contributing.astro. Message key `mention_issue_before_working` (Mention Issue Before Working). Se instala una actualización. 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 aplicación
Versión nativa	Requiere una versión mínima de binario nativo	Bloquear actualizaciones en binarios nativos incompatibles con code
kill	Esperar a la siguiente señal de muerte de 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 desencadena después del primer evento de muerte, no el siguiente evento de fondo como los demás. Esto se corregirá en una futura versión.

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

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

Estrategia	Bloquea	Permite	Uso de Caso
context	Ninguno	Nada	Cualquier versión de paquete objetivo
mayor	Más mayor que version_build, por ejemplo 1.2.3 -> 2.0.0	Con el mismo mayor, por ejemplo 1.2.3 -> 1.9.0 o 1.2.3 -> 1.2.4	Prevenir cambios de ruptura de llegar a nativos antiguos code
menor	Diferente mayor o menor que version_build, por ejemplo 1.2.3 -> 1.3.0	Con el mismo mayor y menor, por ejemplo 1.2.3 -> 1.2.4	Mantener actualizaciones dentro de una línea menor nativa
patch	Cualquier cambio de número mayor, menor o de parche, por ejemplo 1.0.0 -> 1.0.1	Solo cambios de sufijo mientras MAJOR.MINOR.PATCH se mantiene igual, por ejemplo 1.0.0-beta.1 -> 1.0.0-beta.2 o 1.0.0+build.1 -> 1.0.0+build.2	¿O
Modo más estricto: sin movimiento de versión de núcleo	metadatos min_update_versionFaltante version_build , o	debajo de él min_update_version Paquete objetivo cuyo version_build	es menor o igual a o igual a que el valor de la propiedad de compatibilidad personalizada por paquete

Estas comprobaciones comparan el paquete objetivo con la base de línea nativa enviada como version_build, no el paquete descargado instalado actualmente enviado como version_name.

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

advertencia

patch y metadata contexto: Página/área: sitio web de marketing de Capgo. Rol: Etiqueta de interfaz de usuario corta o elemento de navegación. Visto en: página trust.astro. Clave de mensaje `y` (Y). CLI commands __CAPGO_KEEP_0__ comandos y contexto: Página/área: sitio web de marketing de Capgo. Rol: Etiqueta de interfaz de usuario corta o elemento de navegación. Visto en: página trust.astro. Clave de mensaje `y` (Y).

Tipos de entrega

¿Cómo se? El paquete se transfiere

a la dispositivo.	Tipo	Descripción
Cuándo usar	Paquete completo	Se descarga el paquete JS completo
Primera instalación, cambios grandes, o cuando no esté disponible el delta (manifest) (Contexto: Página/área: Capgo Builder / página de producto de construcción nativa en la nube. Rol: Etiqueta de UI corta o elemento de navegación. Clave de mensaje `native_build_builder_credit_first` (Crédito de construcción nativa del constructor). )	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

Consejo

Al utilizar los modos de aplicación instantánea (atInstall, onLaunch, o always), habilite Actualizaciones delta contexto: Página/área: Página de producto/preciación de empresa. Rol: Etiqueta de IU corta o elemento de navegación. Visto en: página enterprise.astro. Clave de mensaje `enterprise_delta_updates` (Actualizaciones Delta de Empresa).

para minimizar el tiempo de descarga y mejorar la UX.

Categoría	Tipos
Aplicar horario	off, atBackground, atInstall, onLaunch, always, onlyDownload
Condiciones de retraso	date, background, nativeVersion, kill
Bloqueo de versión	none, major, minor, patch, metadata
Entrega	context: Página/área: Página de producto/precios de empresa. Rol: Etiqueta de interfaz de usuario. Clave de mensaje `enterprise_delivery_label` (Etiqueta de entrega de empresa).

Paquete completo, Delta (manifesto)

• Sección titulada “Relacionado” Comportamiento de actualización
• Versión Dirigida — Ruta de versión basada en canal
• Actualizaciones (Delta) (manifest) — Habilitar descargas parciales
• Canal — Configuración y precedencia de canales

Sigue adelante desde Tipos de Actualizaciones

Si estás utilizando Tipos de Actualizaciones para planificar la entrega de actualizaciones en vivo, conecta 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 la Actualización para el detalle de implementación en Comportamiento de la Actualización, y Iniciar sesión Anterior