デバッグ
インストールステップとこのプラグインのフルマークダウンガイドまでの全てのステップを含むセットアップの質問をコピーする。
Understanding cloud logs:
Cloudログの理解：If you get a cloud refusal code and need concrete remediation steps, see Common Update Problems.
Capgo ログは、イベントのメタデータを含むことがあります。ダッシュボードで、アクションフィルタを使用して、下記のスネークケースアクション code をフィルタリングし、メタデータセルをクリックしてフルJSONペイロードをコピーしてください。メタデータは、エラー メッセージ、ソースURL、行、列、プロセス状態、メモリ圧力、またはプラットフォーム固有の理由など、クラッシュとWebViewイベントのコンテキストを含むことがあります。古いログは、括弧内にリストされているレガシーキャメルケースのエイリアスを表示することができます。
Sent from the backend
バックエンドから送信されたもの| code | 説明 |
|---|---|
| invalid_ip (__CAPGO_KEEP_0__) | Googleデータセンターに位置するユーザーは、更新が4時間未満の場合、更新は行われません。この制限は、Googleのボットのデバイスがあなたのアカウントのデバイスとしてカウントされないようにするために設けられています。 |
| __CAPGO_KEEP_1__ (__CAPGO_KEEP_1__以前 __CAPGO_KEEP_1__) | あなたのプランの制限に達したことを示します。デバイスは、プランをアップグレードするか、次の月まで、更新を受け取ることができません。 |
| __CAPGO_KEEP_2__ (__CAPGO_KEEP_2__) | デバイスは最新のバージョンを使用しています。 |
| __CAPGO_KEEP_3__ | セマンティックバージョニング形式に従っていないネイティブバージョンです。 |
| iOSプラットフォームが無効化されています (disablePlatformIos) | このデバイスはiOSプラットフォームですが、チャネル設定で無効化されています。 |
| Androidプラットフォームが無効化されています (disablePlatformAndroid) | このデバイスはAndroidプラットフォームですが、チャネル設定で無効化されています。 |
| 自動更新は互換性ポリシーにより無効化されています。メタデータには (マッチングルールとして) | 、または auto_update nativeモード下での自動更新が無効化されています major, minor, patch, metadatadisable_auto_update_under_native none. |
| disableAutoUpdate (__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を返したりし、代替としてマニフェストが利用できない場合に発生します。 |
| __CAPGO_KEEP_0__ (__CAPGO_KEEP_0__) | デバイスはプライベートチャンネルと自己関連付けしようとしたが、チャンネル設定ではデバイスの自己関連付けを許可していません (allow_device_self_set __CAPGO_KEEP_0__ |
| チャンネル設定が不正です。 (チャンネルはバージョン番号 () | ) で自動更新を無効に設定していますが、バンドルのdisable_auto_update: 'version_number'__CAPGO_KEEP_0__ min_update_version __CAPGO_KEEP_0__ |
| バンドルのフィールドがnullのため、更新を受け入れるべきデバイスを決定できません。 (__CAPGO_KEEP_0__) | バージョン番号メタデータにより、自動更新が無効化されています。チャンネルは、デバイスのバージョンが少なくとも 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), such as 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、 |
| ビルトインバージョンではありません。また、ダウンロード可能なマニフェストエントリが存在しません。 (NoChannelOrOverride) | このアプリとデバイスには、デフォルトのチャネルが設定されていません。チャネルをオーバーライドするものもありません。少なくとも1つは存在する必要があります。アップデートが機能するため。 |
| rate_limited (rateLimited) | このデバイスは、過度のリクエストのため、リクエスト数制限を受けました。 |
| key_id_mismatch (keyMismatch) | デバイスの暗号化公開鍵は、バンドルを暗号化するために使用された公開鍵と一致しません。メタデータには device_key_id, bundle_key_id、 version を含めて、不一致を特定するために使用されます。 |
Sent from the device
デバイスから送信されたもの| code | 説明 |
|---|---|
| ping | 内部テスト用のアクションで、統計システムが正しく動作していることを確認します。 |
| get | 新バージョンのダウンロード情報がデバイスに送信されました。 |
| delete | デバイス上の1つのバンドルが削除されました。 |
| set | デバイス上のバンドルが設定されました。 |
| set_fail | バンドルを設定できませんでした。 |
| reset | __CAPGO_KEEP_0__ builtin bundle |
| __CAPGO_KEEP_0__ | A new bundle has been downloaded - progress indicated by __CAPGO_KEEP_0__% (increments of 10%). |
| download_complete | The new bundle has finished downloading. |
| download_manifest_start | The device started downloading the update manifest. |
| download_manifest_complete | The device finished downloading the update manifest. |
| download_zip_start | __CAPGO_KEEP_0__はデバイスでダウンロードを開始しました。 |
| __CAPGO_KEEP_0__ダウンロードが完了しました。 | __CAPGO_KEEP_0__はデバイスでダウンロードを完了しました。 |
| __CAPGO_KEEP_0__ダウンロードが失敗しました: __CAPGO_KEEP_1__ | __CAPGO_KEEP_0__の1つのエントリがダウンロードに失敗しました; stats payloadは version_name __CAPGO_KEEP_0__の形で version:fileName __CAPGO_KEEP_0__を特定するために使用されます。 |
| __CAPGO_KEEP_0__のチェックサム検証に失敗しました。 | __CAPGO_KEEP_0__のBrotliの展開に失敗しました。 |
| __CAPGO_KEEP_0__の展開に失敗しました。 | __CAPGO_KEEP_0__のダウンロードに失敗しました。 |
| __CAPGO_KEEP_0__のダウンロードに失敗しました。 | 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 以降) では、デバイスの公開鍵がアップロードした bundle に使用した秘密鍵と一致しない場合、暗号化が失敗し、チェックサムエラーが発生します。 checksum_failバンドルを再アップロードするには、まず、__CAPGO_KEEP_4__ をアップグレードし、__CAPGO_KEEP_5__ の公開鍵を確認してください。バンドルを再アップロードすると、バンドルがアップロードされた秘密鍵と一致するかどうかを確認するため、__CAPGO_KEEP_6__ から正しいエラーが返されます。 capacitor.config.json バンドルを再アップロードするには、まず、__CAPGO_KEEP_4__ をアップグレードし、__CAPGO_KEEP_5__ の公開鍵を確認してください。バンドルを再アップロードすると、バンドルがアップロードされた秘密鍵と一致するかどうかを確認するため、__CAPGO_KEEP_6__ から正しいエラーが返されます。 keyMismatch バンドルを再アップロードするには、まず、__CAPGO_KEEP_4__ をアップグレードし、__CAPGO_KEEP_5__ の公開鍵を確認してください。バンドルを再アップロードすると、バンドルがアップロードされた秘密鍵と一致するかどうかを確認するため、__CAPGO_KEEP_6__ から正しいエラーが返されます。 |
| windows_path_fail | Windowsパスが不正です |
| canonical_path_fail | ファイルのパスが正しくありません |
| directory_path_fail | zipファイルのパスにエラーがあります |
| unzip_fail | unzip失敗 |
| 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がアプリを過剰なリソース使用のために殺しました。メタデータにはリソースタイプまたはプラットフォームの理由が含まれます。 |
| app_initialization_failure | アプリ起動フローが正常に実行される前に失敗しました。メタデータには失敗したステップとエラーメッセージが含まれています。 |
| app_memory_warning | iOS がメモリ警告を報告しました。メタデータにはアクティブなバンドルとメモリコンテキストが含まれています。 |
| webview_javascript_error | WebView が未処理の JavaScript エラーを報告しました。メタデータにはメッセージ、ソース URL、行、列、スタックが含まれています。 |
| webview_unhandled_rejection | WebView が未処理の Promise 拒否を報告しました。メタデータには拒否理由、ソース URL、スタックが含まれています。 |
| webview_resource_error | WebView リソースの読み込みが失敗しました。メタデータには URL、ステータス code、リソースタイプ、エラーメッセージが含まれています。 |
| webview_security_policy_violation | WebView がコンテンツ セキュリティ ポリシー違反を報告しました。メタデータにはブロックされた URI、ディレクティブ、ドキュメント URL が含まれています。 |
| webview_不正終了 | アプリは、前のWebViewセッションが正しく終了しなかったことを検出しました。これは、更新後にクラッシュループを特定するのに役立ちます。 |
| webviewレンダラープロセス消滅 | Androidは、WebViewレンダラープロセスが終了したことを報告しました。レンダラーがクラッシュしたかどうか、レンダラーの優先順位など、メタデータが含まれています。 |
| webviewコンテンツプロセス終了 | iOSは、WebViewコンテンツプロセスが終了したことを報告しました。アクティブなバンドルとページURLが利用可能な場合、メタデータにはそれらが含まれています。 |
| 暗号化失敗 | ダウンロードしたバンドルを暗号化できませんでした。 |
| 現在のチャネル (現在のチャネルを取得しました。) | 現在のチャネルを設定しました。 |
| 現在のチャネルを取得しました。 (setChannel) | デバイスにチャネルが正常に設定されました。 |
| uninstall | アプリケーションがアンインストールされましたまたはCapgoデータがクリアされました。 |
| blocked_by_server_url | Server.urlがあなたのcapacitor設定に含まれています。これによりCapacitorはリモートURLをサーバーから取得し、ローカルファイルを無視します。ただし、更新プログラムはローカルファイルを使用するように設計されています。Server.urlは、Capacitor製作者によって生産環境で使用されることを推奨されていません。これにより、多くの問題とプラグインの機能不全が発生します。 |
Bundle status
「Bundle status」のセクションSUCCESS: インストールバンドル完了ERROR: インストールまたはダウンロードに失敗PENDING: ダウンロード完了、リリース待ちDELETED: バンドルが削除されましたが、統計用に表示されますDOWNLOADING: __CAPGO_KEEP_0__ のバンドルをダウンロード中です。
デバイスログの理解:
「デバイスログの理解:」のセクションデバッグコマンド:
「デバッグコマンド:」のセクションCapgo のCloudflareユーザーにはデバッグコマンドがあります。
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 “ダウンロードしたパッケージをデバイスで見つける方法”iOSでデバッグするには、コンピューター上でアプリをダンプする必要があります。次のようにして実行できます。
Xcodeには、iOSデバイス上の開発者がインストールしたアプリのファイルシステムを検査するための組み込み機能があります。
このように実行するには
- Macにデバイスを接続し、XcodeのメニューバーのWindow > Devicesを選択します。
- デバイスを左側のペインのDevicesセクション下で選択します。
- このアクションにより、指定されたデバイス上の開発者がインストールしたアプリのリストが表示されます。
- 表示されたリストから、インスペクトしたいアプリを選択し、画面の下部の3つのドットのアイコンを選択します。
- ここで、現在のファイルシステムをダウンロードしたスナップショットで表示できます。
「ダウンロードコンテナ…」を選択すると、ファイルシステムのスナップショットを.xcappdataファイルとしてダウンロードし、ブラウズできます。
このファイルに右クリックし、Show Package Contentsを選択してフォルダを開きます。
App Dataフォルダを開き、Documents、Library、tmpなどのいくつかのフォルダが見つかります。
次に、2つのフォルダにバージョンが見つかります:
library/NoCloud/ionic_built_snapshots アプリ再起動後は必要
ホットリロードのために documents/versions Android
「Android」
セクションAndroidデバイスでデバッグするには、Android Studioからデバイスにアクセスする必要があります：
- View > Tool Windows > Device File ExplorerまたはツールウィンドウバーのDevice File ExplorerボタンをクリックしてDevice File Explorerを開きます。
- デバイスのドロップダウンリストからデバイスを選択します。
- パスを開きます 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 プラグインの代替