__CAPGO_KEEP_0__

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

例えば、

次の状況を想定します。

• アプリバージョン 1.2.3 (古いバージョン) - プロダクションチャンネルを使用
• アプリバージョン 2.0.0 (新しいバージョンでバグ修正が含まれる) - v2 チャンネルを使用
• Live update 1.2.4 (1.2.3 と互換性がある)
• Live update 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. 新バージョン用チャンネルを作成」

ターミナル画面

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

Capacitor の設定をアップデートして、バージョン 2.0.0 をアプリストア用にビルドする前に

Update your Capacitor config before building version 2.0.0 for the app store:

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 の場合: __CAPGO_KEEP_0__ を初期設定しなかった場合、バージョン 1.x のユーザーは __CAPGO_KEEP_0__ チャンネルにあります。将来のメジャーバージョンでは、特定のチャンネルを指定するようにしてください、など。 defaultChannel 3. 分離された __CAPGO_KEEP_0__ ブランチを管理する production バージョン間の互換性を維持するために、分離された Git ブランチを作成します: v3, v4ターミナル画面

3. Manage Separate Code Branches

バージョン間の互換性を維持するために、分離された 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 アプリケーション (プロダクション チャネル) のアップデート
• 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 チャネルを使用するようになります。理由は、アプリのバンドルに v2 チャネルが設定されているためです。

注意

code の変更は必要ありません! バージョン 2.0.0 はアプリストア版に含まれているため、すべてのユーザーがこのバージョンをダウンロードした場合、自動的に正しいチャネルを使用するようになります。 defaultChannel: 'v2' 将来のバージョンにスケールする

scaling to future versions

バージョン 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. 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. ビルドとアップロードをプロダクション チャネルに:

npx @capgo/cli bundle upload --channel production

ヒント

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

続ける

バージョン 1.x に互換性のあるバグ修正を含む v1-maintenance branch を最新の状態に保つが、main から破壊的な変更をマージすることはない Breaking Changes to plan channel routing and staged rollout, connect it with バージョン 1.x に互換性のあるバグ修正を含む v1-maintenance branch を最新の状態に保つが、main から破壊的な変更をマージすることはないです。 Channelsの実装詳細について Channels Channelsの実装詳細について Channels Channelsの実装詳細について Betaテストソリューション Betaテストソリューションの製品フローについて、 バージョン目標ソリューション バージョン目標ソリューションの製品フローについて。