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

__CAPGO_KEEP_2__

__CAPGO_KEEP_3__

例えば、以下のような状況があります：

• Appバージョン 1.2.3（古いバージョン） - 製品チャネルを使用
• App version 2.0.0 (new version with breaking changes) - v2 チャネルを使用します。
• ライブアップデート 1.2.4（1.2.3と互換性あり）
• ライブアップデート 2.0.1（2.0.0と互換性があります）

戦略：すべてのメジャーバージョンでは、defaultChannel を常に使用する

推奨アプローチ: 更新設定 defaultChannel すべてのメジャーバージョンに対して。 これにより、特定のユーザーグループにアップデートを常にプッシュできるようになり、ダイナミックチャネル割り当てに頼る必要がなくなります。

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

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

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

ヒント

このアプローチの利点:

• 常に更新を受けるユーザーの制御 更新を受けるユーザーを選択しなくても
• 必要ありません。 アプリ内で code
• 異なるアプリバージョンとの明確な区別 柔軟性
• 任意のバージョングループに更新を送信する 1. 新バージョン用のチャンネルを作成する

1. __CAPGO_KEEP_0__

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

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

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

capacitor.config.ts

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;

注意

バージョン 1.x の場合: バージョン 1.x の場合、__CAPGO_KEEP_0__ の設定を設定していない場合は defaultChannel 初期のバージョン1.xのユーザーは production チャンネルにあります。 将来のメジャーバージョンでは、特定のチャンネルを常に設定してください v3, v4、など

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してはいけません。 どのブランチからも適切な更新をビルドしてください:

• v1-maintenanceブランチ: 1.xアプリの更新 (プロダクションチャンネル) について
• メイン ブランチ: 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 チャンネルを使用します。

注記

code の変更は必要ありません! バンドルに含まれているため、バージョン 2.0.0 をダウンロードするすべてのユーザーは、自動的に正しいチャンネルを使用します。 defaultChannel: '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 か月後):

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

npx @capgo/cli channel delete v2

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

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

ヒント

このアプローチにより、ユーザーはアプリのバージョンに合致する更新のみを受信します。

各チャンネルでテストを徹底的に行うことで、常に更新を安全に展開することができます。

注記

Capgoでv2チャンネルを安全に削除することができます。ユーザーがチャンネルオーバーライドを保持している場合でも、自動的にプロダクションチャンネルから更新を受信します。

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

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

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

git checkout v1-maintenance

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

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

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

npx @capgo/cli bundle upload --channel production

ヒント

v1-maintenance branchを最新の状態に保つには、バグ修正がバージョン1.xと互換性があるものを使用してくださいが、mainから破壊的な変更をマージすることはありません。

Breaking Changesから続けてください。

Capgoを使用している場合 Breaking Changes Capgoのチャネルルーティングとステージドロールを計画するために使用するには、Channelsを接続してください。 チャンネル チャンネル チャンネル チャンネル チャンネル チャンネル ベータテスト ソリューション ベータテスト ソリューションにおける製品ワークフロー、および バージョン ターゲット ソリューション バージョン ターゲット ソリューションにおける製品ワークフロー。