ガイド
Cordova で Cordova Updater を使う方法
@capgo/cordova-updater の使用方法
@capgo/cordova-updater Capgo の Live Update を Cordova の iOS/Android アプリに、同じ JavaScript API で提供します。 @capgo/capacitor-updater。Cordova プラグインをインストールし、呼び出します notifyAppReady() 起動のたびに、bundleをuploadするには @capgo/cli.
インストール
cordova plugin add @capgo/cordova-updater --variable APP_ID=com.example.app
cordova prepare android ios
基本的な使い方
document.addEventListener('deviceready', async () => {
const { Updater } = cordova.plugins;
await Updater.notifyAppReady();
const { bundle } = await Updater.current();
console.log('Active bundle', bundle);
const latest = await Updater.getLatest();
if (latest.url && !latest.error) {
const downloaded = await Updater.download({
url: latest.url,
version: latest.version,
checksum: latest.checksum,
});
await Updater.next({ id: downloaded.id });
}
});
プラットフォーム要件
- Cordova Android 13+ および Cordova iOS 7+
- デフォルトのCordova WebViewスキーム(
https://localhost/Androidでは、app://localhost/iOSの場合) - 避ける
cordova-plugin-ionic-webview— bundleの入れ替えを防ぎます
新しい bundle をデプロイする
bun run build
bunx @capgo/cli@latest bundle upload --channel=production
実践的なアドバイス
- Capacitor や Electron クライアントも提供する場合は、同じ Capgo の app ID とチャンネルを再利用してください。
- ネイティブプラグインや Cordova プラットフォームのアップグレードは、他のネイティブ変更と同様に扱ってください。JavaScript bundle で新しいネイティブ API に依存する前に、新しいストア用バイナリを配信してください。
- セットアップの詳細はこちら: Cordova updater ドキュメント.