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 controles ese intervalo (por defecto 10 minutos).

Tipo	Descripción	Uso
contexto: Página/área: Página de marketing de 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
__CAPGO_KEEP_0__ 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
__CAPGO_KEEP_0__ 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
__CAPGO_KEEP_0__ 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
__CAPGO_KEEP_0__ onlyDownload	Verificar y descargar automáticamente, emite 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

Las condiciones que deben cumplirse antes de que se active el retraso, con contexto de texto fragmento de HTML de una cadena de texto de Capgo más larga (clave de mensaje `create_an_issue_and_discuss_before_working_on_a_new_feature`). Página/área: sitio web de marketing de Capgo. Rol: párrafo de marketing o legal largo. Visto en: página contribuyendo.astro. Clave de mensaje `create_an_issue_and_discuss_before_working_on_a_new_feature` (Crear un problema y discutir antes de trabajar en una nueva característica). | Texto fragmento de HTML de una cadena de texto de Capgo más larga (clave de mensaje `mention_issue_before_working`). Página/área: sitio web de marketing de Capgo. Rol: oración de sitio web. Visto en: página contribuyendo.astro. Clave de mensaje `mention_issue_before_working` (Mencionar problema antes de trabajar). Se instala una actualización. Utilice setMultiDelay para combinarlos (deben cumplirse 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 de aplicación rápidos
Versión nativa	Requiere una versión mínima de binario nativo	Bloquear actualizaciones en binarios nativos incompatibles con code
kill	Esperar hasta el próximo evento de kill 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 kill, no el próximo 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	Lo 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	Lo mismo mayor y menor, por ejemplo 1.2.3 -> 1.2.4	Mantener actualizaciones dentro de una línea menor nativa
patch	Cualquier cambio en el número mayor, menor o de parche, por ejemplo 1.0.0 -> 1.0.1	Sólo 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	¿Qué es lo que cambia cuando actualizamos?
¿Qué cambia mientras actualizamos?	¿Qué cambia mientras actualizamos? min_update_version¿Qué cambia mientras actualizamos? version_build ¿Qué cambia mientras actualizamos?	¿Qué cambia mientras actualizamos? min_update_version ¿Qué cambia mientras actualizamos? version_build	¿Qué cambia mientras actualizamos?

Estas comprobaciones comparan el paquete objetivo con la base de datos 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 y CLI commands requiere una configuración cuidadosa. Consulte __CAPGO_KEEP_0__ comandos y versión de destino

Tipos de entrega

Cómo se transfiere el paquete 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
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 del constructor de construcción nativa Primero).	Solo se descargan los archivos modificados	La mayoría de las actualizaciones; más rápidas y amigables 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 modos de aplicación instantánea (atInstall, onLaunch, o always), habilita Actualizaciones delta para minimizar el tiempo de descarga y mejorar la experiencia del usuario.

Referencia rápida

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).

Pakete completo, Delta (manifesto)

• Sección titulada “Relacionado” Comportamiento de actualización
• Versión Dirigida — Ruteo de versión basado en canales
• Deltas (actualizaciones de manifiesto) — Habilitar descargas parciales
• Canales — 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 para el detalle de implementación en Iniciar