デバッグ

クラウドログの理解

codeのクラウド拒否が発生し、より深い対処方法のウォークスルーが必要な場合は、「 一般的なアップデート問題.

Capgoログにはイベントのメタデータが含まれています。ダッシュボードで、codeのスネークケースアクションでフィルタリングし、メタデータセルをクリックしてフルJSONペイロードをコピーしてください。メタデータは、クラッシュやWebViewイベントの場合に特に役立ちます。エラー メッセージ、ソースURL、行番号、列番号、プロセス状態、メモリ圧力、またはプラットフォーム固有の理由が含まれる可能性があります。古いログは、カメルケースのエイリアスを括弧内にリストしたままにできます。

各セクションのタイトルはコンソールログテーブルのアクションcodeと一致するので、直接リンクできます。

プランの制限と通常の応答

請求拒否の理由は請求、スロットリング、またはエラー以外の状態です。

InvalidIp

これは何を意味しますか?

CapgoはGoogleまたはクラウドインフラストラクチャからのトラフィックが見えているようです。4時間以内にアップデートされたものは無視されます。そうすると、BOTトラフィックが請求可能なデバイスとしてカウントされないようになります。

何をしますか?

実際のユーザーには無視してください。正常なネットワークと実際のデバイスからリトライしてください、または後で再度確認してください。

provider_infrastructure_request_blocked

これは何を意味しますか?

あなたのアプリは、GoogleとAppleのデータセンターIP範囲からのリクエストをブロックするように設定されています。保護はアップデートチェック、統計、チャネル自体のリクエストに適用されます。そうすると、クラウドホストされたプローブやプロバイダーランナーの場合、有効なアプリ設定にもかかわらずこの応答を受け取ることができます。

何をしますか?

物理デバイスから正常なユーザーネットワークからリトライしてください。プロバイダーオリジナルのトラフィックが意図的である場合、暂時的に「プロバイダインフラストラクチャリクエストのブロック」を無効にしてください 「プロバイダインフラストラクチャリクエストのブロック」を無効にします アプリ内で 情報 タブに移動し、テスト後に再度有効にする。新規のアプリではこの設定がデフォルトで有効になっており、既存のアプリでは以前の設定が維持されるまで変更されない。

needPlanUpgrade

これは何を意味するか

組織がプランまたはデバイスの制限に達したため、デバイスはアップデートを受信できなくなる。アップグレードまたは利用回数のリセットが行われる次の請求サイクルまで待つ必要がある。

何をするか

ダッシュボードでプランをアップグレードするか、次の請求サイクルまで待つ。

noNew

これは何を意味するか

デバイスが最新のバンドルを取得できるチャンネルで、最新のバンドルがすでに存在している。正常な状態であり、エラーではない。

rateLimited

これは何を意味しますか

デバイスは短い期間内に多数のアップデートまたはチャンネル要求を送信したため、リクエストが拒否されました。

何をするべきですか

レンダリングループ内でアップデートAPIを呼び続けるのをやめましょう。ユーザーアクションからのみ呼び出し、 setChannel / getChannel のみで、 defaultChannel バージョン形式 capacitor.config.

セクション「バージョン形式」

セクション「semver_error」

semver_error

config内のネイティブアプリバージョンが存在しない、または有効なsemverではありません。

バージョン形式x.y.z).

iOS用のアップデートを無効にする

設定 plugins.CapacitorUpdater.version 有効なsemverに設定し、SemVerテスターで検証し、再構築し、ネイティブアプリを再インストールする SemVerテスタープラットフォームとビルドのターゲット設定

セクション「プラットフォームとビルドのターゲット設定」

セクション「disablePlatformIos」

disablePlatformIos

このチャンネルではiOSのアップデートがiOSを実行しているデバイスに適用されない

対処方法

Platform and build targeting

iOSの有効化をチャンネルに追加するか、iOSビルドをブロックする場合に専用のチャンネルにルーティングする。

disablePlatformAndroid

これは何を意味する?

このチャンネルではAndroidの更新が無効化されているため、デバイスはAndroidを実行しています。

何をする?

このチャンネルではAndroidの更新が無効化されているため、デバイスはAndroidを実行しています。iOSの有効化をチャンネルに追加するか、iOSビルドをブロックする場合に専用のチャンネルにルーティングする。

disablePlatformElectron

これは何を意味する?

このチャンネルではElectronの更新が無効化されているため、デバイスはElectronを実行しています。

何をする?

このチャンネルではElectronの更新が無効化されているため、デバイスはElectronを実行しています。Electronの有効化をチャンネルに追加するか、Electronビルドをブロックする場合に専用のチャンネルにルーティングする。

disableDevBuild

これは何を意味しますか

このチャンネルでは開発版がブロックされていますが、デバイスは開発版です。

何をするべきですか

テストチャンネルで開発版を許可するか、またはこのチャンネルはリリース専用にし、開発用デバイスを別のチャンネルに移動するか

disableProdBuild

これは何を意味しますか

リリースされたビルド /updates, ですが、このチャンネルではプロダクションアップデートがブロックされています。

何をするべきですか

このことが間違いだった場合に、このチャンネルでプロダクションアップデートを許可するか、またはプロダクションビルドを正しいチャンネルにルーティングするか

disableDevice

これは何を意味しますか

A real phone or tablet was blocked because this channel blocks real devices.

対処する方法

この場合、実機の更新を有効にしてください。誤ってブロックした場合は、ブロックを維持し、実機を別のチャネルにルーティングすることもできます。

disableEmulator

意味

このチャネルでは、エミュレータの更新が無効になっています。

対処する方法

エミュレータの更新をテストチャネルで有効にしてください。エミュレータの検証用に別のチャネルを使用することもできます。

自動更新の互換性のルール

バックエンドの拒否

disableAutoUpdate

Auto-updateはチャンネル互換性ポリシーにより無効になっています。

メタデータには auto_update 、または major, minor, patch, metadata何をするか none.

チャンネル間の自動更新ポリシーを変更して、実際のロールアウトを許可するようにしてください。

セクション「disableAutoUpdateUnderNative」

disableAutoUpdateUnderNative

何をするか

Native基準以上のバンドルを公開するか、チャンネルでNative保護を無効にするか

セクション「disableAutoUpdateMetadata」

Auto-updateはチャンネル互換性ポリシーにより無効になっています。

disableAutoUpdateMetadata

これは何を意味しますか

このチャンネルは min_update_versionですが、デバイスのネイティブバージョンはその閾値以下です。

何をするべきですか

を設定します min_update_version ターゲットのバンドルまたはリリースから、より新しいネイティブバージョンを選択します。

disableAutoUpdateToMajor

これは何を意味しますか

このチャンネルはメジャーバージョンジャンプをブロックします、たとえば 1.x.x に 2.x.x.

何をするべきですか

チャンネル戦略をメジャーロールアウト計画と整合させます、またはこのトラックでメジャージャンプを許可します。詳細は 一般的なアップデートの問題.

disableAutoUpdateToMinor

その意味

チャンネルは、デバイスのネイティブベースラインからのマイナーバージョンジャンプをブロックします (version_build）、たとえば 1.2.3 を 1.3.0.

何をするか

チャンネル戦略をマイナーロールアウト計画と合わせるか、このトラックでマイナージャンプを許可するか

disableAutoUpdateToPatch

その意味

チャンネルは、同じプレフィックスを維持しながらパッチレベル変更をブロックします; ただし、サフィックス変更のみが許可されます MAJOR.MINOR.PATCH prefix; only suffix changes are allowed.

何をするか

リリースのペースをチャンネルポリシーと合わせたり、このトラックにパッチジャンプを許可したりする。

チャンネル設定

チャンネル設定が不十分または不互換の場合に発生するバックエンドの拒否。

cannotUpdateViaPrivateChannel

これは何を意味するか

デバイスは、デバイスの自己割り当てを許可していない (allow_device_self_set false) であるため、プライベートチャンネルと自己割り当てを試みました。

何をするか

チャンネルに有効にする allow_device_self_set チャンネルに有効にする

channelMisconfigured

これは何を意味するか

チャンネルは disable_auto_update: "version_number" しかし、バンドル min_update_version はnullなので、Capgoはどのデバイスがアップデートするかを決定できません。

何をするか

そのルールの欠落した設定を埋め合わせるか、シンプルな自動アップデートモードに切り替えるか。

NoChannelOrOverride

これは何を意味するか

デフォルトのチャンネルが設定されていません。デバイスにはチャンネルオーバーライドもありません。

何をするか

ダッシュボードでデフォルトのチャンネルを設定するか、 defaultChannel ビルド中。

バンドル配信と暗号化

Capgo がバンドルを提供または暗号化できなかった場合のバックエンド拒否

cannotGetBundle

これは何を意味しますか?

Capgo が有効な署名付きダウンロード URL を生成できず、メニューのフォールバックが利用できなかった場合

何をするべきですか?

バンドルを再アップロードし、メニューを再生成し、R2 またはパブリック バンドル設定を確認してください。

missingBundle

これは何を意味しますか?

チャンネルに割り当てられたバンドルにはダウンロード可能なコンテンツが存在しません: external_url、ない r2_path、組み込まれていないバージョン、そしてメタデータエントリもない

何をするか

バージョンを再構築し、再アップロードし、バンドルが実際のファイルコンテンツを持つことを確認する

keyMismatch

何を意味するか

デバイスの暗号化パブリックキーが、バンドルを暗号化するために使用されたキーと一致しない device_key_id, bundle_key_idメタデータには version.

、そして

Compare device and bundle key IDs in the console. Publish with the same key and matching CLI/plugin versions.

コンソールでデバイスとバンドルのキーIDを比較する。同じキーと一致する__CAPGO_KEEP_0__/プラグインバージョンで公開する

バックエンドの拒否は、アプリの設定または非対応のアップデートバージョンによって引き起こされます。

customIdBlocked

これは何を意味しますか?

アプリはカスタムデバイスIDを送信しましたが、このアプリはカスタムIDを受け付けないため、IDは無視されます。

何をするべきですか?

カスタムIDを送信しない、またはカスタムIDを有効にする必要があるワークフローがある場合にのみ有効にすること。

blocked_by_server_url

これは何を意味しますか?

server.url Capacitor の設定により、WebView はローカル バンドル ファイルを読み込むのではなく、リモート URL を読み込むようになります。 Capgo のライブ アップデートはローカル ファイルが必要であり、 server.url 生産環境では推奨されていません。

何をするべきですか?

削除またはクリアする server.url 生産用ビルドとアップデートのペイロードをローカルに保持する。 このcode はバックエンドからの拒否またはデバイス側のステータスとして表示されることがあります。

backend_refusal

これは何を意味するか

アップデート プラグインはバージョン 4 です。バックエンドはこれを認識しません。

何をするか

プラグインとCLI をバージョン 5 以降 (バージョン 8 を推奨) にアップグレードし、Capacitor バージョン 5 以降に、再構築し、再公開するバンドル メタデータ。

アップデート ライフサイクル

正常なアップデート フロー、有効化、ロールバック用のデバイス側イベント

ping

これは何を意味するか

内部テスト アクションで統計パイプラインを検証するために使用されます。

get

Section titled “get”

Capgo sent download information for a new version to the device.

set

Section titled “set”

Section titled “set_fail”

set_fail

What to do

Check native logs with

and verify bundle integrity, paths, and

__CAPGO_KEEP_0__ sent download information for a new version to the device. npx @capgo/cli@latest app debug A bundle was activated on the device. notifyAppReady フロー。

reset

意味

デバイスは組み込みのバンドルにリセットされました。

delete

意味

デバイス上の1つのバンドルが削除されました。

ダウンロードとインストールの失敗

ダウンロードの進行状況、アーカイブの検証、インストールのエラーに関するデバイス側のイベント。

download_0

意味

ダウンロードシーケンスは0%の進行度で開始されました。

download_10

これは何を意味しますか?

新しいバンドルがダウンロードされました — 進行度は10%です。

download_20

これは何を意味しますか?

新しいバンドルがダウンロードされました — 進行度は20%です。

download_30

これは何を意味しますか?

新しいバンドルがダウンロードされました — 進行度は30%です。

download_40

これは何を意味しますか?

新しいバンドルがダウンロードされました — 進捗状況は40%で示されています。

download_50

これは何を意味しますか

新しいバンドルがダウンロードされました — 進捗状況は50%で示されています。

download_60

これは何を意味しますか

新しいバンドルがダウンロードされました — 進捗状況は60%で示されています。

download_70

これは何を意味しますか

新しいバンドルがダウンロードされました — 進捗状況は70%で示されています。

download_80

これは何を意味しますか

新しいバンドルがダウンロードされました — 進行状況は80%で示されています。

download_90

これは何を意味しますか

新しいバンドルがダウンロードされました — 進行状況は90%で示されています。

download_complete

これは何を意味しますか

バンドルダウンロードは正常に完了しました。

download_manifest_start

これは何を意味しますか

デバイスはアップデートマニフェストのダウンロードを開始しました。

download_manifest_complete

これは何を意味しますか

デバイスは更新マニフェストのダウンロードを完了しました。

download_zip_start

これは何を意味しますか?

デバイスはバンドル アーカイブのダウンロードを開始しました。

download_zip_complete

これは何を意味しますか?

デバイスはバンドル アーカイブのダウンロードを完了しました。

download_manifest_file_fail

これは何を意味しますか?

1 つのマニフェスト エントリがダウンロードに失敗しました。 version_name 使用する version:fileName アセットを識別する

何をするか

アセットが欠落しているかブロックされている場合は修正し、再度マニフェストを生成し、バンドルをアップロードしてください。

download_manifest_checksum_fail

これは何を意味するか

マニフェストファイルのチェックサム検証に失敗した

何をするか

最新のCLIバージョンのバンドルを再度アップロードし、マニフェストのチェックサムを検証してください。

download_manifest_brotli_fail

これは何を意味するか

マニフェストファイルのブロリ解凍に失敗した

何をするか

圧縮設定を確認し、影響を受けたアセットを再度アップロードしてください。

download_fail

意味

バンドルダウンロードに失敗しました。

対処

ネットワーク接続、署名URLの有効期限、CDNのアクセス可能性、デバイスのストレージを確認してください。

update_fail

意味

バンドルがインストールされたが、アプリが呼び出さなかったため、__CAPGO_KEEP_0__がロールバックされました。 notifyAppReady, so Capgo rolled back.

アプリが起動後に呼び出してください。

アプリが起動後に呼び出してください。 notifyAppReady() ロギング notifyAppReady was not called, roll back current bundle codeにマップされる

checksum_fail

これは何を意味しますか

ダウンロードしたバンドルがチェックサム検証に失敗しました。一般的な原因：古いCLIのアップロードからCRC32とSHA256の不一致、または古いプラグインで暗号化失敗をチェックサム失敗として表現する暗号化キー不一致

何をするべきですか

最新のCLI/プラグイン (SHA256) で再アップロードしてください。暗号化を使用している場合、アップロードキーとアプリパブリックキーが一致していることを確認し、またはプラグイン 8.3.0+ にアップグレードして明示的な keyMismatch エラーを表示する

decrypt_fail

これは何を意味しますか

ダウンロードしたバンドルが暗号化に失敗しました

何をするべきですか

暗号化キーを確認し、暗号化キーが一致するもので再アップロードしてください

windows_path_fail

これは何を意味しますか

zip ファイルには不正な Windows スタイルのパスが含まれています。

何をしますか

Unix パスでバンドルを再構築するか、またはアップロードする前にアーカイブ パスの正規化を行ってください。

canonical_path_fail

これは何を意味しますか

zip ファイル内のファイル パスが canonical ではありません。

何をしますか

アップロードする前にアーカイブ パス生成を修正してください。

directory_path_fail

これは何を意味しますか

zipファイルには無効なディレクトリパスが含まれています。

どうすればいいか

アップロードする前にアーカイブ構造を修正してください。

unzip_fail

これは何を意味するか

デバイスはダウンロードしたバンドルを展開できませんでした。

どうすればいいか

アーカイブの整合性とサポートされている圧縮形式を確認してください。

low_mem_fail

これは何を意味するか

ダウンロードが失敗したのは、デバイスがメモリが足りないためです。

どうすればいいか

バンドルサイズを削減するか、より多くのフリーメモリを持つデバイスで再試行する。

アプリの健康とWebViewイベント

デバイス側のクラッシュ、メモリ、WebView診断。常にダッシュボードでメタデータJSONを検査する。

app_moved_to_background

これは何を意味しますか

アプリがフォアグラウンドに移動しました

app_moved_to_foreground

アプリがクラッシュしました

これは何を意味しますか

app_crash

__CAPGO_KEEP_0__

JavaScript または Capacitor層のクラッシュ。メタデータにはメッセージ、スタック、ソース、そしてアクティブなバンドルコンテキストが含まれます。

何をするか

メタデータとネイティブログを検査する。JSとネイティブエラー報告をペアする(例えばSentry)で、失敗する code パスを特定する。

app_crash_native

何を意味するか

ネイティブプラットフォームのクラッシュ。メタデータにはプラットフォーム、理由、スタック、プロセス詳細が含まれます。

何をするか

XcodeまたはLogcatクラッシュログを使用し、メタデータのアクティブなバンドルと照合する。

app_anr

何を意味するか

Androidアプリケーションが応答しないイベント。

何をするか

アップデート後、メインスレッドのブロッキングワークを減らし、LogcatでANRトレースを検査する。

app_killed_low_memory

これは何を意味するか

メモリ圧力のため、OSはアプリを殺した。

何をするか

アップデートアクティベーション後、メモリ使用量を減らし、利用可能なメモリシグナルを検査するメタデータを検査する。

app_killed_excessive_resource_usage

これは何を意味するか

OSはアプリを、過剰なリソース使用のため殺した。

何をするか

リソースのタイプまたはプラットフォームの理由のメタデータを検査する。

app_initialization_failure

アップデータの意味

正常な実行が可能になる前にアップデータまたは起動が失敗しました。

何をするか

失敗したステップとエラーメッセージを含むメタデータを検査してください。

app_memory_warning

アップデータの意味

iOS メモリの警告です。

何をするか

メタデータのメモリコンテキストを検査し、更新後はピーク使用率を削減してください。

webview_javascript_error

アップデータの意味

WebView での未処理の JavaScript エラーです。メタデータにはメッセージ、ソース URL、行、列、スタックが含まれます。

何をするか

JSとネイティブレイヤーでエラー報告をインストールして、実行中のプロダクションで正確に失敗する行をキャプチャする。

webview_unhandled_rejection

何を意味するか

WebView内で未処理のプロミス拒否が発生した。

何をするか

JSとネイティブエラー報告で非同期失敗をキャプチャする。

webview_resource_error

何を意味するか

WebViewのリソースがロードに失敗した。

何をするか

メタデータURLとステータス詳細を使用して、破損したアセットまたはネットワークルールを修正する。

webview_security_policy_violation

これは何を意味しますか

コンテンツ セキュリティ ポリシーはリソースをブロックしました。

何をするべきですか

メタデータディレクティブとブロックされたURIの詳細を使用してCSPを調整してください。

webview_unclean_restart

これは何を意味しますか

前のウェブビュー セッションは正常に終了していませんでした。これはアップデート後にクラッシュループを示すことがあります。

何をするべきですか

クラッシュとウェブビュー エラー イベントの前後で関連付けます。

webview_render_process_gone

これは何を意味しますか

Android WebView レンダラー プロセスが終了しました。

何をするか

メタデータとネイティブログにレンダラークラッシュシグナルを検査する。

webview_content_process_terminated

何を意味するか

iOS WebView コンテンツプロセスが終了しました。

何をするか

メタデータからアクティブなバンドルとページURLを検査する。

環境とチャンネルコンテキスト

デバイス側のコンテキストイベントがOS、ネイティブバージョン、またはチャンネル変更とアップデート動作を関連付けるのに役立ちます。

os_version_changed

Capgoの意味

デバイスのOSバージョンがチェック間で変更された。

native_app_version_changed

Capgoの意味

ネイティブアプリのストアバージョンが変更され、ネイティブとウェブのバンドル変更を分離するのに役立ちます。

getChannel

Capgoの意味

デバイスが現在のチャンネルを確認した。

setChannel

Capgoの意味

デバイスにチャンネルが正常に設定された。

uninstall

What it means

アプリがアンインストールされたか、またはCapgoデータが削除された。

Bundle status

• SUCCESS: bundleのインストール完了
• ERROR: bundleのインストールまたはダウンロードに失敗
• PENDING: bundleのダウンロード完了、リリース待ち
• DELETED: bundleが削除されたが、統計用に表示される
• DOWNLOADING: bundleのダウンロード中

デバイスログの理解

Debug command

Capgo のクラウドユーザーにはデバッグコマンドが用意されています。

npx @capgo/cli@latest app debug

アプリ内で発生するすべてのイベントを確認し、更新が正常に実行されない場合は解決策を探すことができます。

iOSネイティブログ

Xcodeでログを確認する方法

Xcodeでデバイスログを取得する

Androidネイティブログ

Android Studioでログを確認する方法

ログをLogcatで表示

ネイティブログのフレーズマッピング

• Failed to download from にマップされる download_fail
• notifyAppReady was not called, roll back current bundle にマップされる update_fail

デバイス上でダウンロードしたバンドルを探す

iOS

Xcodeには、iOSデバイス上で開発者がインストールしたアプリのファイルシステムを検査するための組み込み機能があります。

デバイスとシミュレータのオプションが表示されているXcodeのウィンドウメニュー

このように実現するには:

• Macに接続したデバイスを選択し、Xcodeのメニューバーの「Window > Devices」を選択します。
• 左側のペインの「Devices」セクションの下でデバイスを選択します。
• このデバイスにインストールされている開発者用アプリのリストが表示されます。
• インスペクトしたいアプリを選択し、画面の下部の「3点」アイコンを選択します。
• ここで、ファイルシステムの現在の状態を確認することができます。ファイルシステムのスナップショットをダウンロードすることもできます。

「Download Container…」を選択すると、ファイルシステムのスナップショットがダウンロードされ、.xcappdata ファイルとしてエクスポートされます。このファイルを閲覧できます。

App Data フォルダを開くと、Documents、Library、tmp などのいくつかのフォルダが表示されます。

iOS アプリ コンテナ フォルダ構造が表示され、Documents と Library フォルダが表示されます。

次に、2 つのフォルダ内にバージョンを見つけることができます:

library/NoCloud/ionic_built_snapshots アプリ再起動後は必要です

そして documents/versions ホットリロード用

Android

Android でデバッグするには、Android Studio からデバイスにアクセスする必要があります:

• デバイス ファイル エクスプローラーを開くには、次の手順を実行してください。
• デバイスのドロップダウン リストからデバイスを選択してください。
• パスを開く data/data/APP_NAME/ ここ APP_NAMEはあなたのアプリIDです。

次に、 versions フォルダを見つけてみてください

知っておいてほしいこと

Androidでは、すべてのバージョンは1つのフォルダに保存されます。iOSでは、2つの場所に複製する必要があります。

iOSの生産環境でのクラッシュログを理解する

アプリのクラッシュログを確認する方法

デバッグから続けてみてください

Capgoを使用している場合 デバッグ ネイティブ プラグインの作業を計画するには、Capgoを接続します。 Using @capgo/capacitor-updater for the native capability in Using @capgo/capacitor-updater, Capgo Plugin Directory for the product workflow in Capgo Plugin Directory, Capacitor Plugins by Capgo for the implementation detail in Capacitor Plugins by Capgo, プラグインの追加または更新 プラグインの追加または更新の実装詳細 Ionic Enterprise プラグインの代替 Ionic Enterprise プラグイン代替品の製品ワークフローについて。