コンテンツへスキップ
Capgo

デバッグ

クラウドログの理解：

Section titled “クラウドログの理解：”

バックエンドから送信

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

デバイスから送信

Section titled “デバイスから送信”
コード説明
get新バージョンのダウンロード情報がデバイスに送信されました
deleteデバイス上で1つのバンドルが削除されました
setバンドルがデバイスにセットされました
set_failバンドルのセットに失敗しました
resetデバイスがbuiltinバンドルにリセットされました
download_XX新しいバンドルがダウンロードされました - XXは進捗率を示します（10%単位）
download_complete新しいバンドルのダウンロードが完了しました
download_fail新しいバンドルのダウンロードに失敗しました
update_fail新しいバンドルはインストールされましたが、notifyAppReadyの呼び出しに失敗しました
checksum_fail新しいバンドルのチェックサム検証に失敗しました。Capgo Cloudを使用していてこのエラーが発生した場合、通常、アプリのバージョンが別のチェックサムタイプを期待していることを意味します。最新バージョンのCLIとプラグイン（バージョン6.25.0または7+）はSHA256チェックサムを使用していますが、古いプラグインはCRC32を使用していました。チェックサムエラーが表示される場合は、チェックサムがSHA256ではなくCRC32（より短いハッシュ）であるかどうかを確認してください。これは通常、古いバージョンのCLIでバンドルがアップロードされたことを示しています。Capgoダッシュボードでバンドルバージョンを確認してください - バージョン6.25.0/7以降に作成されたバンドルはSHA256を使用する必要があります。CRC32チェックサムが表示される場合は、最新のプラグインバージョンがローカルにインストールされていることを確認してください（CLIはローカルのプラグインバージョンをチェックして、どのチェックサムタイプをアップロードするかを決定します）、その後、CLIをアップグレードしてバンドルを再アップロードしてください。
windows_path_failZIPファイルに不正なWindowsパスが含まれています
canonical_path_failファイルパスが正規形式ではありません
directory_path_failZIPファイルのパスにエラーがあります
unzip_fail解凍に失敗しました
low_mem_failデバイスのメモリ不足によりダウンロードに失敗しました

バンドルステータス

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

デバイスログの理解：

Section titled “デバイスログの理解：”

デバッグコマンド：

Section titled “デバッグコマンド：”

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

Terminal window
npx @capgo/cli@latest app debug

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

iOS

Section titled “iOS”

Xcodeでログを見つけるには

Getting the Device Log in Xcode

Android：

Section titled “Android：”

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

View logs with Logcat

ログの説明

Section titled “ログの説明”
  • Failed to download from => download_failと同じ
  • notifyAppReady was not called, roll back current bundle => update_failと同じ

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

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

iOS

Section titled “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

Section titled “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の本番環境でのクラッシュログの理解

Section titled “iOSの本番環境でのクラッシュログの理解”
How to review your app's crash logs