Skip to content

@capgo/capacitor-updater

Live update for capacitor apps.

Capgoのリアルタイム更新はCapacitorに限られません。同様のバックエンドとCLIを使用して、同系列のクライアントプラグインと共に:

capacitorアプリのライブアップデート

  • notifyAppReady - JavaScriptの初期化が成功したことをネイティブレイヤーに通知する。
  • setUpdateUrl - アプリのアップデートURLを実行時動的に設定する。
  • setStatsUrl - アプリの統計URLを実行時動的に設定する。
  • setChannelUrl - アプリのチャンネルURLを実行時動的に設定する。

パブリックAPI

「パブリックAPI」
メソッド説明
notifyAppReadyJavaScriptの初期化が成功したことをネイティブ層に通知します。
setUpdateUrlアプリの更新URLを実行時動的に設定します。
setStatsUrlアプリの統計URLを実行時動的に設定します。
setChannelUrlアプリのチャンネルURLを実行時動的に設定します。
download指定されたURLから新しいバンドルをダウンロードし、後でインストールします。
nextアプリがバックグラウンドまたは再起動したときに、次にアクティブ化するバンドルを設定します。
setアプリの現在のバンドルを設定し、すぐにアプリをリロードします。
deleteローカルストレージからバンドルを削除してディスクスペースを確保します。
setBundleError手動更新モードで、バンドルをエラーとしてマークします。
list__CAPGO_KEEP_0__
resetアプリを再起動して、保留中のアップデートを適用します。
current保留中のアップデートの適用条件を設定します。
reload保留中のアップデートの適用をキャンセルし、即時適用します。
setMultiDelay最新のバンドルバージョンをアップデートサーバーで確認します。
cancelDelayこのデバイスにローカルランタイムアップデートチャンネルを設定します。デフォルトのチャンネルに戻すには、デバイスのチャンネル割り当てを削除します。
getLatestデバイスのチャンネル割り当てを削除し、デフォルトのチャンネルに戻します。
setChannelSet a local runtime update channel for this device. It does not create a dashboard/API device override.
unsetChannelこのデバイスに割り当てることができるすべてのチャンネルを取得します。
getChannelこのデバイスに一意の識別子を設定します。
listChannelsローカルにダウンロードしたすべてのバンドルを取得します。
setCustomIdアプリを再起動して、保留中のバンドルに戻します。
getBuiltinVersionこのネイティブアプリに含まれているオリジナルのバンドルバージョンを取得します。
getDeviceIdこのデバイスのユニークでプライバシーに優しいIDを取得します。
getPluginVersionCapacitor アップデート プラグインのインストールされているアプリのバージョンを取得します。
isAutoUpdateEnabled自動アップデートが現在有効かどうかを確認します。
removeAllListenersこのプラグインに登録されているすべてのイベントリスナーを削除します。
addListenerアプリ内でバンドルダウンロードイベントをリスンします。ダウンロードが開始されたとき、ダウンロード中、ダウンロードが完了したときに発火します。このイベントはダウンロード中の進行度をすべて返します。
addListener常にアプリが起動されたときに強制的にチェックしたい場合に便利です。
addListener常にアプリが起動されたときに強制的にチェックしたい場合に便利です。
addListenerダウンロードが完了したイベントをリスンします。
addListenerバックエンドが現在のアプリと不互換であると判断した場合にアップデートをブロックする設定でdisableAutoUpdateBreakingを設定した場合に発火します。 majorAvailable バックエンドが現在のアプリと不互換であると判断した場合にアップデートをブロックする設定でdisableAutoUpdateBreakingを設定した場合に発火します。
addListenerメジャーアップデートイベントをリスンします。メジャーアップデートがdisableAutoUpdateBreakingでブロックされている場合に発火します。
addListenerアプリでアップデート失敗イベントをリスンし、次のアプリ起動時にはアップデートがインストールに失敗したことを知らせる。
addListenerアプリでセットイベントをリスンし、バンドルが成功で適用されたことを知らせる。このイベントは、JavaScriptが消費するまでネイティブに保持されるため、アプリが再読み込みされる前にリスナーがアタッチされていない場合、最後の保留中のイベントはリスナーがサブスクライブしたときに配信される。 set アプリでセット次イベントをリスンし、次にインストールされるバンドルのキューがキューされたことを知らせる。
addListenerアプリでダウンロード失敗イベントをリスンし、バンドルのダウンロードが失敗したことを知らせる。
addListenerアプリでリロードイベントをリスンし、リロードが発生したことを知らせる。
addListenerアプリでアプリリードイベントをリスンし、アプリが使用可能になったことを知らせる。このイベントは、JavaScriptが消費するまでネイティブに保持されるため、再読み込みが発生してもリスナーがアタッチされても配信される。
addListenerチャネルプライベートイベントをリスンし、デバイス自律割り当てが許可されていないチャネルを設定しようとしたときに発生する。
addListenerAndroidでフレキシブルアップデートの状態が変化したときにリスンする。
addListener自動アップデート機能が利用可能かどうかを確認する (カスタムサーバー設定によって無効にされていない)。
isAutoUpdateAvailable次のリロード時に有効になるバンドルの情報を取得する。
getNextBundle最後にロードに失敗したバンドルの情報を取得する。
getFailedUpdate自動アップデート機能が利用可能かどうかを確認する (カスタムサーバー設定によって無効にされていない)。
setShakeMenuデバッグとテスト用にシェイクジェスチャーメニューを有効または無効にします。
isShakeMenuEnabledシェイクジェスチャーデバッグメニューが現在有効かどうかを確認します。
setShakeChannelSelectorシェイクチャンネルセレクタを実行時で有効または無効にします。
isShakeChannelSelectorEnabledシェイクチャンネルセレクタが現在有効かどうかを確認します。
getAppId現在設定されているApp IDを取得します。これはアップデートサーバーとの通信に使用されます。
setAppIdアップデートサーバーとの通信に使用されるApp IDを動的に変更します。
getAppUpdateInfoアプリのApp StoreまたはPlay Storeでの利用可能性に関する情報を取得します。
openAppStoreApp StoreまたはPlay Storeでアプリのページを開きます。
performImmediateUpdateAndroidで即時インストールアップデートを実行します。
startFlexibleUpdateAndroidで柔軟なインストールアップデートを開始します。
completeFlexibleUpdateAndroidで柔軟なインストールアップデートを完了します。

ソースオブトゥルス

「ソース オブ トゥルース」

This reference is synced from src/definitions.ts in capacitor-updater.

Capacitorのアップデートプラグインを使用している場合 @capgo/capacitor-updater Appflowへの移行のステップ1 Using @capgo/capacitor-updater for the native capability in Using @capgo/capacitor-updater, Capgo Plugin Directory for the product workflow in Capgo Plugin Directory, Capacitor Plugins by Capgo CapacitorプラグインのCapgo プラグインの追加または更新 プラグインの追加または更新の実装詳細については Ionic Enterprise プラグインの代替 Ionic Enterprise プラグイン代替の製品ワークフローについては