ページのオプションをコピー

コピー可能なセットアッププロンプトにインストールステップとこのプラグインの全マークダウンガイドを含めます

このドキュメントでは、バージョン管理されたチャンネルを使用してアプリのバージョン管理とユーザーへの互換性のあるアップデートを実現する方法を説明します。このアプローチにより、ユーザーが互換性のあるアップデートを受けながら、アプリの異なるバージョンを維持できます。

例シナリオ

以下の例を想定します。

App version 1.2.3 (古いバージョン) - 製品チャネルを使用
App version 2.0.0 (新しいバージョンに破壊的な変更が含まれる) - v2 チャネルを使用
Live update 1.2.4 (1.2.3 と互換性がある)
Live update 2.0.1 (2.0.0 と互換性がある)

戦略: メジャーバージョンごとにデフォルトチャネルを常に使用する

メジャーバージョンごとにデフォルトチャネルを設定すること。これにより、特定のユーザーグループにアップデートをプッシュすることができるようになりますが、ダイナミックチャネル割り当てに頼る必要がありません。コピー defaultChannel コピー

// Version 1.x releases
defaultChannel: 'v1'

// Version 2.x releases
defaultChannel: 'v2'

// Version 3.x releases (future)
defaultChannel: 'v3'

__CAPGO_KEEP_0__

# Create channel for version 2.x
npx @capgo/cli channel create v2

2. バージョン 2.0.0 のための Capacitor の設定を更新

バージョン 2.0.0 をアプリストアにビルドする前に、Capacitor の設定を更新してください:

import { CapacitorConfig } from '@capacitor/cli';

const config: CapacitorConfig = {
  appId: 'com.example.app',
  appName: 'Example App',
  plugins: {
    CapacitorUpdater: {
      // ... other options
      defaultChannel: 'v2' // All 2.0.0 users will use v2 channel
    }
  }
};

export default config;

3. 分離されたCodeブランチを管理する

アプリのバージョン間の互換性を維持するために、別々のGitブランチを作成してください。

# Create and maintain a branch for version 1.x updates
git checkout -b v1-maintenance
git push origin v1-maintenance

# Your main branch continues with version 2.x development
git checkout main

重要な注意事項: 古いアプリに存在しないネイティブcode/APIを提供するJavaScriptバンドルをpushしてはなりません。適切なブランチから更新をビルドするようにしてください。

バージョン1-maintenanceブランチ: 1.xアプリの更新用(productionチャンネル)
メインブランチ: 2.xアプリケーション (v2 チャネル) の更新に対して

4. リソースチャネルにバンドルをアップロードする

# For 1.x updates: Build from v1-maintenance branch
git checkout v1-maintenance
# Make your 1.x compatible changes here
npx @capgo/cli bundle upload --channel production

# For 2.x updates: Build from main branch
git checkout main
# Make your 2.x changes here
npx @capgo/cli bundle upload --channel v2

5. 自己割り当てを有効にする

# Allow apps to self-assign to v2 channel
npx @capgo/cli channel set v2 --self-assign

6. アプリストアにデプロイする

アプリストアにバージョン2.0.0をビルドおよびデプロイします。このバージョンをダウンロードするすべてのユーザー（新規ユーザーまたはアップグレード中の既存のユーザー）は、アプリパッケージで構成されているため、自動的にv2チャンネルを使用します。

将来のバージョンへの拡大

ターミナルウィンドウ

# Create channel for version 3.x
npx @capgo/cli channel create v3

// capacitor.config.ts for version 3.0.0
const config: CapacitorConfig = {
  // ...
  plugins: {
    CapacitorUpdater: {
      defaultChannel: 'v3' // Version 3.x users
    }
  }
};

現在は、任意のバージョンにアップデートをプッシュできます:

production チャネル → バージョン 1.x ユーザー
v2 チャネル → バージョン 2.x ユーザー
v3 チャネル → バージョン 3.x ユーザー

7. クリーンアップ (移行後)

すべてのユーザーがバージョン 2.x に移行した後 (約 3-4 か月後):

削除 defaultChannel Capacitor の設定から削除
バージョン 2 のチャネルを削除:

npx @capgo/cli channel delete v2

v1-maintenance branchを削除してください:

git branch -d v1-maintenance
git push origin --delete v1-maintenance

各チャンネルでテストを徹底的に行ってから、更新をデプロイするようにしてください。

バージョン1.xの更新の維持

バージョン 1.x に対応する更新を送信するには:

バージョン 1.x メンテナンスブランチに切り替えます:

git checkout v1-maintenance

変更を加えてコミットしてください:

# Make 1.x compatible changes
git add .
git commit -m "Fix for v1.x"
git push origin v1-maintenance

ビルドとプロダクションチャンネルにアップロードしてください:

npx @capgo/cli bundle upload --channel production

Breaking Changesから続けてください

Breaking Changesを使用している場合 Breaking Changes Capgoのリリースチャンネル機能であるチャンネルチャンネルチャンネルチャンネルチャンネルチャンネルベータテストソリューションベータテストソリューションにおける製品ワークフロー、およびバージョンターゲットソリューションバージョンターゲットソリューションにおける製品ワークフロー。