V2からV3への移行

このドキュメントでは、auto-updateをバージョン3へアップグレードする方法について説明します。

まず、最新のツールへ移行してください：

npm remove -g capgo
npm remove capacitor-updater

npm i @capgo/cli
npm i @capgo/capacitor-updater@3
npx cap sync

以前の設定をすべて削除してください：

{
  CapacitorUpdater: {
      autoUpdateURL: "https...",
      ...
  },
}

以下の内容のみを残すようにします：

{
  "CapacitorUpdater": {
    "autoUpdate": true
  }
}

⚠️ 自前のサーバーを使用していた場合、 autoUpdateURLこのガイドは近日中に更新予定です。それまでの間、新しい upload オプションを確認してください。 external これにより、Capgo クラウド内の code ではなく、zip ファイルのリンクのみを送信できるようになります。これはプライバシーポリシーが厳しい企業向けに設計されました。外部モードでは、code が Capgo サーバーに届くことはありません。URLを保存してデバイスに送信するだけで、デバイスが直接ダウンロードを行います。標準的な方法では、code が zip 圧縮されて当社のサーバーに保存されますが、内容を開封したり使用したりすることはありません。

変更点

自動アップデートの設定がすべてサーバーサイドに移行しました。これにより、ユーザーへのアップデート配信方法をより細かく制御できるようになります。

これにより、ロールバックや、チャンネル機能を使った特定のユーザーへのデプロイも可能になります！これらの設定はウェブインターフェースに追加されています：

• Native環境でのrevertを無効化
• メジャーバージョン以上のアップデートを無効化

⚠️ すべてのチャンネルでデフォルトでtrueになります

これにより、プラグインを頻繁に更新する必要がなくなります。ほとんどのアップデートはサーバーサイドで行われるため、クライアント側の変更なしに適用されます。

⚠️ アップデートがデフォルトになるとリセットされます。ストアからのアップデート時にすべてのダウンロード済みバージョンを削除したくない場合は、以下を行ってください：

{
  "CapacitorUpdater": {
    "autoUpdate": true,
    "resetWhenUpdate": false
  }
}

code をアップデートしてください

最後に、JS内のすべてのimportを以下から変更してください：

import { CapacitorUpdater } from 'capacitor-updater'

へ

import { CapacitorUpdater } from '@capgo/capacitor-updater'

その後、code を再度ビルドします npm run build そして、もう一度アセットをコピーします npx cap copy.

これで最新の自動アップデートシステムをテストできるはずです

以下の方法でバージョンを送信してください：

npx @capgo/cli@latest bundle upload

ではなく

npx capgo upload

今後の展開

現在は最初のパブリックチャンネルのみが使用されていますが、将来、複数のパブリックチャンネルが設定された場合は、public の扱いが複数のパブリックチャンネルに変わります。

よくある問題：

• アップグレード後のビルド問題：Android StudioやXcodeでプラグインのcodeソースをすでに開いている場合、同期しても削除されないことがあり、これが問題の原因です。ネイティブIDEを開いて削除してください。 capacitor-updater 手動で削除して、 npx cap sync これで解決するはずです。

V2からV3へ進む

以下を使用している場合： V2からV3への移行 live updateの配信を計画し、それを以下と連携させるために Capgo Live Updates Capgo Live Updatesのプロダクトワークフローについては、 概要 Overviewの実装詳細については、 機能 機能の詳細については、Featuresをご参照ください。 Updateの挙動 Update Behavior の実装詳細については、 アップデートの種類 Update Types の実装詳細については、