V3からV4へ
インストール手順と、このプラグインの完全なMarkdownガイドを含むセットアッププロンプトをコピーします。
アップグレードの理由
「このアップグレードの理由」セクションDiscordコミュニティでの皆さんのフィードバックを多数いただき、マニュアルモードは手動作業が多く、安全に使用できないことがわかりました。例えば、自動ロールバックが不可能で、更新に失敗するとユーザーがアプリを削除して再インストールする必要があり、UXとして最悪でした。
その間、これを機会に、皆さんにより多くの自由度を与え、私が作成したすべての悪いcodeを削除しました。
インストール
「インストール」セクションnpm i @capgo/capacitor-updater@4
自動更新クラウド
「Auto-update cloud」セクションアプリで基本的なサンプルを使用している場合、新しいバージョンへの移行は安全です。お楽しみください!
セルフホストの自動アップデート
「Auto-update self-hosted」セクションあなたにとっても簡単です。変更点は以下の通りです:
- 設定の名称から
autoUpdateUrlにおけるupdateUrl - Endpoint メソッドが次から変更されました
GETPOST に
手動ユーザー
「手動ユーザー」セクションあなたにとっては最も大きな変更ですが、良い方向の変更です!多くの改善が含まれているので、よく読んでください。
変更点
「変更点」セクション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以下を参照してくださいversionNamebundle に選ぶもの、例1.0.0
- 以前は〜と呼ばれていたもの
updateUrlから移行getまでpost。カスタムヘッダーが一部の方で問題となっていたことと、post の方が論理的であることから、従来のヘッダーはすべて body に移動し、プレフィックスcap_はなくなります。versionNameメソッドは削除され、代わりにgetId- list は現在、次のリストを返します
BundleInfo - 名前変更
getIdにおけるgetDeviceId autoUpdateデフォルトで true になります。Manual モードを使用する場合は、false に設定してください。
ニュース
「News」セクション- メソッド
getLatest、このメソッドにより、サーバーで設定されたupdateUrl最新バージョンを取得できます。 - メソッド
setDelayが{種類:“background” | “kill” | “nativeVersion” | “date”、value? : string}を引数として渡すことで、異なるモードの遅延を設定できます。 - メソッド
next、次のバックグラウンド化時のバージョンを設定します。setすぐに実行できます。 - メソッド
isAutoUpdateEnabled、自動更新コンテキスト内かどうかを知らせるため - イベント
downloadCompleteダウンロードが100%に達したとき - 必須フィールドを追加
versiondownloadメソッド内で notifyAppReadymanualモードでも必須になります。10秒以内に呼び出さない場合、アプリは以前のバージョンに戻ります。
コントリビューター
「Contributors」セクション@lincolnthree この取り組みを始めてくれて本当にありがとうございます。あなたなしではこのアップデートを動作させることは不可能でした。
V3からV4への移行を続ける
セクション「V3からV4へ進む」使用している場合 V3からV4へ live update の配信を計画するには、以下と連携させます: Capgo Live Update Capgo Live Updates のプロダクトワークフロー向けに、 概要 実装の詳細は Overview を 機能 実装の詳細は Features を アップデートの動作 実装の詳細はアップデートの動作を、および アップデートの種類 実装の詳細はアップデートの種類を。