ガイド
Cordova で Cordova Updater を使用する方法
@capgo/cordova-updater の使用方法
@capgo/cordova-updater は、Capgo と同じ JavaScript API を使用して、Cordova の iOS および Android アプリに Capgo の Live Update を提供します。 @capgo/capacitor-updater. Cordova プラグインをインストールし、 notifyAppReady() 起動のたびに実行し、以下でbundleをアップロードします: @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 バンドル内で新しいネイティブ API を使用する前に、新しいストア用バイナリをリリースする必要があります。
- セットアップの詳細は Cordova updater のドキュメントにあります.