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

このドキュメントでは、バージョン管理されたチャンネルを使用してアプリのバージョン管理を実現し、ユーザーが互換性のあるアップデートを受け取ることを保証する方法について説明します。

例のシナリオ

まず、以下の状況があります:

• 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'

ヒント

このアプローチの利点:

• 常に更新を受けるユーザーの制御 更新を受けるユーザーを選択
• アプリ内でチャネル切り替えが必要なくなる アプリ code
• 異なるアプリバージョン間の明確な区別 バージョングループに更新を送信する柔軟性
• 1. 新バージョン用のチャネルを作成 2. New Version Channel を作成

3. New Version Channel を選択

# 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;

Note

バージョン 1.x の場合: __CAPGO_KEEP_0__ の設定を未設定の場合 defaultChannel 初期のバージョン 1.x のユーザーは __CAPGO_KEEP_0__ チャンネルにあります。 production 将来のメジャーバージョンでは、特定のチャンネルを常に設定してください。例えば、 v3, v43. 分離された __CAPGO_KEEP_0__ ブランチを管理する

「3. 分離された Code ブランチを管理する」セクション

ターミナル画面

# 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

古いアプリが期待するネイティブ __CAPGO_KEEP_0__/API を持っていない場合、JavaScript バンドルを push してはいけません。常に、適切なブランチからアップデートをビルドしてください: Never push JavaScript bundles to older apps that expect native code/APIs they don’t have. Always build updates from the appropriate branch:

• : 1.x アプリのアップデート (プロダクション チャンネル) に対して__CAPGO_KEEP_0__
• メインブランチ: 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' 将来のバージョンへの拡大

バージョン3.0.0をリリースする際に、さらに破壊的な変更が含まれる場合:

コピー

# 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. バージョン1-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

ヒント

バージョン1のメンテナンスブランチを最新の状態に保つには、バージョン1.xに互換性のあるバグ修正を適用するが、メインから破壊的な変更をマージすることはない

Breaking Changesから続ける

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