メインコンテンツへスキップ

破壊的変更

このドキュメントでは、バージョン管理されたチャンネルを使ってアプリの破壊的変更に対処する方法を説明します。このアプローチなら、アプリの異なるバージョンを維持しつつ、ユーザーには互換性のあるアップデートを届けられます。

例えば、次のような状況です:

  • アプリバージョン 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 releases
defaultChannel: 'v1'
// Version 2.x releases
defaultChannel: 'v2'
// Version 3.x releases (future)
defaultChannel: 'v3'
ターミナル
# Create channel for version 2.x
npx @capgo/cli channel add v2

2. バージョン2.0.0用にCapacitorの設定を更新

セクション「2. バージョン 2.0.0 用に Capacitor 設定を更新」

App Store 向けにバージョン 2.0.0 をビルドする前に、Capacitor の設定を更新してください:

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;

アプリのバージョン間の互換性を維持するために、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/API を前提としているのに、それを持たない古いアプリには JavaScript bundle をプッシュしないでください。アップデートは必ず適切なブランチからビルドしてください:

  • v1-maintenance ブランチ:1.x アプリのアップデート用(production チャネル)
  • main ブランチ:2.x アプリのアップデート用(v2 チャネル)
ターミナル
# 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
ターミナル
# Allow apps to self-assign to v2 channel
npx @capgo/cli channel set v2 --self-assign

バージョン 2.0.0 をビルドして App Store にデプロイします。このバージョンをダウンロードしたすべてのユーザー(新規ユーザーもアップグレードする既存ユーザーも)は、アプリのバンドルに設定されているため、自動的に v2 チャネルを使用します。

将来のバージョンへのスケーリング

「将来のバージョンへのスケーリング」セクション

より多くの破壊的変更を含むバージョン 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 channel → バージョン 1.x ユーザー
  • v2 channel → バージョン 2.x ユーザー
  • v3 channel → バージョン 3.x ユーザー

すべてのユーザーがバージョン2.xへ移行完了した後(目安:3〜4ヶ月後):

  1. 削除 defaultChannel Capacitor の設定から
  2. v2 チャンネルを削除します:
ターミナル
npx @capgo/cli channel delete v2
  1. v1-maintenance ブランチを削除します:
ターミナル
git branch -d v1-maintenance
git push origin --delete v1-maintenance

デプロイ前に、各チャネルで更新を徹底的にテストしてください。

バージョン1.xのアップデートを維持

セクション「Version 1.x の更新を維持する」

Version 1.x と互換性のある更新を送信するには:

  1. v1-maintenance ブランチに切り替えます:
ターミナル
git checkout v1-maintenance
  1. 変更を加えてコミットします:
ターミナル
# Make 1.x compatible changes
git add .
git commit -m "Fix for v1.x"
git push origin v1-maintenance
  1. ビルドして本番環境のチャネルにアップロードします:
ターミナル
npx @capgo/cli bundle upload --channel production

Breaking Changesの続きへ進む

「Breaking Changes」から続ける

使用している場合 破壊的変更 チャンネルルーティングと段階的ロールアウトを計画するには、次と組み合わせてください: チャンネル Channelsの実装の詳細については、 チャンネル Channelsの実装の詳細については、 チャンネル Channelsの実装の詳細については、 ベータテストソリューション ベータテストソリューションのプロダクトワークフロー向け、および バージョンターゲティングソリューション バージョンターゲティングソリューションのプロダクトワークフロー向け。