コルダバ更新ツールの使い方

このプラグインのインストール手順とフルマークダウンガイドを含むインストール手順のコピー用意

        Set up this Capacitor plugin in the project.

Use the package manager already used by the project.
Install these package(s): `@capgo/cordova-updater`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/cordova-updater/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.

このガイドでは、iOSとAndroidでライブアップデートを受信できるようにするために @capgo/cordova-updater to a Cordova app so you can receive Capgo live updates on iOS and Android.

前提条件

コルダバ CLI 12+
Cordova Android 13+と/またはCordova iOS 7+
Capgo アカウント (capgo.app/登録)

インストール

プラグインをnpmからインストールし、CapgoアプリIDを指定してください。
ターミナルウィンドウ
```
cordova plugin add @capgo/cordova-updater --variable APP_ID=YOUR_CAPGO_APP_ID
```

オプション:インストール時にデフォルト値を上書きする (同様の変数は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

プラグイン変数を変更した後、ネイティブプロジェクトを準備する:
ターミナルウィンドウ
```
cordova prepare android ios
```

JavaScriptの使用方法

後 deviceready, プラグインは__CAPGO_KEEP_0__パッケージに含まれています。 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 });
  }
});

npmパッケージにはTypeScriptの型が含まれています。

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

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

Cordova Android 13+が必要なので、デフォルトのスキームからWebViewを提供します。 https://localhost/ scheme.
ダウンロードしたバンドルアセットを提供するためのURLを登録します。 CordovaPluginPathHandler プラットフォームに関する注意

iOS 7+のCordova iOSで使用する必要があります。 app://localhost/ デフォルトのスキーム。
プラグインは CDVPluginSchemeHandler Bundle要求をキャッチするために実装されています。

最初のBundleをアップロードしてください

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

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

次のステップ

設定を比較するには Capacitor アップデート設定 — 最大のオプションは変数にマップされます。 plugin.xml 変数。
Read Live update の互換性 native プラグインの変更を出荷する前に.
Capgoを後でCapacitorに移行する場合、同じCapgoアプリIDとチャンネルを維持し、クライアントプラグインパッケージのみが変更されます。