メインコンテンツへスキップ
@capgo/capacitor-updater アップデート オープンソース

アップデーター Capacitor プラグイン

App Storeの審査を待たずに、IonicとCapacitorのライブアップデートをユーザーに即時デプロイ

インストール

bun add @capgo/capacitor-updater bunx cap sync
npm、pnpm、または yarn
  • npm install @capgo/capacitor-updater
  • pnpm add @capgo/capacitor-updater
  • yarn add @capgo/capacitor-updater

ガイド

Capacitor で Updater を使う方法

実機でテストする

Capgo アプリをダウンロードして、QR code をスキャンしてください。

Updaterプラグインプレビュー用QR code

Ionic と Capacitor のライブアップデートを @capgo/capacitor-updater で実現

@capgo/capacitor-updater は、Ionic および Capacitor アプリ向けの Capgo ライブアップデートを支えるオープンソースのアップデータプラグインです。承認済みの Web バンドルをダウンロードし、ネイティブのロールバック保護を適用して適用します。バイナリのみの変更は、通常の App Store および Play のレビュープロセスに従います。

ネイティブシェルが承認済みの状態で、HTML、CSS、JavaScript、アセット、その他の Web レイヤーの変更に対して OTA アップデートが必要な場合に使用します。

インストール

npm install @capgo/capacitor-updater
npx cap sync

活用シーン

Ionic チームにとって、ライブアップデートは通常、同じワークフローを意味します。全ユーザーにフルストアリリースを強制することなく、新しい Web バンドルを配信することです。Capgo は、Capacitor アプリに対して、チャネル、互換性チェック、ロールアウト制御、デバイスログ、ロールバックを通じて、そのワークフローを処理します。

ネイティブプラグイン、エンタイトルメント、Android マニフェストの変更、iOS plist の変更、およびバイナリ SDK アップデートは、通常のアプリストアリリースが必要です。これらの変更はネイティブビルドパイプラインに保持し、承認済みの Web レイヤーにはライブアップデートを使用してください。

このプラグインで利用可能な機能

  • 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' });

リファレンス全文

@capgo/capacitor-updater からそのまま続行

使用している場合 @capgo/capacitor-updater Live Update を計画するには、これを次と接続してください Live Update プロダクトのワークフローには、 @capgo/capacitor-updater 実装の詳細については、 スタートガイド, チャンネルや ロールバック.

よくある質問

Updater pluginのFAQ

CapacitorアプリにUpdater pluginをインストールするにはどうすればよいですか?

"bun add @capgo/capacitor-updater"(または"npm install @capgo/capacitor-updater")を実行し、続けて"bunx cap sync"を実行すると、iOSとAndroidのプロジェクトにネイティブのcodeが反映されます。アプリのcodeで"@capgo/capacitor-updater"からインポートしてください。

@capgo/capacitor-updaterはReact、Vue、Angularで動作しますか?

はい。UpdaterはCapacitorパッケージなので、Ionic、React、Vue、Angular、Svelte、プレーンなJavaScriptなど、Capacitor内で動作するあらゆるWebフレームワークで使えます。

@capgo/capacitor-updaterはどのCapacitorバージョンをサポートしていますか?

Capgo プラグインは Capacitor のメジャーバージョンに合わせています。使用している Capacitor のメジャーバージョンに一致するプラグインのメジャーバージョンを使ってください (例: Capacitor 8 ならプラグイン v8)。GitHub の README にある互換性テーブルに、メンテナンス中のバージョンが記載されています。

@capgo/capacitor-updaterは無料かつオープンソースですか?

はい。ソースcodeはGitHubの https://github.com/Cap-go/capacitor-updater/ で公開されており、パッケージはnpmから無料でインストールできます。バグ報告やプルリクエストも歓迎します。

App Storeの審査なしで、Updaterを使用しているcodeをアップデートできますか?

プラグインのインストールやアップグレードはネイティブの code を変更するため、新しいストアビルドが必要です。その後は、プラグインを呼び出す JavaScript、HTML、CSS の変更を Capgo Live Updates で即座に配信できます。

アプリの審査を待たずにUpdaterの変更をリリース

プラグインをストア用ビルドに組み込めば、Capgo live updates で JavaScript、HTML、CSS の変更を数分でユーザーに配信できます

Capgo から始める