Cordova Updaterの導入

このガイドでは、追加の方法について説明します。 @capgo/cordova-updater iOSとAndroidにライブ更新を受け取ることができるCordovaアプリにCapgoを追加することができます。

注意

このプラグインと一緒に使用しないでください。 Ionic WebViewはCordovaのスキームハンドラーをバイパスするため、ダウンロードしたバンドルが読み込まれません。 前提条件 cordova-plugin-ionic-webview 前提条件

Cordova __CAPGO_KEEP_0__ 12+

• Cordova CLI 12+
• __CAPGO_KEEP_0__
• Capgocapgo.app/登録)

インストール

1. npmからプラグインをインストールし、CapgoアプリIDを指定してください:

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

2. オプション: インストール時にデフォルト値を上書きする (同様の変数は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. プラグイン変数が変更された後、ネイティブプロジェクトを準備する:

   cordova prepare android ios

JavaScriptの使用

後 deviceready、プラグインは 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 });
  }
});

TypeScriptの型はnpmパッケージとともに配布されます:

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

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

プラットフォームに関する注意

Android

• Cordova Android 13+が必要なので、デフォルトのWebViewが提供されます https://localhost/ scheme.
• Capgoプラグインは CordovaPluginPathHandler をダウンロードしたバンドルアセットを提供するために

iOS

• Cordova iOS 7+とデフォルトの app://localhost/ scheme.
• Capgoプラグインは CDVPluginSchemeHandler をキャッチするために

最初のバンドルをアップロード

Webアセットをビルドし、Capgo CLI (同様のワークフローはCapacitor):

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

次のステップ

• 設定を「 Capacitor 」アップデーター設定と比較します。 — 最大のオプションは変数にマップされます。 plugin.xml 読む
• ライブアップデートの互換性 __CAPGO_KEEP_0__ を後で実行する場合、ネイティブ プラグインの変更を出荷する前に。
• Migrating to Capacitor later? Keep the same Capgo app ID and channels; only the client plugin package changes.