Common Update Problems

更新チェックが失敗した場合、Capgoは通常 error codeと共に message の /updates レスポンスを返します。このページでは、最も一般的なエラーと最速の修正方法について説明します。

最初に読むこと

• no_new_version_available 正常な状態であり、エラーではありません。
• 多くの「更新が見つかったが適用されなかった」報告は、キャッシュの遅延ではなく、特にレスポンスに明示的な__CAPGO_KEEP_0__が含まれている場合、ポリシー/構成拒否であることが多いです。 error code.
• 問題を再現する際に、リクエスト/レスポンスの詳細を確認してください。 npx @capgo/cli@latest app debug 一般的なエラーコード

「一般的なエラーコード」

disable_auto_update_to_major

チャネルがメジャーアップグレードをブロックしているため (

) 且つ、ターゲットバンドルのメジャーアップグレードバージョンがデバイスのベースラインバージョンより上であるため。disable_auto_update = major一般的な症状

「with」

version: 1.0.8 デバイスがベースライン old: 0.0.0 を報告しているため、メジャーアップグレードは拒否される。 0.0.0メジャーアップグレードを拒否する

How to interpret it

バックエンドは、デバイスのベースラインとターゲットのメジャーバージョンを比較します。 old と version.

• ターゲットが 1.0.1, 1 ベースラインのメジャーバージョンは 1.0.0).
• (例えば 10.0.1ターゲットが 10 , 10.0.0).

ベースラインのメジャーバージョンは

(例えば plugins.CapacitorUpdater.version オプション A (推奨): デバイスのベースラインのメジャーバージョンを合わせる capacitor.config.* そのため __CAPGO_KEEP_0__ 指定したバンドル __CAPGO_KEEP_0__ のバージョンと一致する必要があります (例えば 1.0.0 の 1.0.1, 10.0.0 の 10.0.1).

次に、インストール済みアプリにこの設定を適用してください:

1. 実行 npx cap sync.
2. ネイティブアプリを再構築して再インストールしてください。

オプション B: チャンネルポリシーを緩和する

チャンネル設定でクロスメジャーアウターアップデートを許可する (そのロールアウト戦略が意図的である場合に限り)。

関連ドキュメント:

• バージョン対象化: メジャーバージョン間の自動更新を無効にする
• チャンネル: 自動更新戦略を無効にする

disable_auto_update_to_minor / disable_auto_update_to_patch

原因

チャンネルポリシーは、提供されている更新よりも厳密です (minor または patch)

修正

• 現在のポリシーに適合したバンドルをアップロードする、または
• ダッシュボードのチャネルポリシーを変更する、CLI。

関連ドキュメント:

• チャンネル: 自動更新戦略を無効にする

disable_auto_update_to_metadata

原因

チャンネルはメタデータベースのターゲット設定 (version_number) を使用し、デバイスのベースラインは必要なレベルより下 min_update_version.

修正

• インストール済みのネイティブアプリのバージョンとデバイスのベースラインを (CapacitorUpdater.version) に合わせたり、チャンネル戦略を調整したりします。
• 関連ドキュメント: min_update_version チャンネル: Auto Update戦略を無効にする

セクション “disable_auto_update_under_native”

• 原因

disable_auto_update_under_native

__CAPGO_KEEP_0__

ネイティブ基準以下のダウングレードを防止します。

修正

• ネイティブ基準以上のバンドルバージョンをアップロードするか、またはそのチャンネルに対して「ネイティブ以下」ダウングレード保護を無効にします。
• 関連ドキュメント：

バージョン対象設定：自動ダウングレード防止

• セクション「cannot_update_via_private_channel」

cannot_update_via_private_channel

選択中/デフォルトのチャンネルは、デバイスの自己割り当てを許可していません。

修正

デバイスの自己割り当てを許可する別のチャンネルを使用するか、またはチャンネルを公開/自己割り当てを有効にします。

• Related docs:
• Version Targeting: Auto-Downgrade Prevention

関連ドキュメント:

• チャンネル: アプリから setChannel() を使用する

unknown_version_build / semver_error

原因

デバイスのベースラインバージョンが (、) または有効な semver が欠落しているunknown修正 を.

有効な semver に設定する

• 例えば plugins.CapacitorUpdater.version __CAPGO_KEEP_0__ __CAPGO_KEEP_0__ __CAPGO_KEEP_0__ 1.2.3.
• Sync and rebuild native app.

Related docs:

• Channels: Bundle Versioning and Channels
• Troubleshooting: Updates not applying

unsupported_plugin_version

Cause

Updater plugin version is too old for current backend requirements.

Fix

• Rebuild and reinstall native app. @capgo/capacitor-updater.
• Run npx cap sync.
• Run

disabled_platform_ios / disabled_platform_android

原因

__CAPGO_KEEP_0__チャンネルはそのプラットフォームの更新を無効にしている。

修正

• __CAPGO_KEEP_0__チャンネルでプラットフォームの切り替えを有効にする。

disable_prod_build / disable_dev_build / disable_device / disable_emulator

原因

__CAPGO_KEEP_0__チャンネルは現在のビルドタイプまたは実行時ターゲットを許可していない。

修正

• __CAPGO_KEEP_0__チャンネルの設定をテストのターゲットと合わせる。allow_prod, allow_dev, allow_device, allow_emulatorセクション “key_id_mismatch”

key_id_mismatch

__CAPGO_KEEP_0__

Bundle encryption key and device key differ.

修正

• アプリ設定とバンドル暗号化フローで同じ暗号化キー/公開キーを使用するようにします。

no_channel / null_channel_data

原因

デバイスに有効なチャネルが解決されませんでした。

修正

• デフォルトのクラウドチャネルを設定するか、
• テストビルドの場合、または defaultChannel デバイスにチャネルオーバーライドを割り当てる。
• 関連ドキュメント:

Capgo

• チャンネル

on_premise_app

原因

バックエンドからHTTP 429が返されました。 on_premise_appこれは、次の3つの状況で発生します。

1. App IDがCapgoに存在しない — app_id デバイスから送信された
2. アプリケーションがオンプレミスとしてマークされている — the app exists but is configured for self-hosted updates, so the Capgo cloud endpoint refuses to serve it.
3. アプリケーションが存在するが、セルフホストの更新用に構成されているため、__CAPGO_KEEP_0__クラウドエンドポイントはそれを提供しない。 組織のプランがキャンセルされた

一般的な間違い

アプリケーションIDの plugins.CapacitorUpdater.appId (「」または「」) または __CAPGO_KEEP_0__ ダッシュボードに登録されているアプリケーションIDと一致しない場合。バックエンドでは、「未知のアプリケーション」と「オンプレミスアプリケーション」を区別できず、同じエラー __CAPGO_KEEP_1__ を返します。 capacitor.config.ts) or a mismatch with the app ID registered in the Capgo dashboard. The backend cannot distinguish “unknown app” from “on-premise app”, so it returns the same error code.

確認

• 「」と「」の区別なく、 __CAPGO_KEEP_0__ ダッシュボードに表示されているものと完全に一致していることを確認してください。 app_id matches exactly what is shown in the Capgo dashboard (case-sensitive).
• アプリケーションが意図的にオンプレミスである場合、 npx @capgo/cli@latest app add.
• __CAPGO_KEEP_0__ クラウド URLの代わりに、自社の更新エンドポイントに設定してください。 plugins.CapacitorUpdater.updateUrl to your self-hosted update endpoint instead of the Capgo cloud URL.
• クイック診断チェックリスト

Fix

1. アプリIDとチャンネルがビルド用に正しく設定されていることを確認してください。
2. 確認 CapacitorUpdater.version インストール済みのネイティブアプリのバージョンと一致していることを確認してください。
3. 実行されるチャンネルポリシー(disable_auto_update)が意図されたロールアウトと一致していることを確認してください。
4. このデバイスに許可されているプラットフォーム/ビルドターゲットのスイッチが有効になっていることを確認してください。
5. 実行 npx @capgo/cli@latest app debug バックエンドエラーを読み取ってください: code。

さらに助けが必要ですか?

• トラブルシューティング
• How to get support

共通のアップデート問題から進む

Capacitorを使用している場合 共通のアップデート問題 Capacitorを使用してネイティブプラグインの作業を計画する場合、Capacitorを @capgo/capacitor-updater Capacitorのネイティブ機能に@capgo/capacitor-updaterを使用する Capgo プラグインディレクトリ Capacitorの製品ワークフローにCapgo プラグインディレクトリを使用する Capacitor プラグインズ by Capgo Capacitorの実装詳細にCapacitor プラグインズ by Capgoを使用する プラグインの追加または更新 __CAPGO_KEEP_0__の実装詳細についてはプラグインの追加または更新を参照してください。 Ionic Enterprise プラグインの代替 __CAPGO_KEEP_0__の製品ワークフローについてはIonic Enterprise プラグインの代替を参照してください。