クラッシュ分析に関する問題の修正

このページでは、Vega Studioで、ACR分析やシンボリケーションのプロセス中に発生する可能性のある一般的な問題の解決策を示します。解決策がここで見つからない場合、開発者フォーラムに問題を投稿すれば追加のサポートを受けることができます。

デバイスの接続の問題が原因で、集約クラッシュレポート（ACR）分析が実行されない

原因： デバイスの接続が不安定だったり、通信が中断されたりすると、クラッシュレポートの収集が行われません。

解決策：

1. デバイスのバッテリー残量が十分にあることを確認します。
2. USBまたはネットワーク経由でデバイスを接続します。

3. デバイスの接続を確認します。

   コードをコピー クリップボードにコピーしました。

   kepler device list
   

4. デバイスを再接続するか、VS Codeを再起動します。

シンボリケーションにより不正確または不完全な結果が生成される

原因： 分析対象のコードのタイプに適していないシンボリケーション方法が選択されています。ネイティブコードとJavaScriptコードが混在している場合は、別のアプローチが必要です。

解決策：

1. 自動シンボリケーションが失敗した場合は、手動シンボリケーションを試します。
2. 混合コードの場合、正しいデコードタイプを選択したことを確認します。
   • ネイティブコードのシンボリケーションにはgdbを使用します
   • JavaScriptコードのシンボリケーションにはjsを使用します
3. アプリタイプに適したシンボリケーションプロファイルを使用していることを確認してください。

シンボリケーション処理は完了したが、結果が欠落しているか、一部しか表示されない

原因： デバッグシンボルが見つからない、ソースマップが古い、またはVega Studio拡張機能のバージョンに互換性がない。

解決策：

1. 必要に応じて、デバッグシンボルフォルダまたはソースマップを追加します。
   • [Vega Studio] > [ACR Analysis] > [Symbol Paths] に移動します
   • デバッグシンボルディレクトリへのパスの追加
   • パスにアクセス可能で、有効なシンボルファイルが含まれていることを確認します
2. Vega Studio拡張機能の最新バージョンを使用していることを確認します。
   • VS Code拡張機能へ移動します
   • Vega Studio拡張機能に新しいバージョンがある場合はアップデートします
   • アップデート後にVS Codeを再起動します
3. デバッグビルド構成を確認します。
   • アプリのビルド時にデバッグシンボルを有効にしたことを確認します
   • ビルドにデバッグ情報が保持されていることを確認します

デバッグシンボルまたはソースマップがないため、シンボリケーションできない

原因： デバッグシンボルまたはソースマップが欠落しているか、正しく配置されていないか、古くなっています。

解決策：

1. ネイティブコードの場合：
   • 正しいdebug rootfsまたはシンボルフォルダがあることを確認します。
   • シンボルファイルがクラッシュしたビルドと完全に一致していることを確認します
   • コンパイル時にデバッグシンボルが取り除かれていないことを確認します
2. JavaScriptの場合：
   • ソースマップが最新で、正しい場所にあることを確認します
   • ソースマップファイルの名前がバンドルファイルと一致することを確認します（例：index.bundle.map）
   • ビルドプロセスでソースマップが生成されたことを確認します
3. 必要に応じてシンボルを再生成する：
   • デバッグシンボルを有効にしてアプリを再ビルドします
   • ビルドによってアクセス可能なソースマップが生成されることを確認します
   • ソースマップのファイルパスが正しいことを確認します

ACRのシンボリケーションが低速である、または停止しているように見える

原因： ACRファイルが大きすぎる、多数のシンボルを含む複雑なプロジェクトである、またはシステムリソースに制約がある。

解決策：

1. ACRファイルが大きい場合：
   • 大きなACRファイルや複雑なプロジェクトでは、シンボリケートに時間がかかる場合があります。
   • 追加の処理時間を許容します
   • シンボリケーション中にシステムリソースをモニタリングします
2. システムリソースを解放する：
   • 不要なVS Codeの拡張機能を閉じます
   • リソースを大量に消費するほかのアプリを閉じます
   • 十分なRAMとディスク容量を確保します
3. 必要に応じてVS Codeを再起動する：
   • シンボリケーションが停止した場合は、VS Codeを再起動します
   • 同時操作を減らしてから、シンボリケーションを再試行します

シンボリケーションがJavaScriptソースマップファイルを使用しない

原因： ソースマップファイルの命名に関する問題、ファイルの場所が誤っている、またはソースマップ形式の問題。

解決策：

1. ソースマップファイルの名前を確認する：
   • ソースマップファイルの名前は正しい形式にします（例：index.bundle.map）
   • ソースマップファイル名がバンドルファイル名と一致していることを確認します
   • ファイル拡張子が正しいことを確認します
2. ソースマップの場所を確認する：
   • ソースマップが正しいプロジェクトフォルダにあることを確認します。
   • ソースマップがバンドルファイルと同じディレクトリにあることを確認します
   • Vega Studioからファイルパスにアクセスできることを確認します
3. ソースマップ形式を確認する：
   • ビルドでソースマップが正しく生成されたことを確認します
   • ソースマップに有効なマッピング情報が含まれていることを確認します
   • ソースマップをほかのデバッグツールでテストして有効性を確認します

システムがACRファイルをロードまたは解析できない

原因： ACRファイルが破損している、ACRフォーマットがサポートされていない、またはファイルへのアクセス権の問題。

解決策：

1. ACRファイルの整合性を確認する：
   • ACRファイルが破損していないことを確認します
   • ACRファイルをテキストエディターで開いて内容を確認します
   • ファイルが完全にダウンロードまたは転送されたことを確認します
2. ファイルへのアクセス権を確認する：
   • ACRファイルへの読み取り権限があることを確認します
   • ほかのプロセスがファイルをロックしていないことを確認します
   • ACRファイルを別の場所にコピーします
3. ACRフォーマットを検証する：
   • ACRファイルがサポート対象の形式であることを確認します
   • ACRが互換性のあるVega SDKバージョンで生成されたことを確認します
   • 別のACRファイルを使用して問題を特定します

関連トピック

• Vega Studioを使用してアプリのクラッシュをデバッグする方法

---

Last updated: 2025年11月14日