Auto Update

Esta documentación explicará cómo ejecutar su servidor de actualizaciones automáticas.

Servir su paquete

Asegúrese de que su paquete esté servido sobre HTTPS, y el servidor tenga los encabezados CORS correctos 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 updateUrl para a tu capacitor.config.json.

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

Advertencia

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 permítelo.

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,
}

El servidor API debería responder, en formato JSON, al plugin de actualización capacitor-updater. Con esta información si es necesario una actualización:

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

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

Si agrega las claves “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 el 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 de zip estándar pueden crear archivos incompatibles.

Para generar el checksum de tu paquete, utiliza el comando zip Capgo CLI con la bandera: --json flag:

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

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

Este comando realizará:

• Cree un archivo zip compatible con el plugin Capgo.
• Mostrar información del paquete en formato JSON
• Información del paquete de salida en formato JSON

Ejemplo de salida:

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

Utilice el checksum valor de esta salida en su respuesta API para asegurarse de que el plugin pueda verificar la integridad del paquete antes de la instalación.

Siga adelante desde Actualización Automática

Si está utilizando Auto Update para planificar la migración y las operaciones empresariales, conecte con Usando @capgo/capacitor-actualizador para la capacidad nativa en Usando @capgo/capacitor-actualizador, Capgo Empresas para el flujo de trabajo del producto en Capgo Enterprise, Alternativas de Plugins de Ionic Enterprise para el flujo de trabajo del producto en Ionic Enterprise Plugin Alternativas Capgo Alternativas para el flujo de trabajo del producto en Capgo Alternativas, y Capgo Consultoría para el flujo de trabajo del producto en Capgo Consultoría.