トスタープログを読してべる

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

最初に読む

• no_new_version_available 正常な状態であり、失敗ではありません。
• 「更新ありが適用されていない」レポートが多く出るのは、キャッシュの遅延ではなく、ポリシー/設定の拒否であることが多い、特にレスポンスに明示的な error code.
• 使用 npx @capgo/cli@latest app debug 問題を再現する際に、リクエスト/レスポンスの詳細を確認する

一般的なエラー コード

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.* その メジャー bundle のメジャーと一致するように (例えば 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) であるためブロックされる。

• minor ターゲットバンドルのメジャーまたはマイナーバージョンがデバイスのネイティブベースラインと異なる場合にブロックされるversion_build例: 1.2.3 -> 1.3.0 はブロックされています。
• patch はメジャー、ミニ、パッチ番号の変更をすべてブロックします。 version_buildはメジャー、ミニ、パッチ番号の変更をすべてブロックします。ただし、サフィックスの変更のみが許可されます。 MAJOR.MINOR.PATCH は、サフィックスの変更のみが許可されます。 1.0.0-beta.1 -> 1.0.0-beta.2 は、サフィックスの変更のみが許可されます。 1.0.0+build.1 -> 1.0.0+build.2.

Fix

• 現在のポリシーと互換性のあるバンドルをアップロードする、または
• ダッシュボードのCLIでチャネルポリシーを変更する。

関連ドキュメント:

• チャンネル: Auto Update戦略を無効にする

disable_auto_update_to_metadata

原因

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

修正

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

関連ドキュメント:

• チャンネル: Auto Update戦略を無効にする

disable_auto_update_under_native

原因

__CAPGO_KEEP_0__を下回ることはできません。

Fix

• __CAPGO_KEEP_0__バージョン以上または以下のバンドルをアップロードするか、
• __CAPGO_KEEP_0__チャネルで下回る保護を無効にする

関連ドキュメント：

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

cannot_update_via_private_channel

原因

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

Fix

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

関連ドキュメント:

• チャンネル: アプリ内から 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.

関連ドキュメント：

• チャンネル：バンドルバージョニングとチャンネル
• トラブルシューティング：更新が適用されない

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”

key_id_mismatch

修正

暗号化キーとデバイスキーが異なる。

修正

• アプリ設定と暗号化ワークフローで同じ暗号化キー/公開キーを使用する。

no_channel / null_channel_data

原因

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

修正

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

Related docs:

• チャンネル

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に__CAPGO_KEEP_0__ダッシュボードで登録されているものと異なる場合や、ダッシュボードで表示されているアプリケーションIDに「(in」や「) or」が含まれている場合、またはアプリケーションIDがダッシュボードに登録されていない場合、バックエンドは「未知のアプリケーション」と「オンプレミスアプリケーション」を区別できず、同じエラー__CAPGO_KEEP_1__を返します。 plugins.CapacitorUpdater.appId 修正 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.

ダッシュボードで表示されているアプリケーションIDと完全に一致するようにしてください (大文字小文字区別あり)。

• アプリケーションがまだ登録されていない場合、以下のコマンドを実行してください。 app_id アプリケーションが意図的にオンプレミスで実行されている場合、CapgoクラウドURLの代わりに自社の更新エンドポイントを設定してください。
• 組織プランが期限切れの場合、プランを更新またはアップグレードしてください。 npx @capgo/cli@latest app add.
• クイック診断チェックリスト plugins.CapacitorUpdater.updateUrl Capgo
• __CAPGO_KEEP_1__

__CAPGO_KEEP_0__

1. アプリIDとチャンネルがビルド用に正しく設定されているか確認してください。
2. 確認 CapacitorUpdater.version インストール済みのネイティブアプリのバージョンと一致しているか確認してください。
3. 確認disable_auto_update実行中のチャンネルポリシー(
4. )が意図したロールアウトと一致しているか確認してください。
5. 確認 npx @capgo/cli@latest app debug and read backend error code.

実行

• さらに助けが必要ですか？
• How to get support

共通のアップデート問題から進めましょう

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