一般的な更新問題

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

最初に読む

• no_new_version_available 正常な状態であり、エラーではありません。
• 多くの「更新が見つかったが適用されなかった」報告は、キャッシュの遅延ではなく、特にレスポンスに明示的な error code
• が含まれている場合、特にポリシー/構成拒否です。 npx @capgo/cli@latest app debug __CAPGO_KEEP_0__

一般的なエラー コード

disable_auto_update_to_major

原因

あなたのチャネルはメジャーアップグレードをブロックしています (disable_auto_update = major)、そしてターゲット バンドルのメジャー バージョンはデバイスのベースライン バージョンより上です。

一般的な症状

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

解釈の方法

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

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

オプション A (推奨): デバイスのベースラインのメジャーバージョンを合わせる

を plugins.CapacitorUpdater.version に capacitor.config.* 、その MAJOR __CAPGO_KEEP_0__を指定したバージョンにマッチするバンドル MAJOR を使用します (例えば 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

「disable_auto_update_to_metadata」を無効にする

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

修正

• インストール済みのネイティブアプリのバージョンと一致するデバイスのベースライン (CapacitorUpdater.version) を設定する、または
• 調整 min_update_version / チャンネル戦略。

関連ドキュメント:

• チャンネル: Auto Update戦略の無効

disable_auto_update_under_native

原因

チャンネルはネイティブのベースライン以下のダウングレードを防止する

修正

• バンドルバージョンがネイティブ基準以上であるか、または
• そのチャンネルで「ネイティブ」ダウングレード保護を無効にする。

関連ドキュメント：

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

cannot_update_via_private_channel

原因

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

修正

• 異なるチャンネルを使用して、自己割り当てを有効にするか、または
• チャンネルを公開 / 自己割り当てを有効にする。

関連ドキュメント：

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

unknown_version_build / semver_error

原因

デバイスのベースバージョンが指定されていません ( ) または、有効な semver ではありません。unknown修正

「」に有効な semver を設定

• Sync と native アプリの再構築 plugins.CapacitorUpdater.version 関連ドキュメント: 1.2.3.
• チャンネル: バンドル バージョニングとチャンネル

トラブルシューティング: アップデートの適用が機能しません

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

unsupported_plugin_version

原因

アップデートプラグインのバージョンが古いため、現在のバックエンドの要件に適合していません。

解決

• アップグレード @capgo/capacitor-updater.
• 実行 npx cap sync.
• ネイティブアプリを再構築してインストールしてください。

disabled_platform_ios / disabled_platform_android

原因

チャンネルでそのプラットフォームの更新が無効になっています。

解決

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

disable_prod_build / disable_dev_build / disable_device / disable_emulator

原因

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

対策

• チャネルオプション (allow_prod, allow_dev, allow_device, allow_emulator) をテスト対象と合わせてください。

key_id_mismatch

原因

アプリのバンドル暗号化キーとデバイスキーが異なります。

対策

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

no_channel / null_channel_data

原因

__CAPGO_KEEP_0__

修正

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

チャネル

• セクション「on_premise_app」

on_premise_app

バックエンドからHTTP 429が返されました

Related docs: __CAPGO_KEEP_0__ on_premise_app. このような状況が 3 つあります:

1. Capgo の App ID が存在しない場合 — デバイスから送信された情報が登録されていないため、バックエンドにはその情報が記録されていない。 app_id App がオンプレミスとしてマークされている
2. — アプリが存在するが、自社で更新を実行するように設定されているため、__CAPGO_KEEP_0__ のクラウドエンドポイントはそのアプリを提供しない。 — the app exists but is configured for self-hosted updates, so the Capgo cloud endpoint refuses to serve it.
3. — アプリの組織が有効なサブスクリプションを持っていないため、アプリのアカウントが無効になっている。 よくある間違い

アプリの ID に誤植がある

(「」や「」) または、__CAPGO_KEEP_0__ のダッシュボードに登録されているアプリ ID と一致していない。 plugins.CapacitorUpdater.appId バックエンドでは「未知のアプリ」と「オンプレミスアプリ」を区別できないため、同じエラー __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.

修正

• 確認する app_id Capgo ダッシュボードに表示されているものと完全に一致することを確認してください (大文字小文字区別あり)。
• __CAPGO_KEEP_0__ アプリがまだ登録されていない場合、以下のコマンドを実行してください。 npx @capgo/cli@latest app add.
• __CAPGO_KEEP_0__ アプリが意図的にオンプレミスにインストールされている場合、__CAPGO_KEEP_0__ クラウド URL の代わりに自社の更新エンドポイントを設定してください。 plugins.CapacitorUpdater.updateUrl to your self-hosted update endpoint instead of the Capgo cloud URL.
• クイック診断チェックリスト

「クイック診断チェックリスト」のセクション

1. 確認
2. インストール済みのネイティブ アプリのバージョンと一致することを確認してください。 CapacitorUpdater.version Quick diagnostic checklist
3. チャンネルポリシー (disable_auto_update) が予定されたロールアウトと一致します。
4. プラットフォーム/ビルドのターゲットの切り替えがこのデバイスを許可します。
5. 実行 npx @capgo/cli@latest app debug バックエンドエラーを読みます code。

さらにヘルプが必要ですか?

• トラブルシューティング
• サポートを受ける方法