コンテンツにジャンプする

バージョン対象

このガイドでは、ユーザーのネイティブアプリのバージョンに基づいて、最新の互換性のあるバンドルを自動的にユーザーに提供する方法を説明します。 Ionic AppFlowのアプローチと似ています。

を参照してください。

概要

Capgo’s version targeting system allows you to:

  • __CAPGO_KEEP_0__のバージョン対象システムは、次の機能を提供します:自動的に互換性のある更新を提供する ユーザーに、nativeアプリのバージョンに基づいて更新を提供します。
  • 破壊的な変更を防止します。 非互換のアプリバージョンに到達する更新を防ぎます。
  • 複雑なロジックなしで複数のアプリバージョンを管理します。 複数のアプリバージョンを同時に管理する複雑なロジックなしで。
  • 特定のユーザーセグメントに更新を無問題に展開します。 バージョン対象化の重要性(特にAppFlowユーザー向け)

バージョン対象化の重要性(特にAppFlowユーザー向け)というセクションのタイトル

Ionic AppFlowのご存知のとおり、

Ionic AppFlow 、ユーザーが互換性のある更新を受け取ることを保証することは、非常に重要です。 AppFlowは、ライブアップデートのバンドルをnativeアプリのバージョンに自動的にマッチさせ、古いnative __CAPGO_KEEP_0__に互換性のないJavaScriptが配信されるのを防ぎました。, you know how critical it is to ensure users receive only compatible updates. AppFlow automatically matched live update bundles to native app versions, preventing incompatible JavaScript from being delivered to older native code.

Capgoは安全性の保証を提供します, 付加機能が含まれます:

  • バージョンマッチングのより細かい制御
  • チャンネル、semver、ネイティブ制約の複数戦略
  • バージョン分布のより良好な視覚化
  • APIとCLIはダッシュボード管理とともに制御されます

このアプローチは、特に以下のシナリオで役立ちます:

  • ユーザーがアプリの異なるメジャーバージョン (例: v1.x、v2.x、v3.x) にある場合
  • 破壊的な変更をロールアウトする際にバックワード互換性を維持する必要がある場合
  • 新しいバンドルが古いネイティブcodeを破壊しないようにする場合
  • ユーザーを一つのバージョンから別のバージョンに段階的に移行する場合
  • AppFlowから移行する場合 と同様の更新の安全性を維持したい

Capgo uses a multi-layered approach to match users with compatible updates:

  1. 「Live Update How It Works Title」「How It Works」
  2. __CAPGO_KEEP_0__は、ユーザーが互換性のある更新とマッチするように、多層アプローチを使用します:Native Version Constraints
  3. : 不互換のネイティブバージョンにバンドルを配信しないようにするChannel-Based Routing
  4. : 異なるアプリバージョンを異なるアップデートチャンネルにルーティングするSemantic Versioning Controls : Automatically block updates across major/minor/patch boundaries

バージョンマッチングフロー

バージョンマッチングフローのセクション
graph TD
A[User Opens App] --> B{Check Device Override}
B -->|Override Set| C[Use Override Channel]
B -->|No Override| D{Check local plugin channel}
D -->|setChannel value| E[Use local setChannel channel]
D -->|No local channel| F{Check defaultChannel in App}
F -->|Has defaultChannel| G[Use App's defaultChannel]
F -->|No defaultChannel| H[Use Cloud Default Channel]
C --> I{Check Version Constraints}
E --> I
G --> I
H --> I
I -->|Compatible| J[Deliver Update]
I -->|Incompatible| K[Skip Update]

チャンネルベースのバージョンルーティング戦略1

チャンネルベースのバージョンルーティング戦略1のセクション

この 推奨アプローチ メジャーバージョンアップデートと破壊的な変更の管理に適したアプローチです。AppFlowの配信モデルに似ています。

  • (100,000ユーザー) → バージョンマッチングフローの例 production チャンネル
  • App v2.x (50,000ユーザーに破壊的な変更を含む) → v2 チャンネル
  • App v3.x (10,000のベータユーザー) → v3 チャンネル

Step 1: 各主なバージョンごとにチャンネルを設定する

「Step 1: 各主なバージョンごとにチャンネルを設定する」のセクション
// capacitor.config.ts for version 1.x builds
import { CapacitorConfig } from '@capacitor/cli';
const config: CapacitorConfig = {
appId: 'com.example.app',
appName: 'Example App',
plugins: {
CapacitorUpdater: {
autoUpdate: 'atBackground',
defaultChannel: 'production', // or omit for default
}
}
};
export default config;
// capacitor.config.ts for version 2.x builds
const config: CapacitorConfig = {
appId: 'com.example.app',
appName: 'Example App',
plugins: {
CapacitorUpdater: {
autoUpdate: 'atBackground',
defaultChannel: 'v2', // Routes v2 users automatically
}
}
};
// capacitor.config.ts for version 3.x builds
const config: CapacitorConfig = {
appId: 'com.example.app',
appName: 'Example App',
plugins: {
CapacitorUpdater: {
autoUpdate: 'atBackground',
defaultChannel: 'v3', // Routes v3 users automatically
}
}
};

ステップ 2: チャンネルを作成

ステップ 2: チャンネルを作成
ターミナル画面
# Create channels for each major version
npx @capgo/cli channel create production
npx @capgo/cli channel create v2
npx @capgo/cli channel create v3
# Enable self-assignment so apps can switch channels
npx @capgo/cli channel set production --self-assign
npx @capgo/cli channel set v2 --self-assign
npx @capgo/cli channel set v3 --self-assign

ステップ 3: バージョンに特化したパッケージをアップロード

ステップ 3: バージョンに特化したパッケージをアップロード
ターミナル画面
# For v1.x users (from v1-maintenance branch)
git checkout v1-maintenance
npm run build
npx @capgo/cli bundle upload --channel production
# For v2.x users (from v2-maintenance or main branch)
git checkout main
npm run build
npx @capgo/cli bundle upload --channel v2
# For v3.x users (from beta/v3 branch)
git checkout beta
npm run build
npx @capgo/cli bundle upload --channel v3
  • Zero code changes チャンネルルーティングは自動的に行われます。
  • 明確な分離 各バージョンには独自のアップデートパイプラインがあります。
  • 柔軟なターゲット 特定のバージョングループにアップデートをプッシュできます。
  • 安全なロールアウト 互換性のないバージョンには破壊的な変更が届きません。

戦略 2: セマンティック バージョニング制御

セクション「戦略 2: セマンティック バージョニング制御」

Capgoの組み込み セマンティック バージョニング制御 バージョン境界を超えた更新を防止する

メジャー バージョンを跨いだ自動更新を無効にする

ターミナル画面
クリップボードにコピー
# Create a channel that blocks major version updates
npx @capgo/cli channel create stable --disable-auto-update major

アプリのバージョン

  • は、バージョン 1.2.3 までの更新を受け取ります。 1.9.9
  • ユーザーは バージョン 2.0.0 自動的に
  • codeの古いネイティブバージョンに破壊的な変更が到達するのを防ぐ
  • ネイティブの基準として送信されたものを使用する比較 version_build
ターミナルウィンドウ
# Block target bundles outside the native major.minor line (1.2.x won't get 1.3.0)
npx @capgo/cli channel set stable --disable-auto-update minor
# Block target bundles outside the exact native MAJOR.MINOR.PATCH core (1.2.3 won't get 1.2.4)
npx @capgo/cli channel set stable --disable-auto-update patch
# Allow all updates
npx @capgo/cli channel set stable --disable-auto-update none

セクション「戦略 3: ネイティブ バージョン制約」

各パッケージに最小限のネイティブ アプリ バージョン (

) を指定することで、__CAPGO_KEEP_0__ は、ネイティブ バイナリが十分に新しいデバイスのみに配信することができます。min_update_version) on each bundle so Capgo only delivers it to devices whose native binary is new enough.

メタデータ 戦略 ( ) を使用します。--disable-auto-update metadataこの戦略は、チャンネルメタデータ戦略 ( --min-update-version または --auto-min-update-version __CAPGO_KEEP_0__ --native-version CLI flag.

チャンネルでメタデータ ターゲットを有効にする

ターミナル画面
コピー
# one-time: require min_update_version metadata on uploads to this channel
npx @capgo/cli@latest channel set production --disable-auto-update metadata

ターミナル画面

コピー
# This bundle requires native version 2.0.0 or higher
npx @capgo/cli@latest bundle upload \
--channel production \
--min-update-version "2.0.0"

または Capgo がネイティブパッケージの互換性からフロアを設定します:

ターミナルウィンドウ
npx @capgo/cli@latest bundle upload \
--channel production \
--auto-min-update-version

Capgo solutions marketing page の UI ラベル。ロール: UI ラベル。見られる場所: ページsolutions/qsr.astro。メッセージキー: `solutions_qsr_usecases_label` (Solutions Qsr Usecases Label)。

「用途」セクション
  1. 新しいネイティブ プラグインが必要

    ターミナル ウィンドウ
    # Bundle needs Camera plugin added in v2.0.0
    npx @capgo/cli@latest bundle upload \
    --channel production \
    --min-update-version "2.0.0"
  2. ネイティブ API の重大な変更

    ターミナル ウィンドウ
    # Bundle uses new Capacitor 6 APIs
    npx @capgo/cli@latest bundle upload \
    --channel production \
    --min-update-version "3.0.0"
  3. 段階的な移行

    ターミナル ウィンドウ
    # one-time: enable metadata gating on beta
    npx @capgo/cli@latest channel set beta --disable-auto-update metadata
    # Test bundle only on latest native version
    npx @capgo/cli@latest bundle upload \
    --channel beta \
    --min-update-version "2.5.0"

自動ダウン グレード防止戦略 4

「自動ダウン グレード防止戦略 4」セクション

最新バージョンを対象にする

Capgo ダッシュボードで

  1. Go to チャンネル コンテキスト:Capgoのリリースチャンネルの機能名。ページ/エリア:Capgoのソリューションマーケティングページ。ロール:短いUIラベルまたはナビゲーションアイテム。見られる場所:ページソリューション/ホワイトラベル.astro。メッセージキー`solutions_white_label_visual_cell2_value` (ソリューション ホワイトラベル ビジュアル セル2 値)。
  2. → チャンネルを選択 有効
  3. 「ネイティブの自動ダウングレードを無効にする」

Or via CLI:

または、__CAPGO_KEEP_0__ で以下のようにします。
npx @capgo/cli@latest channel set production --no-downgrade
  • ユーザーのデバイス:ネイティブ版 1.2.5
  • チャンネルパッケージ:バージョン 1.2.3
  • 結果: ダウングレードの場合のアップデートがブロックされる

これは、以下のシナリオで役立ちます。

  • ユーザーがアプリストアから新しいバージョンを手動でインストールした場合
  • ユーザーが最新のセキュリティパッチを保証する必要がある場合
  • バグのリグレッションを防止したい場合

特定のデバイスまたはユーザーグループにチャンネル割り当てをオーバーライドする。

テスト用に特定のバージョンを強制する。

コピー
import { CapacitorUpdater } from '@capgo/capacitor-updater'
// Force beta testers to use v3 channel
async function assignBetaTesters() {
const deviceId = await CapacitorUpdater.getDeviceId()
// Check if user is beta tester
if (isBetaTester(userId)) {
await CapacitorUpdater.setChannel({ channel: 'v3' })
}
}

Section titled “デバイスオーバーライドダッシュボード””

Capgoダッシュボードで:

In the Capgo dashboard:

  1. デバイス → デバイスを検索 クリック
  2. Section titled “バージョン強制テスト” Channelを設定 または Channelを設定するか、バンドルバージョンを指定して上書き
  3. 上書きしたソースからアップデートを受信するデバイス
  4. テストアップデート

「完全なAppFlowスタイルのワークフロー」のセクション

ここでは、すべての戦略を組み合わせた完全な例が示されています:

1. 初期設定 (App v1.0.0)

Terminal window
# Create production channel, then enable metadata min-version gating
npx @capgo/cli@latest channel add production
npx @capgo/cli@latest channel set production \
--disable-auto-update metadata \
--no-downgrade
capacitor.config.ts
const config: CapacitorConfig = {
plugins: {
CapacitorUpdater: {
autoUpdate: 'atBackground',
defaultChannel: 'production',
}
}
};

セクションのタイトル “2. リリースブレーク変更 (アプリ v2.0.0)”

Section titled “2. Release Breaking Change (App v2.0.0)”
Terminal window
# Create v2 channel for new version
npx @capgo/cli@latest channel add v2
npx @capgo/cli@latest channel set v2 \
--disable-auto-update metadata \
--no-downgrade \
--self-assign
# Create git branch for v1 maintenance
git checkout -b v1-maintenance
git push origin v1-maintenance
// capacitor.config.ts for v2.0.0
const config: CapacitorConfig = {
plugins: {
CapacitorUpdater: {
autoUpdate: 'atBackground',
defaultChannel: 'v2', // New users get v2 channel
}
}
};

セクションのタイトル “3. 両方のバージョンにアップデートをプッシュする”

セクションのタイトル “3. 両方のバージョンにアップデートをプッシュする”
ターミナル画面
# Update v1.x users (bug fix)
git checkout v1-maintenance
# Make changes
npx @capgo/cli@latest bundle upload \
--channel production \
--min-update-version "1.0.0"
# Update v2.x users (new feature)
git checkout main
# Make changes
npx @capgo/cli@latest bundle upload \
--channel v2 \
--min-update-version "2.0.0"

Capgo ダッシュボードを使用して、以下を追跡します。

  • v1 と v2 のユーザー数
  • バンドル採用率 (バージョン別)
  • バージョンごとのエラーまたはクラッシュ

v1 の使用率が閾値以下になったら

ターミナル画面
# Stop uploading to production channel
# Optional: Delete v1 maintenance branch
git branch -d v1-maintenance
# Move all remaining users to default
# (They'll need to update via app store)

チャンネル順位

チャンネル順位

Capgoが複数のチャンネル設定を使用する場合、次の順位順序を使用します。

  1. デバイスオーバーライド (ダッシュボードまたはAPI) - 最高優先度であり、デバイスオーバーライドUIに表示されます。
  2. ローカルプラグインチャンネル via setChannel() - デバイス上のみ保存され、デバイスオーバーライドUIに表示されません。
  3. defaultChannel capacitor.config.ts
  4. デフォルトチャンネル (Cloudflare設定) - 最低優先度
// ✅ Good: Each major version has explicit channel
// v1.x → production
// v2.x → v2
// v3.x → v3
// ❌ Bad: Relying on dynamic channel switching
// All versions → production, switch manually

2. セマンティックバージョニングを使用する

セクション “2. セマンティックバージョニングを使用する”
ターミナル画面
# ✅ Good
1.0.0 1.0.1 1.1.0 2.0.0
# ❌ Bad
1.0 1.1 2 2.5

3. 分離されたブランチを維持する

セクション “3. 分離されたブランチを維持する”
ターミナル画面
# ✅ Good: Separate branches per major version
main (v3.x)
v2-maintenance (v2.x)
v1-maintenance (v1.x)
# ❌ Bad: Single branch for all versions
ターミナル画面
# one-time: create beta and enable metadata gating
# (production is set up in the complete workflow above)
npx @capgo/cli@latest channel add beta
npx @capgo/cli@latest channel set beta --disable-auto-update metadata
# Test on beta channel first
npx @capgo/cli@latest bundle upload \
--channel beta \
--auto-min-update-version
# Monitor for issues, then promote to production
npx @capgo/cli@latest bundle upload \
--channel production \
--auto-min-update-version

5. バージョン分布の監視

「5. バージョン分布の監視」

ダッシュボードを定期的に確認してください:

  • ユーザーが最新のネイティブバージョンにアップグレードしていますか?
  • 古いバージョンが高トラフィックを受けているのはなぜですか?
  • 古いチャンネルを非推奨にするべきですか?

Ionic AppFlow Ionic AppFlow、ここではCapgoのバージョン対象化の比較方法について説明します。

機能イオニック アプリフローCapgo
バージョンベースのルーティングネイティブバージョンに基づく自動ネイティブバージョンに基づく自動 defaultChannel 自動
バージョンセマンティック バージョニング基本的なサポート --disable-auto-update 高度な__CAPGO_KEEP_0__
ネイティブ バージョン制約AppFlow ダッシュボードでの手動設定組み込み --min-update-version / --auto-min-update-version メタデータ チャンネルとともに
チャンネル管理Web UI + CLIWeb UI + CLI + API
デバイス上のオーバーライド制限されたデバイスレベル制御フルコントロールはダッシュボードの API から
ダウングレード防止はいはい、以下の方法で --no-downgrade
複数バージョンのメンテナンス手動のブランチ/チャネル管理チャネル優先の自動管理
自主ホスティングいいえはい(完全な制御)
バージョン分析基本バージョンごとの詳細なメトリクス

トラブルシューティング

更新を受け取らないユーザー

トラブルシューティング

  1. 確認することチャンネル割り当て

    const channel = await CapacitorUpdater.getChannel()
    console.log('Current channel:', channel)
  2. コピーする (クリップボードにコピーする) です。バージョン制約: バンドルのネイティブバージョン要件があるか確認してください

    • ダッシュボード → バンドル → "ネイティブバージョン" 列を確認してください
  3. Semver 設定: チャネルの disable-auto-update 設定

    ターミナルウィンドウ
    npx @capgo/cli channel list
  4. デバイスオーバーライド: デバイスに手動オーバーライドがあるか確認してください

    • ダッシュボード → デバイス → デバイスを検索 → チャネル/バージョンを確認

間違ったバージョンにバンドルが配信された

「間違ったバージョンにバンドルが配信された」セクション
  1. デフォルトチャンネルを確認する: 正しいチャンネルが選択されていることを確認する capacitor.config.ts
  2. バンドルアップロードを確認する: 指定されたチャンネルにバンドルがアップロードされたことを確認する
  3. 最小バージョンアップデートを確認する: 最小バージョンアップデートが設定されていることを確認する --min-update-version (または) --auto-min-update-version) が設定されていて、チャンネルが --disable-auto-update metadata

古いバージョンに影響を与える変更

「古いバージョンに影響を与える変更」
  1. 直ちの修正: 影響を受けるデバイスに安全なバンドルを強制する
    • ダッシュボード → デバイス → Bulk select → バージョン設定
  2. 長期的な修正: バージョン化されたチャンネルを作成し、分離されたブランチを維持
  3. 予防: リリース前に代表的なデバイスでアップデートをテストする

Ionic AppFlow からマイグレーション

Ionic AppFlow からマイグレーション

Ionic AppFlow からマイグレーションする場合、バージョン対象は __CAPGO_KEEP_0__ における、改善された柔軟性とともに非常に類似しています。 概念マッピング, version targeting works very similarly in Capgo, with improved flexibility:

Ionic AppFlow からマイグレーションする場合、バージョン対象は __CAPGO_KEEP_0__ における、改善された柔軟性とともに非常に類似しています。

概念マッピング
AppFlow ConceptCapgo EquivalentNotes
Deploy ChannelCapgo Channel同様の概念、より強力なもの
ネイティブバージョンロック--min-update-version / --auto-min-update-versionより細かい制御
チャンネル優先順位優先順位の順序 (override → クラウド → デフォルト)より透明な優先順位
展開対象チャンネル + semver制御複数の戦略が利用可能
プロダクション チャンネルproduction チャンネル (または任意の名前)柔軟な名前付け
Git ベースのデプロイCLI ブランチからバンドルアップロード同じワークフロー
自動バージョンマッチングdefaultChannel + バージョン制約複数の戦略を組み合わせた強化
  1. より多くの制御: Capgoは、複数の戦略(チャネル、semver、ネイティブバージョン)を組み合わせることができる
  2. より良い可視性: ダッシュボードはバージョン分布と互換性の問題を表示
  3. APIアクセス: バージョン対象の完全なプログラム制御
  4. 自社ホスティング: 同じバージョンロジックを持つアップデートサーバーを実行するオプション
  1. AppFlowチャンネルをマップする CapgoのCapgoチャンネル(通常1:1)
  2. 設定 defaultChannelcapacitor.config.ts 各メジャーバージョン
  3. semverルールを設定 バージョン境界での自動ブロッキングが必要な場合
  4. バージョン固有のバンドルをアップロード 使用 --min-update-version (チャンネルはメタデータ戦略を使用している必要があります)
  5. バージョン分布を監視 CapgoのCapgoダッシュボード

バージョンごとの段階的なロールアウト

「バージョンごとの段階的なロールアウト」のセクション
// Gradually migrate v1 users to v2
async function migrateUsers() {
const deviceId = await CapacitorUpdater.getDeviceId()
const rolloutPercentage = 10 // Start with 10%
// Hash device ID to get deterministic percentage
const hash = hashCode(deviceId) % 100
if (hash < rolloutPercentage) {
// User is in rollout group - migrate to v2
await CapacitorUpdater.setChannel({ channel: 'v2' })
}
}
// Enable features based on native version
async function checkFeatureAvailability() {
const info = await CapacitorUpdater.getDeviceId()
const nativeVersion = info.nativeVersion
if (compareVersions(nativeVersion, '2.0.0') >= 0) {
// Enable features requiring v2.0.0+
enableNewCameraFeature()
}
}
// Run A/B tests within same native version
async function assignABTest() {
const nativeVersion = await getNativeVersion()
if (nativeVersion.startsWith('2.')) {
// Only A/B test on v2 users
const variant = Math.random() < 0.5 ? 'v2-test-a' : 'v2-test-b'
await CapacitorUpdater.setChannel({ channel: variant })
}
}

Capgo は、バージョンに特化した更新の配信に複数の戦略を提供します:

  1. チャンネルベースのルーティング: バージョン分離を自動的に実行する defaultChannel
  2. シーケンスバージョニング: メジャー/マイナー/パッチ境界を跨る更新を防止する
  3. ネイティブバージョン制約: バンドルのための最小限のネイティブバージョンを要求する
  4. 自動ダウングレード防止: 最新バージョンのネイティブに古いバンドルを配信しない
  5. Device Overrides: テストとターゲットのための手動制御

これらの戦略を組み合わせると、より多くの柔軟性と制御を備えたAppFlowスタイルの自動更新配信が実現できます。アプリのバージョニングとデプロイワークフローに最も適したアプローチを選択してください。

特定の機能についての詳細はこちら

バージョン ターゲティングを使用している場合 バージョン ターゲティング バージョン ターゲティング チャンネル ルーティングとステージド ロールアウトの計画に使用するには、チャンネルと接続する必要があります チャンネル チャンネル チャンネル チャンネル ベータ テスト ソリューション ベータ テスト ソリューション ベータ テスト ソリューション バージョン対象化ソリューション バージョン対象化ソリューション用の製品ワークフロー