コンテンツにジャンプ
Capgo - Capacitor アプリのリアルタイム更新 Capgo

Cordova Updaterの使用を始める

GitHub

このガイドでは、iOSとAndroid向けにリアルタイムで更新を受けることができるCordovaアプリに @capgo/cordova-updater to a Cordova app so you can receive Capgo live updates on iOS and Android.

Cordova __CAPGO_KEEP_0__ 12+

protectedTokens
  • Cordova CLI 12+
  • Android 13+ と/または iOS 7+ の Cordova
  • A Capgo account (capgo.app/register)

インストール

「インストール」のセクション

  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の使用

「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 });
  }
});

npmパッケージに付属するTypeScriptの型

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


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

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

「プラットフォームに関する注意」のセクション
  • Cordova Android 13+で、デフォルトのスキームからWebViewが提供される必要があります。 https://localhost/ デフォルトのスキーム。
  • ダウンロードしたバンドルアセットを提供するために CordovaPluginPathHandler Cordova iOS 7+で、デフォルトのスキームが必要です。

scheme

scheme

Build your web assets, then upload with the Capgo CLI (same workflow as Capacitor):

ターミナル画面
bun run build
bunx @capgo/cli@latest bundle upload --channel=production

次のステップ

セクション「次のステップ」