Actualización automática

Esta documentación explicará cómo ejecutar su servidor de actualización automática.

Servir su paquete

Asegúrese de que su paquete esté servido sobre HTTPS, y el servidor tenga los encabezados CORS adecuados para permitir que la aplicación descargue la actualización. e.g. https://myserver.com/app/updates/updates.json

Si está desconocido con la servido de un paquete, le recomendamos que intente Capgo Cloud o vea un ejemplo aquí:

Servir un Paquete

Configuración

Agregar un updateUrl a tu capacitor.config.json.

{
  "plugins": {
    "CapacitorUpdater": {
      "updateUrl": "https://myserver.com/app/updates/updates.json",
    }
  }
}

Cuidado

Cuando estés empujando una actualización autoalojada, ten en cuenta que no puedes utilizar el extremo “HTTP” ya que va en contra de las políticas de seguridad de las aplicaciones de Android, para fines de prueba puedes permitirlo.

Actualizar API

El plugin realizará una llamada POST a tu API cada vez que se abra la aplicación, con este cuerpo:

interface AppInfos {
    "platform": "ios" | "android" | "electron",
    "device_id": "UUID_of_device_unique_by_install",
    "app_id": "APPID_FROM_CAPACITOR_CONFIG",
    "custom_id": "your_custom_id_set_on_runtime",
    "plugin_version": "PLUGIN_VERSION",
    "version_build": "VERSION_NUMBER_FROM_NATIVE_CODE",
    "version_code": "VERSION_CODE_FROM_NATIVE_CODE",
    "version_name": "LAST_DOWNLOADER_VERSION" | "builtin"
    "version_os": "VERSION_OF_SYSTEM_OS",
    "is_emulator": boolean,
    "is_prod": boolean,
}

The servidor API debe responder, en formato JSON, al plugin de actualización capacitor.

{
"version": "1.2.3",
"url": "https://myserver.com/app/updates/my-new-app-2.0.0.zip",
"checksum": "sha256_checksum_of_bundle"
}

En modo de actualización automática, el servidor debe comparar las versiones y devolver la correcta, si la clave URL está presente, el plugin inicia el proceso de descarga.

Si agrega la clave ‘mensaje’ y ‘error’, la versión no se establecerá, y el mensaje se mostrará en los registros en su lugar.

version La clave debe estar en semver formato.

El zip debe tener index.html como archivo en la raíz, o solo una carpeta en la raíz con index.html dentro.

Puede utilizar el comando del CLI para comprimir su paquete:

Crear un paquete con sus archivos para servir desde su servidor

npx @capgo/cli bundle zip --path [/path/to/my/bundle]

Generando Suma de Verificación del Paquete

Importante: Debes utilizar los Capgo CLI para crear tu archivo zip de paquete. El plugin Capgo requiere un formato y estructura zip específicos que solo se garantizan cuando se utiliza la herramienta oficial CLI. Las utilidades zip estándar pueden crear archivos incompatibles.

Para generar la suma de verificación para tu paquete, utiliza los Capgo CLI zip con la --json flag:

Crear paquete con información de suma de verificación

npx @capgo/cli bundle zip [appId] --json

Esta orden realizará:

• Crear un archivo zip correctamente formateado compatible con el plugin Capgo
• Generar la suma SHA256 de verificación de integridad
• Mostrar información del paquete en formato JSON

Ejemplo de salida:

{
  "version": "1.2.3",
  "checksum": "a1b2c3d4e5f6789...",
  "size": 1234567
}

Utilice el checksum valor de este resultado en su API respuesta para asegurarse de que el complemento pueda verificar la integridad del paquete antes de la instalación.

Siga adelante desde Actualización automática

Si está utilizando Actualización automática para planificar la migración y las operaciones de empresa, conecte con Usando @capgo/capacitor-actualizador para la capacidad nativa en Usando @capgo/capacitor-actualizador, Capgo Empresa para el flujo de trabajo del producto en Capgo Enterprise, Alternativas del plugin de Ionic Enterprise para el flujo de trabajo del producto en Alternativas del plugin de Ionic Enterprise, Alternativas de Capgo para el flujo de trabajo del producto en Alternativas de Capgo, y Consultoría de Capgo para el flujo de trabajo del producto en Consultoría de Capgo.