メインコンテンツへスキップ
Capgo - Capacitor アプリのビルド、リリース、アップデート Capgo

V3からV4へ

アップグレードの理由

「今回のアップグレードの理由」セクション

Discordコミュニティでの皆さんの意見を聞き、これまでのマニュアルモードは手動すぎて安全性が低いことに気づきました。例えば、auto-revertができなかったため、手動アップデートに失敗するとユーザーはアプリを再インストールしなければならず、UXとして非常に劣っていました。

そこで、皆さんにさらなる自由を提供し、私が作成したこれまでの不備のある code をすべて排除する機会としました。

インストール

「インストール」セクション

npm i @capgo/capacitor-updater@4

クラウドの自動アップデート

「Auto-update cloud」セクション

アプリで基本的な実装を行っている場合、そのまま新しいバージョンへ安全に移行できます。ぜひお試しください！

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

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

使い勝手は変わらずシンプルですが、変更点は以下の通りです：

  • 設定名の変更： autoUpdateUrl における updateUrl
  • Endpoint メソッドが以下のように変更されました： GET POST に変更

手動ユーザー

「Manual users」セクション

これが最も大きな変更点ですが、その分メリットも非常に大きいです！多くの改善が行われていますので、よくお読みください。

変更点

「Changes」セクション
  • autoUpdateUrl に変わります updateUrl この設定が手動モードでも利用可能になったため
  • の削除 cancelDelay と delayUpdate に移行しました setDelay
  • 廃止されました versionName に設定済み
  • 変更 version 多くの関数でオブジェクトとして返されていた key を 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に設定してください。

ニュース

「News」セクション
  • メソッド getLatest, このメソッドを使用すると、サーバーから設定された updateUrl 最新バージョンを取得できます。
  • メソッド setDelay が、 {種類: “background” | “kill” | “nativeVersion” | “date” の値: string} を引数として、各モードの遅延を設定できます。
  • メソッド next, 次回のバックグラウンド移行時にバージョンを設定します。これは、 set が即座に実行するのとは対照的です。
  • メソッド isAutoUpdateEnabled、auto-updateコンテキスト内であることを通知します
  • イベント downloadComplete ダウンロードが100%に達したとき
  • 必須フィールドを追加 version downloadメソッド内に
  • notifyAppReady manualモードでも必須になりました。10秒以内に呼び出さない場合、アプリは以前のバージョンにロールバックされます。

コントリビューター

「Contributors」セクション

@lincolnthree このプロジェクトを立ち上げてくれて本当にありがとう。あなたの協力なしには、このアップデートを実現することは不可能でした。

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

「V3からV4への移行」セクション

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