デバッグ
このプラグインのインストール手順と完全なマークダウンガイドを含む設定の質問をコピーする。
クラウドログの理解:
セクション：クラウドログの理解If you get a cloud refusal code and need concrete remediation steps, see 一般的な更新問題.
Capgoログにはイベントのメタデータが含まれる場合があります。ダッシュボードで、下記のスネークケースアクションcodeをフィルタリングし、メタデータセルをクリックしてフルJSONペイロードをコピーする。メタデータは、エラー メッセージ、ソースURL、行、列、プロセス状態、メモリ圧力、プラットフォーム固有の理由など、クラッシュとWebViewイベントのコンテキストを含むため、特に有用です。古いログは、括弧内にリストされているレガシーキャメルケースエイリアスを表示する場合もあります。
バックエンドから送信
セクション：バックエンドから送信| code | 説明 |
|---|---|
| 無効なIP (__CAPGO_KEEP_0__) | Googleデータセンターに位置するユーザーは、更新が4時間未満の場合、更新は行われません。この制限は、Googleのボットのデバイスがユーザーのアカウントにカウントされないようにするためです。 |
| __CAPGO_KEEP_1__ (__CAPGO_KEEP_1__以前に __CAPGO_KEEP_2__) | プランの制限に達したため、デバイスはアップデートを受け取ることができません。プランをアップグレードするか、次の月まで待つ必要があります。 |
| __CAPGO_KEEP_3__ (最新のバージョンが利用可能です。) | __CAPGO_KEEP_4__ |
| 期待どおりのシーケンスバージョン形式を採用していないネイティブバージョンです。 | InvalidIp |
| iOSプラットフォームが無効化されています (disablePlatformIos) | このデバイスはiOSプラットフォームですが、チャネル設定で無効化されています。 |
| Androidプラットフォームが無効化されています (disablePlatformAndroid) | このデバイスはAndroidプラットフォームですが、チャネル設定で無効化されています。 |
| 自動更新は互換性ポリシーにより無効化されています。メタデータには (マッチングルールとして) | 、または auto_update 自動更新はNativeモード下で無効化されています major, minor, patch, metadatadisable_auto_update_under_native none. |
| disable_auto_update (__CAPGO_KEEP_0__) | このデバイスのバージョンは (1.2.3) です。チャネルは、デバイスのバージョンより新しいバージョン (1.2.2) を送信するように設定されていますが、その機能はチャネル設定で無効にされています。 |
| __CAPGO_KEEP_0__ (__CAPGO_KEEP_0__) | このデバイスは開発用ビルドですが、その機能はチャネル設定で無効にされています。 |
| __CAPGO_KEEP_0__ (__CAPGO_KEEP_0__) | このデバイスはエミュレータですが、その機能はチャネル設定で無効にされています。 |
| __CAPGO_KEEP_0__ (__CAPGO_KEEP_0__) | バンドルダウンロードの有効署名URLを生成できませんでした。この問題は、バンドルURLの生成が失敗したり、無効なURLを返したりし、フォールバックとしてマニフェストが利用できない場合に発生します。 |
| プライベートチャンネルを介して更新できません。 (プライベートチャンネルを介して更新できません。) | デバイスはプライベートチャンネルと自己関連付けしようとしたが、チャンネル設定ではデバイスの自己関連付けを許可していません (allow_device_self_set チャンネル設定が不正です。 |
| チャンネル設定ではバージョン番号を使用した自動更新を無効に設定しています ( (バンドルの) | フィールドがnullのため、更新対象となるデバイスを決定できません。disable_auto_update: 'version_number'バージョン番号を使用した自動更新を無効に設定しています。 min_update_version バンドルの |
| メタデータ (のフィールドがnullのため、更新対象となるデバイスを決定できません。) | バージョン番号メタデータにより、自動更新が無効化されています。チャンネルは、デバイスのバージョンが少なくとも min_update_versionですが、デバイスの現在のバージョンはこの閾値以下です。 |
| disable_auto_update_to_major (disableAutoUpdateToMajor) | チャンネル設定 disable_auto_update: 'major' メジャーバージョン番号の増加を含む更新をブロックします、例えば 1.x.x から更新するのをブロックします。 2.x.x. |
| disable_auto_update_to_minor (disableAutoUpdateToMinor) | チャンネル設定 disable_auto_update: 'minor' メジャーまたはマイナーバージョンがデバイスのネイティブベースラインと異なるターゲットパッケージをブロックします (version_build), 例えば 1.2.3 -> 1.3.0. |
| disable_auto_update_to_patch (disableAutoUpdateToPatch) | チャンネル設定 disable_auto_update: 'patch' メジャー、ミニマム、パッチ番号の変更をすべて阻止します。 version_buildサフィックスの変更のみ許可されます。 MAJOR.MINOR.PATCH バージョン番号の前方部分は変更されません。 1.0.0-beta.1 -> 1.0.0-beta.2. |
| missing_bundle (missingBundle) | このチャンネルに割り当てられたバンドルにはダウンロード可能なコンテンツがありません。 external_urlバンドルにはダウンロード可能なコンテンツがありません。 r2_pathこれは、バンドルが組み込まれたバージョンではなく、ダウンロード可能なマニフェストエントリが存在しないことを意味します。 |
| no_channel (NoChannelOrOverride) | このアプリにはデフォルトのチャネルが設定されていません。デバイスには特定のチャネルオーバーライドが割り当てられていません。少なくとも1つは存在する必要があります。アップデートが機能するため。 |
| rate_limited (rateLimited) | このデバイスは、過剰なリクエストのため、リクエスト制限を受けました。 |
| key_id_mismatch (keyMismatch) | デバイスの暗号化公開鍵は、バンドルを暗号化するために使用された公開鍵と一致しません。メタデータには device_key_id, bundle_key_id, version 、 |
を含みます。
デバイスから送信されたものです。| code | 説明 |
|---|---|
| ping | 内部テスト用のアクションで、統計システムが正しく動作していることを確認します。 |
| get | 新バージョンのダウンロード情報がデバイスに送信されました。 |
| delete | デバイス上の1つのバンドルが削除されました。 |
| set | デバイス上のバンドルが設定されました。 |
| set_fail | バンドルが設定に失敗しました。 |
| reset | デバイスは builtin bundle. |
| download_XX | XX% (10%単位)で進捗状況を示す新しいバンドルがダウンロードされました。 |
| download_complete | 新しいバンドルがダウンロード完了しました。 |
| download_manifest_start | デバイスはアップデートマニフェストのダウンロードを開始しました。 |
| download_manifest_complete | デバイスはアップデートマニフェストのダウンロードを完了しました。 |
| download_zip_start | The device started downloading the bundle archive. |
| ダウンロードが完了しました。 | The device finished downloading the bundle archive. |
| マニフェストファイルのダウンロードに失敗しました。 | One manifest entry failed to download; the stats payload puts version_name 形式で version:fileName を特定するために |
| download_manifest_checksum_fail | マニフェストファイルのチェックサム検証に失敗しました。 |
| download_manifest_brotli_fail | マニフェストファイルのBrotliの展開に失敗しました。 |
| download_fail | The new bundle failed to download. |
| update_fail | The new bundle has been installed but failed to call notifyAppReady. |
| checksum_fail | The new bundle failed to validate the checksum. This can happen for several reasons: 1) Checksum type mismatch: The latest version of the CLI and plugins (version 5.10.0+, 6.25.0+ or 7+) use SHA256 checksums, while older plugins used CRC32. If you see a checksum fail, check if the checksum is CRC32 (a shorter hash) rather than SHA256. This usually indicates the bundle was uploaded with an old version of the CLI. Verify your bundle version in the Capgo dashboard - bundles created since version 5.10.0/6.25.0/7 should use SHA256. If you’re seeing CRC32 checksums, ensure you have the latest plugin version installed locally (the CLI checks your local plugin version to determine which checksum type to upload), then upgrade your CLI and re-upload the bundle. 2) Encryption key mismatch (on plugin versions below 8.3.0 or 5/6/7.38.0): 新しいプラグインバージョン 8.3.0 以降 (または 5/6/7.38.0 以降) では、デバイスの公開鍵とアップロードに使用した鍵が一致しない場合、暗号化が失敗し、チェックサムエラーが発生します。 checksum_failバンドルをアップロードした際に使用したプライベートキーがアプリの capacitor.config.json と一致していることを確認してください。バンドルを再アップロードするには、最新のプラグインバージョンをインストールしてください。 keyMismatch 3) Bundle encryption failed: |
| windows_path_fail | zipファイルに、Windowsパスの不正なファイルが含まれています。 |
| canonical_path_fail | ファイルのパスが正しくありません。 |
| directory_path_fail | zipファイルのパスにエラーが発生しました。 |
| unzip_fail | アンパックに失敗しました。 |
| low_mem_fail | デバイスのメモリが不足しているためダウンロードに失敗しました。 |
| app_moved_to_background | アプリケーションがバックグラウンドに移動しました。 |
| app_moved_to_foreground | アプリケーションが前景状態に移行しました。 |
| app_crash | アプリケーションはJavaScriptまたはCapacitorレイヤーからクラッシュを報告しました。メタデータにはメッセージ、スタック、ソース、またはアクティブなバンドルコンテキストが含まれます。 |
| app_crash_native | ネイティブレイヤーはプラットフォームクラッシュを報告しました。メタデータにはプラットフォーム、理由、スタック、または利用可能なプロセス詳細が含まれます。 |
| app_anr | Androidはアプリケーションが応答しないことを報告しました。メタデータにはANRの理由、スレッド、または利用可能なトレースサマリーが含まれます。 |
| app_killed_low_memory | アプリケーションプロセスは低メモリ圧力の後に殺されました。メタデータには利用可能なメモリとプラットフォームシグナルが含まれます。 |
| app_killed_excessive_resource_usage | OSはアプリケーションを過剰なリソース使用のために殺しました。メタデータにはリソースタイプまたはプラットフォームの理由が含まれます。 |
| アプリケーション初期化失敗 | アップデーターまたはアプリケーション起動フローは、通常の実行時間が利用可能になる前に失敗しました。メタデータには失敗したステップとエラーメッセージが含まれる場合があります。 |
| アプリケーションメモリ警告 | iOS がメモリ警告を報告しました。メタデータには利用可能な場合にアクティブなバンドルとメモリコンテキストが含まれる場合があります。 |
| Web View の JavaScript エラー | Web View が未処理の JavaScript エラーを報告しました。メタデータにはメッセージ、ソース URL、行、列、スタックが含まれる場合があります。 |
| Web View の未処理の承認 | Web View が未処理の承認を報告しました。メタデータには拒否理由、ソース URL、スタックが含まれる場合があります。 |
| Web View のリソースエラー | Web View のリソースがロードに失敗しました。メタデータには URL、ステータス code、リソースタイプ、エラーメッセージが含まれる場合があります。 |
| Web View のセキュリティポリシー違反 | Web View がコンテンツセキュリティポリシー違反を報告しました。メタデータにはブロックされた URI、ディレクティブ、ドキュメント URL が含まれる場合があります。 |
| webview_不完全再起 | アプリは、前のWebViewセッションが正常に終了せずに終了したことを検出しました。この機能は、更新後にクラッシュループを特定するのに役立ちます。 |
| webviewレンダラープロセス消失 | Androidは、WebViewレンダラープロセスが終了したことを報告しました。メタデータには、レンダラーがクラッシュしたかどうかとレンダラーの優先順位が含まれます。 |
| webviewコンテンツプロセス終了 | iOSは、WebViewコンテンツプロセスが終了したことを報告しました。メタデータには、利用可能な場合のアクティブバンドルとページURLが含まれます。 |
| 暗号化失敗 | ダウンロードしたバンドルの暗号化に失敗しました。 |
| 現在のチャネルをデバイスで取得しました。 (getChannel) | 現在のデバイスのチャネルを取得しました。 |
| 現在のチャネルをデバイスに設定しました。 (setChannel) | デバイスにチャネルが正常に設定されました。 |
| uninstall | アプリケーションがアンインストールされましたまたはCapgoデータがクリアされました。 |
| blocked_by_server_url | Server.urlがあなたのcapacitor設定に含まれています。これによりCapacitorはリモートURLをサーバーから取得し、ローカルファイルを無視します。ただし、アップデートツールはローカルファイルを使用するように設計されています。Server.urlは、Capacitor製作者によって生産環境で使用されることを推奨されていません。これは、多くの問題やプラグインの正しくない動作につながる可能性があります。 |
Bundle status
「Bundle status」のセクションSUCCESS: install bundle doneERROR: install or download failedPENDING: Download done, pending releaseDELETED: Bundle deleted, still presented for statsDOWNLOADING: 現在バンドルをダウンロード中
デバイスログの理解:
セクション「デバイスログの理解:」デバッグコマンド:
セクション「デバッグコマンド:」CloudflareのCapgoユーザー向けにデバッグコマンドがあります。
npx @capgo/cli@latest app debugアプリのすべてのイベントを確認し、更新が行われていない場合の解決策を見つけることができます。
IOS
セクション「IOS」Xcodeでログを検索するには
Android：
セクション「Android：」Android Studioでログを探す
ログの説明
セクション「ログの説明」Failed to download from=> 同じ ダウンロード失敗notifyAppReady was not called, roll back current bundleダウンロード失敗 => 同じ 更新失敗
デバイスにダウンロードしたパッケージを探す
Section titled “__CAPGO_KEEP_0__をダウンロードしたバンドルをデバイスで見つける”iOSでデバッグするには、コンピューター上でアプリをダンプする必要があります。次のようにして実行できます。
Xcodeには、iOSデバイス上の開発者がインストールしたアプリのファイルシステムを検査するための組み込み機能があります。
このように実行するには:
- Macにデバイスを接続し、XcodeのメニューバーのWindow > Devicesを選択します。
- デバイスを左側のペインのDevicesセクションで選択します。
- このデバイスの開発者がインストールしたアプリの一覧が表示されます。
- 表示したいアプリを選択し、画面の下部の3つのドットのアイコンを選択します。
- ここで、現在のファイルシステムをダウンロードしたスナップショットで表示できます。
「ダウンロードコンテナ…」を選択すると、ファイルシステムのスナップショットを.xcappdata形式でダウンロードし、ブラウズできます。
このファイルに右クリックし、「ショー・パッケージ・コンテンツ」を選択してフォルダを開きます。
アプリデータフォルダを開くと、ドキュメント、ライブラリ、tmpなどのいくつかのフォルダが見つかります。
次に、2つのフォルダにバージョンが見つかります:
library/NoCloud/ionic_built_snapshots アプリ再起動後は必要
ホットリロードのために必要 documents/versions Android
「Android」セクション
「Android」Androidデバイスでデバッグするには、Android Studioからデバイスにアクセスする必要があります:
- 「デバイスファイルエクスプローラー」を開くには、「ビュー」メニューから「ツール ウィンドウ」メニューの「デバイス ファイル エクスプローラー」またはツール ウィンドウ バーの「デバイス ファイル エクスプローラー」ボタンをクリックしてください。
- デバイスのドロップダウンリストからデバイスを選択してください。
- パスを開いてください data/data/APP_NAME/ で APP_NAMEはアプリのIDです。
次に、 versions バージョンのすべてを表示するフォルダを見つけてください
iOSの生産時クラッシュログを理解する
「iOSの生産時クラッシュログを理解する」のセクションデバッグから続ける
セクション「デバッグから続ける」あなたが「 デバッグ 」を使用している場合、ネイティブ プラグインの作業を計画するには、 「@capgo/capacitor-updater」 for the native capability in Using @capgo/capacitor-updater, 「@Capgo/__CAPGO_KEEP_1__-updater」で使用するネイティブ機能の場合、 製品ワークフローについての Capgo プラグインディレクトリ Capacitor プラグインは Capgo によって提供されます 実装詳細についての Capacitor プラグインは Capgo によって提供されます プラグインの追加または更新 実装詳細についてのプラグインの追加または更新 Ionic Enterprise プラグインの代替 製品ワークフローについての Ionic Enterprise プラグインの代替