破壊的変更
インストール手順と、このプラグインの完全なMarkdownガイドを含むセットアッププロンプトをコピーします。
このドキュメントでは、バージョン管理されたチャンネルを使ってアプリの破壊的変更に対処する方法を説明します。このアプローチなら、アプリの異なるバージョンを維持しつつ、ユーザーには互換性のあるアップデートを届けられます。
シナリオ例
「シナリオ例」セクション例えば、次のような状況です:
- アプリバージョン 1.2.3(旧バージョン)- production チャンネルを使用
- アプリバージョン 2.0.0(破壊的変更を含む新バージョン)- v2 チャンネルを使用
- Live update 1.2.4(1.2.3 と互換性あり)
- Live update 2.0.1(2.0.0 と互換性あり)
戦略:メジャーバージョンでは常に defaultChannel を使用する
セクション「戦略: メジャーバージョンでは常に defaultChannel を使用する」推奨されるアプローチ: 設定する defaultChannel すべてのメジャーバージョンで。これにより、動的なチャネル割り当てに頼らず、特定のユーザーグループに常にアップデートをプッシュできます。
// Version 1.x releasesdefaultChannel: 'v1'
// Version 2.x releasesdefaultChannel: 'v2'
// Version 3.x releases (future)defaultChannel: 'v3'1. 新バージョン用のChannelを作成
セクション「1. 新バージョン用のチャンネルを作成」# Create channel for version 2.xnpx @capgo/cli channel add v22. バージョン2.0.0用にCapacitorの設定を更新
セクション「2. バージョン 2.0.0 用に Capacitor 設定を更新」App Store 向けにバージョン 2.0.0 をビルドする前に、Capacitor の設定を更新してください:
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;3. 別の Code ブランチを管理する
「3. 別の Code ブランチを管理する」というタイトルのセクションアプリのバージョン間の互換性を維持するために、Git ブランチを分けて作成してください:
# Create and maintain a branch for version 1.x updatesgit checkout -b v1-maintenancegit push origin v1-maintenance
# Your main branch continues with version 2.x developmentgit checkout main重要: ネイティブの code/API を前提としているのに、それを持たない古いアプリには JavaScript bundle をプッシュしないでください。アップデートは必ず適切なブランチからビルドしてください:
- v1-maintenance ブランチ:1.x アプリのアップデート用(production チャネル)
- main ブランチ:2.x アプリのアップデート用(v2 チャネル)
4. 各チャネルに Bundle をアップロードする
「4. 各チャネルに Bundle をアップロードする」というタイトルのセクション# For 1.x updates: Build from v1-maintenance branchgit checkout v1-maintenance# Make your 1.x compatible changes herenpx @capgo/cli bundle upload --channel production
# For 2.x updates: Build from main branchgit checkout main# Make your 2.x changes herenpx @capgo/cli bundle upload --channel v25. Self-Assignmentを有効にする
セクション「5. 自己割り当てを有効にする」# Allow apps to self-assign to v2 channelnpx @capgo/cli channel set v2 --self-assign6. App Storeへデプロイ
セクション「6. App Store にデプロイする」バージョン 2.0.0 をビルドして App Store にデプロイします。このバージョンをダウンロードしたすべてのユーザー(新規ユーザーもアップグレードする既存ユーザーも)は、アプリのバンドルに設定されているため、自動的に v2 チャネルを使用します。
将来のバージョンへのスケーリング
「将来のバージョンへのスケーリング」セクションより多くの破壊的変更を含むバージョン 3.0.0 をリリースする場合:
# Create channel for version 3.xnpx @capgo/cli channel add v3// capacitor.config.ts for version 3.0.0const config: CapacitorConfig = { // ... plugins: { CapacitorUpdater: { defaultChannel: 'v3' // Version 3.x users } }};これで、任意のバージョンに更新をプッシュできます:
productionchannel → バージョン 1.x ユーザーv2channel → バージョン 2.x ユーザーv3channel → バージョン 3.x ユーザー
7. クリーンアップ(移行後)
セクション「7. クリーンアップ(移行後)」すべてのユーザーがバージョン2.xへ移行完了した後(目安:3〜4ヶ月後):
- 削除
defaultChannelCapacitor の設定から - v2 チャンネルを削除します:
npx @capgo/cli channel delete v2- v1-maintenance ブランチを削除します:
git branch -d v1-maintenancegit push origin --delete v1-maintenanceデプロイ前に、各チャネルで更新を徹底的にテストしてください。
バージョン1.xのアップデートを維持
セクション「Version 1.x の更新を維持する」Version 1.x と互換性のある更新を送信するには:
- v1-maintenance ブランチに切り替えます:
git checkout v1-maintenance- 変更を加えてコミットします:
# Make 1.x compatible changesgit add .git commit -m "Fix for v1.x"git push origin v1-maintenance- ビルドして本番環境のチャネルにアップロードします:
npx @capgo/cli bundle upload --channel productionBreaking Changesの続きへ進む
「Breaking Changes」から続ける使用している場合 破壊的変更 チャンネルルーティングと段階的ロールアウトを計画するには、次と組み合わせてください: チャンネル Channelsの実装の詳細については、 チャンネル Channelsの実装の詳細については、 チャンネル Channelsの実装の詳細については、 ベータテストソリューション ベータテストソリューションのプロダクトワークフロー向け、および バージョンターゲティングソリューション バージョンターゲティングソリューションのプロダクトワークフロー向け。