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 圧縮されて当社サーバーに保存されますが、開いたり使用したりすることはありません。

変更点

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

これにより、ロールバックや、チャンネルを使って特定のユーザーだけへのデプロイも可能になります。これらの設定は Web インターフェースに再び追加されます:

• Native Buildでの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 チャンネルだけが使われています。将来、複数の public チャンネルが設定されると、public はマルチ 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 を アップデートの動作 実装の詳細はアップデートの動作を、および アップデートの種類 実装の詳細はアップデートの種類を。