Breaking Changes

バージョン管理チャンネルを使用したアプリのバージョン管理についての説明です。このアプローチにより、異なるバージョンのアプリを維持し、ユーザーが互換性のある更新を受け取ることができます。

例

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

• アプリバージョン 1.2.3 (古いバージョン) - プロダクションチャンネルを使用しています
• App version 2.0.0 (new version with breaking changes) - uses v2 channel
• リアルタイム更新 1.2.4 (1.2.3 と互換性があります)
• リアルタイム更新 2.0.1 (2.0.0 と互換性があります)

Strategy: Always Use defaultChannel for Major Versions

推奨アプローチ: Set a defaultChannel for every major version. This ensures you can always push updates to specific user groups without relying on dynamic channel assignment.

// 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. 新バージョン用チャネルを作成する」
• ターミナル画面 コピーする

Cloudflare

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

2. Capacitor のバージョン 2.0.0 に対する設定を更新してください。

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 チャンネルに設定されていました。将来のメジャーバージョンでは、特定のチャンネルに設定するようにしてください。例えば、 production など v3, v4など

3. Code を分離管理する

__CAPGO_KEEP_0__ アプリのバージョン間の互換性を維持するために、分離された 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 の古いアプリに存在しないネイティブ 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 チャンネルを使用します。これは、アプリバンドルに設定されているためです。

注意

No 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 チャンネル → バージョン2.xユーザー
• v3 channel → バージョン 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

ヒント

このアプローチにより、ユーザーは自分のアプリのバージョンに合致する更新のみを受け取る

各チャネルで更新を徹底的にテストすること

注意

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

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

バージョン1.xに合致する更新を送信するには

1. v1-maintenanceブランチに切り替えます

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. バージョン1.xに互換性のあるバグ修正を含むv1-maintenance branchを最新の状態に保つ

npx @capgo/cli bundle upload --channel production

ヒント

バージョン1.xに互換性のあるバグ修正を含むv1-maintenance branchを最新の状態に保つが、バージョン1.xの破壊的な変更をマージしない

バージョン1.xの破壊的な変更から続けてください

Capgoを使用している場合 Breaking Changes チャンネルルーティングとステージドロールアウトの計画に使用するには、 Channels チャンネルについての実装詳細はChannelsを参照してください。 Channels チャンネルについての実装詳細はChannelsを参照してください。 Channels チャンネルについての実装詳細はChannelsを参照してください。 ベータテストソリューション ベータテストソリューションで使用する製品ワークフローについては バージョン目標ソリューション バージョン対象ソリューションの製品ワークフローについてです。