変更点

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

例

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

• アプリバージョン 1.2.3 (古いバージョン) - 製品チャネルを使用
• アプリバージョン 2.0.0 (新しいバージョンは破壊的変更が含まれています) - 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'

ヒント

このアプローチの利点：

• 常に、更新を受け取るユーザーを制御する 動的チャネル切り替え
• が必要ありません。アプリ内で __CAPGO_KEEP_0__ needed in your app code
• の明確な区別 柔軟性
• 任意のバージョン グループに更新をプッシュする 1. 新バージョン用チャネルを作成する

セクションのタイトル “1. 新バージョン用チャネルを作成する”

# Create channel for version 2.x
npx @capgo/cli channel create 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 のユーザーは "__CAPGO_KEEP_0__" チャンネルにあります。将来のメジャーバージョンでは、特定のチャンネルを設定するようにしてください。 defaultChannel If you didn’t set a production For future major versions, always set a specific channel like v3, v4etc.

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

注意: 古いアプリにnative code/APIが存在しない場合には、JavaScriptバンドルをpushしてはいけません。適切なブランチから常に更新をビルドしてください:

• 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. アプリストアにデプロイする

注意

Note

codeの変更は必要ありません! Since defaultChannel: 'v2' アプリストア版には組み込まれているため、バージョン2.0.0をダウンロードするすべてのユーザーは、自動的に正しいチャンネルを使用します。

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

バージョン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 channel → バージョン 2.x のユーザー
• v3 channel → バージョン 3.x のユーザー

7. マイグレーション後処理

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

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

npx @capgo/cli channel delete v2

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

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

ヒント

ヒント

このアプローチは、ユーザーが使用しているアプリのバージョンに合致する更新のみを受け取るようにします

注記

You can safely delete the v2 channel in Capgo even if some users still have the channel override. They will automatically receive updates from the production channel instead.

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

バージョン 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の互換性のある修正を常に最新に保ちますが、メインから破壊的な変更をマージすることは決してありません。

メインから破壊的な変更の後は続けてください

__CAPGO_KEEP_1__ __CAPGO_KEEP_2__ __CAPGO_KEEP_3__ __CAPGO_KEEP_4__ __CAPGO_KEEP_5__ __CAPGO_KEEP_6__ __CAPGO_KEEP_7__ __CAPGO_KEEP_8__ __CAPGO_KEEP_9__ __CAPGO_KEEP_10__ __CAPGO_KEEP_11__ バージョン対象化ソリューション バージョン対象化ソリューションの製品ワークフロー向け