バージョン変更点

バージョン管理チャンネルを使用してアプリのバージョン管理を実施する方法について説明します。このアプローチにより、ユーザーが互換性のあるアップデートを受けながら、アプリの異なるバージョンを維持できます。

例シナリオ

例えば、次のようになります。

• アプリバージョン 1.2.3 (古いバージョン) - プロダクションチャンネルを使用
• アプリバージョン 2.0.0 (新しいバージョンにバグが含まれる) - v2 チャンネルを使用
• Live update 1.2.4 (1.2.3 と互換性があります)
• Live update 2.0.1 (Capacitor 2.0.0 に互換性があります)

Strategy: Major Version の場合、defaultChannel を常に使用する

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

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

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

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

ヒント

このアプローチの利点:

• 常にアップデートを受信するユーザーの制御 を保証します
• アプリ内でダイナミックなチャンネル切り替え code
• 明確な区別 異なるアプリバージョン間の区別
• 柔軟性 任意のバージョングループにアップデートをプッシュする

1. 新バージョン用チャンネルを作成

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

2. バージョン 2.0.0 に対して Capacitor 設定を更新

Capacitorをアップデートしてアプリストア用バージョン2.0.0のビルド前に設定してください。

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のユーザーはチャンネルにあります。将来のメジャーバージョンでは、特定のチャンネルを設定するようにしてください。 defaultChannel 3. 分離された__CAPGO_KEEP_0__ブランチの管理 production __CAPGO_KEEP_0__の設定をコピー v3, v4, etc.

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

Critical: code/APIを提供していない古いアプリにJavaScriptバンドルをプッシュしないでください。適切なブランチから常にアップデートをビルドしてください:

• v1-maintenanceブランチ: 1.xアプリのアップデート (productionチャネル)
• mainブランチ: 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 の変更は必要ありません! 以来 defaultChannel: 'v2' アプリストア版には組み込まれています。すべてのユーザーがバージョン 2.0.0 をダウンロードした場合、自動的に正しいチャネルを使用します。

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

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

# Create channel for version 3.x
npx @capgo/cli channel add 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. v2 チャンネルを削除:

npx @capgo/cli channel delete v2

3. v1-maintenance ブランチを削除:

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

ヒント

このアプローチにより、ユーザーはアプリのバージョンに適合した更新のみを受け取ることが保証されます。

常に各チャンネルで更新を徹底的にテストし、展開する前に

注意

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

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

バージョン 1.x に適合した更新を送信するには:

1. v1-maintenance branch に切り替え:

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.x に互換性のあるバグ修正を含む v1-maintenance branch を最新の状態に保つが、主ブランチから破壊的な変更をマージしないようにしてください。

続きます

「続きます」セクション 破壊的な変更 Live Update チャンネル Live Update チャンネル Live Update チャンネル Live Update チャンネル チャンネル ベータテストソリューション ベータテストソリューション