メインコンテンツへスキップ

V3からV4へ

Discordコミュニティでの皆さんのフィードバックを多数いただき、マニュアルモードは手動作業が多く、安全に使用できないことがわかりました。例えば、自動ロールバックが不可能で、更新に失敗するとユーザーがアプリを削除して再インストールする必要があり、UXとして最悪でした。

その間、これを機会に、皆さんにより多くの自由度を与え、私が作成したすべての悪いcodeを削除しました。

npm i @capgo/capacitor-updater@4

アプリで基本的なサンプルを使用している場合、新しいバージョンへの移行は安全です。お楽しみください!

セルフホストの自動アップデート

「Auto-update self-hosted」セクション

あなたにとっても簡単です。変更点は以下の通りです:

  • 設定の名称から autoUpdateUrl における updateUrl
  • Endpoint メソッドが次から変更されました GET POST に

あなたにとっては最も大きな変更ですが、良い方向の変更です!多くの改善が含まれているので、よく読んでください。

  • autoUpdateUrl に変わります updateUrl この設定が手動モードでも使えるようになったため
  • の削除 cancelDelay と delayUpdate の代わりに setDelay
  • もう不要 versionName に設定済み
  • 変更内容 version キー(ほとんどの関数でオブジェクトとして返されていたもの) BundleInfo
interface BundleInfo {
id: string;
version: string;
downloaded: string;
status: 'success' | 'error' | 'pending' | 'downloading'
}
  • 紛らわしい名称をリネームしました(説明では分かりにくいかもしれませんが、使用時は新しい名称の方が理解しやすいです):
    • 以前は〜と呼ばれていたもの version は、現在〜を指します bundle
    • id 旧〜を参照 version これは10文字のランダムな文字列でしたが、 id は、あなたのbundleにアクセスするための唯一の信頼できる方法です。例: 7Dfcd2RedN.
    • version 以下を参照してください versionName bundle に選ぶもの、例 1.0.0
  • updateUrl から移行 get まで post。カスタムヘッダーが一部の方で問題となっていたことと、post の方が論理的であることから、従来のヘッダーはすべて body に移動し、プレフィックス cap_ はなくなります。
  • versionName メソッドは削除され、代わりに getId
  • list は現在、次のリストを返します BundleInfo
  • 名前変更 getId における getDeviceId
  • autoUpdate デフォルトで true になります。Manual モードを使用する場合は、false に設定してください。
  • メソッド getLatest、このメソッドにより、サーバーで設定された updateUrl 最新バージョンを取得できます。
  • メソッド setDelay が {種類: “background” | “kill” | “nativeVersion” | “date”、value? : string} を引数として渡すことで、異なるモードの遅延を設定できます。
  • メソッド next、次のバックグラウンド化時のバージョンを設定します。 set すぐに実行できます。
  • メソッド isAutoUpdateEnabled、自動更新コンテキスト内かどうかを知らせるため
  • イベント downloadComplete ダウンロードが100%に達したとき
  • 必須フィールドを追加 version downloadメソッド内で
  • notifyAppReady manualモードでも必須になります。10秒以内に呼び出さない場合、アプリは以前のバージョンに戻ります。

コントリビューター

「Contributors」セクション

@lincolnthree この取り組みを始めてくれて本当にありがとうございます。あなたなしではこのアップデートを動作させることは不可能でした。

V3からV4への移行を続ける

セクション「V3からV4へ進む」

使用している場合 V3からV4へ live update の配信を計画するには、以下と連携させます: Capgo Live Update Capgo Live Updates のプロダクトワークフロー向けに、 概要 実装の詳細は Overview を 機能 実装の詳細は Features を アップデートの動作 実装の詳細はアップデートの動作を、および アップデートの種類 実装の詳細はアップデートの種類を。