Iniciar con Cordova Updater

Esta guía te guía a través de agregar @capgo/cordova-updater a una aplicación de Cordova para que puedas recibir Capgo actualizaciones en vivo en iOS y Android.

Advertencia

Hacer no usar con este plugin. El navegador de Ionic bypassa los manipuladores de esquemas de Cordova, por lo que los paquetes descargados no se cargarán. Requisitos previos cordova-plugin-ionic-webview Sección titulada “Requisitos previos”

Cordova __CAPGO_KEEP_0__ 12+

• Una cuenta de CLI (
• __CAPGO_KEEP_0__.app/register
• A Capgo account (capgo.app/register)

Instale el plugin desde __CAPGO_KEEP_0__ y proporcione su ID de aplicación __CAPGO_KEEP_1__:

1. Install the plugin from npm and pass your Capgo app ID:

   cordova plugin add @capgo/cordova-updater --variable APP_ID=YOUR_CAPGO_APP_ID

2. Opcional: sobreescribir valores por defecto en el momento de la instalación (mismas variables que el actualizador Capacitor):

   cordova plugin add @capgo/cordova-updater \
     --variable APP_ID=YOUR_CAPGO_APP_ID \
     --variable DEFAULT_CHANNEL=production \
     --variable UPDATE_URL=https://plugin.capgo.app/updates \
     --variable AUTO_UPDATE=atBackground

3. Preparar proyectos nativos después de cambiar variables de plugin:

   cordova prepare android ios

Uso de JavaScript

Después, devicereadyel plugin está disponible como cordova.plugins.Updater:

document.addEventListener('deviceready', async () => {
  const { Updater } = cordova.plugins;

  await Updater.notifyAppReady();

  const latest = await Updater.getLatest();
  if (latest.url && !latest.error) {
    const bundle = await Updater.download({
      url: latest.url,
      version: latest.version,
      checksum: latest.checksum,
    });

    await Updater.next({ id: bundle.id });
  }
});

Los tipos de TypeScript se envían con el paquete npm:

import type { UpdaterPlugin } from '@capgo/cordova-updater';

declare const cordova: { plugins: { Updater: UpdaterPlugin } };

Notas de plataforma

Android

• Requiere Cordova Android 13+ para que el WebView se sirva desde el esquema predeterminado. https://localhost/ El plugin registra un
• para servir activos de paquete descargados. CordovaPluginPathHandler Requiere Cordova iOS 7+ con el esquema predeterminado

iOS

• Requiere Cordova iOS 7+ con el esquema predeterminado app://localhost/ esquema.
• El plugin implementa CDVPluginSchemeHandler para interceptar solicitudes de paquetes.

Subir su primer paquete

Construya sus activos web, luego suba con el Capgo CLI (mismo flujo de trabajo que Capacitor):

bun run build
bunx @capgo/cli@latest bundle upload --channel=production

Pasos siguientes

• Comparar configuración con la configuración del actualizador __CAPGO_KEEP_0__ Configuración del actualizador Capacitor — la mayoría de las opciones se corresponden con plugin.xml variables.
• Leer Compatibilidad de actualización en vivo Antes de enviar cambios en el plugin nativo.
• Migrando a Capacitor más tarde? Mantenga el mismo Capgo ID de aplicación y canales; solo cambia el paquete del plugin del cliente.