ガイド
Capacitor で Updater を使う方法
IonicとCapacitorを@capgo/capacitor-updaterでLive Update
@capgo/capacitor-updaterは、IonicおよびCapacitorアプリ向けのCapgo Live Updateを支えるオープンソースのUpdaterプラグインです。承認済みのWeb bundleをダウンロードしてネイティブのロールバック保護機能とともに適用するため、バイナリのみの変更は通常のApp StoreやPlay Storeの審査プロセスに任せることができます。
ネイティブシェルが承認された後に、HTML、CSS、JavaScript、アセットなどのWebレイヤーの変更をOTAで更新したい場合に最適です。
インストール
npm install @capgo/capacitor-updater
npx cap sync
活用シーン
Ionicチームにとって、Live Updateは通常、全ユーザーにストアのフルリリースを強制することなく新しいWeb bundleを配信するというワークフローを意味します。Capgoは、チャンネル、互換性チェック、ロールアウト制御、デバイスログ、ロールバック機能により、Capacitorアプリのワークフローを管理します。
ネイティブプラグイン、Entitlements、Android Manifestの変更、iOS plistの変更、およびバイナリのSDKアップデートには、通常通りアプリストアでのリリースが必要です。これらの変更はネイティブのbuild pipelineで管理し、承認済みのWebレイヤーにはLive Updateを活用してください。
このプラグインで利用可能な機能
notifyAppReady- JavaScriptの初期化が正常に完了したことをネイティブレイヤーに通知します。setUpdateUrl- アプリのアップデートURLをランタイム時に動的に設定します。setStatsUrl- アプリの統計URLをランタイム時に動的に設定します。setChannelUrl- アプリのチャネルURLをランタイム時に動的に設定します。
使用例
notifyAppReady
JavaScriptの初期化が正常に完了したことをネイティブレイヤーに通知します。
import { CapacitorUpdater } from '@capgo/capacitor-updater';
const result = await CapacitorUpdater.notifyAppReady();
console.log(result);
setUpdateUrl
アプリのアップデートURLをランタイム時に動的に設定します。
import { CapacitorUpdater } from '@capgo/capacitor-updater';
await CapacitorUpdater.setUpdateUrl({ url: 'https://example.com' });
setStatsUrl
アプリの統計URLをランタイム時に動的に設定します。
import { CapacitorUpdater } from '@capgo/capacitor-updater';
await CapacitorUpdater.setStatsUrl({ url: 'https://example.com' });
setChannelUrl
アプリのチャネルURLをランタイム時に動的に設定します。
import { CapacitorUpdater } from '@capgo/capacitor-updater';
await CapacitorUpdater.setChannelUrl({ url: 'https://example.com' });
リファレンス全文
- GitHub: https://github.com/Cap-go/capacitor-updater/
- ドキュメント: /docs/plugins/updater/
- Live update 製品: /live-update/
@capgo/capacitor-updater でさらに進む
使用している場合 @capgo/capacitor-updater Live Update の計画を立てるには、以下と連携しましょう Live Update 製品ワークフローのために、 @capgo/capacitor-updater 実装の詳細については、 スタートガイド, チャンネルや ロールバック.