コンテンツへスキップ

デバッグ

クラウドログの理解:

バックエンドから送信

コード説明
InvalidIpユーザーがGoogleデータセンターに位置し、更新が4時間以内の場合。これはGoogleボットのデバイスがアカウントのデバイスとしてカウントされるのを防ぐためです
needPlanUpgrade (以前は needUpgrade)プランの制限に達したことを示し、アップグレードするか次の月まで、デバイスは更新を受信しません
noNewデバイスは利用可能な最新バージョンを持っています
disablePlatformIosデバイスはiOSプラットフォーム上にありますが、チャンネル設定で無効化されています
disablePlatformAndroidデバイスはAndroidプラットフォーム上にありますが、チャンネル設定で無効化されています
disableAutoUpdate”major"
disableAutoUpdateUnderNativeデバイスのバージョン(123)があり、チャンネルにデバイスバージョンより低い更新(122)を送信しようとしていますが、チャンネル設定で無効化されています
disableDevBuildデバイスは開発ビルドですが、チャンネル設定で無効化されています
disableEmulatorデバイスはエミュレーターですが、チャンネル設定で無効化されています

デバイスから送信

コード説明
get新バージョンのダウンロード情報がデバイスに送信されました
deleteデバイス上で1つのバンドルが削除されました
setバンドルがデバイスにセットされました
set_failバンドルのセットに失敗しました
resetデバイスがbuiltinバンドルにリセットされました
download_XX新しいバンドルがダウンロードされました - XXは進捗率を示します(10%単位)
download_complete新しいバンドルのダウンロードが完了しました
download_fail新しいバンドルのダウンロードに失敗しました
update_fail新しいバンドルはインストールされましたが、notifyAppReadyの呼び出しに失敗しました
checksum_fail新しいバンドルのチェックサム検証に失敗しました
windows_path_failZIPファイルに不正なWindowsパスが含まれています
canonical_path_failファイルパスが正規形式ではありません
directory_path_failZIPファイルのパスにエラーがあります
unzip_fail解凍に失敗しました
low_mem_failデバイスのメモリ不足によりダウンロードに失敗しました

バンドルステータス

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

デバイスログの理解:

デバッグコマンド:

Capgoクラウドユーザー向けのデバッグコマンドがあります

Terminal window
npx @capgo/cli@latest app debug

これによりアプリで発生するすべてのイベントを確認し、更新が行われない場合の解決策を見つけることができます

iOS

Xcodeでログを見つけるには

Android:

Android Studioでログを見つけるには

ログの説明

  • Failed to download from => download_failと同じ
  • notifyAppReady was not called, roll back current bundle => update_failと同じ

デバイスでダウンロードされたバンドルを見つける

iOS

iOSでデバッグするには、アプリをコンピュータにダンプする必要があります:

XcodeにはiOSデバイスの開発者インストールアプリのファイルシステムを検査する機能が組み込まれています

手順:

  • デバイスをMacに接続し、Xcodeメニューバーで Window > Devices を選択
  • Devicesセクションの左ペインでデバイスを選択
  • そのデバイスの開発者インストールアプリの一覧が表示されます
  • 検査したいアプリを選択し、画面下部の歯車アイコンを選択
  • Show Containerを選択してファイルシステムを表示するか、スナップショットをダウンロードできます

Download Containerを選択すると、xcappdataファイルとしてファイルシステムのスナップショットがダウンロード・エクスポートされます

このファイルを右クリックしてShow Package Contentsを選択してフォルダを開きます

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

image

バージョンは2つのフォルダにあります:

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

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

Android

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

  • View > Tool Windows > Device File Explorerをクリックするか、ツールウィンドウバーのDevice File ExplorerボタンをクリックしてDevice Explorerを開きます
  • ドロップダウンリストからデバイスを選択します
  • **data/data/APP_NAME/**のパスを開きます。APP_NAMEはアプリのIDです

image

versionsフォルダを探してすべてのバージョンを確認します

iOSの本番環境でのクラッシュログの理解