アプリがクラッシュする原因を検出する方法

このドキュメントは、アプリのクラッシュが自分のコードによるものか、Amazonのコードによるものかを判断するのに役立ちます。クラッシュの原因を理解することは、効率的なデバッグを行い、Amazonサポートへの問い合わせ時期を見極めるうえで不可欠です。

前提条件

クラッシュの原因を分析する前に、Vega Studioを使用してアプリのクラッシュをデバッグする方法を参照し、デバイスから集約クラッシュレポート（ACR）ファイルを取得してシンボリケートする方法を確認してください。

スタックトレースとスタックフレーム

スタックトレースはクラッシュに至るまでに発生した一連の関数であり、スタックフレームはスタックトレースを構成する個々の関数呼び出しです。

ネイティブスタックフレーム

ネイティブクラッシュの場合、スタックフレームにはフレーム番号、関数のアドレス、アドレスに対応するライブラリ名が含まれます。

デバッグシンボルが使用可能な場合、フレームには関数名、関数が配置されているファイル、アドレスに対応する関数内の行番号も表示されます。

ネイティブスタックフレームの例：

JavaScriptスタックフレーム

JavaScriptの場合、スタックフレームには関数名、関数が配置されているファイル、行番号が含まれます。

JavaScriptスタックフレームの例：

アプリの種類とスタックトレース

アプリの種類が異なれば、クラッシュ時に生成されるスタックトレースも異なります。作成するアプリの種類を把握しておくと、クラッシュデータを正しく分析するのに役立ちます。

JavaScriptのみのアプリ

JavaScriptのみのアプリでは、次のようなJavaScriptスタックトレースのみが表示されます。

JavaScriptスタックトレースの原因を特定するには：

スタックフレームはアプリのソースファイルを指しており、@amazon-devicesは含まれません。

例：

Amazonスタックフレームのパスには、@amazon-devicesが含まれます。

例：

JavaScript／ネイティブ混在アプリ

JavaScript／ネイティブ混在アプリでは、ネイティブスタックトレースが表示されることがあります。

Vega Studioでは、次の2種類のスタックトレースのいずれかが表示されます。

• JavaScriptスタックトレース（ACRファイルに存在する場合）

• ネイティブスタックトレース（JavaScriptトレースが存在しない場合）

Vega Studioの自動シンボリケーターは、ACRファイルにJavaScriptトレースが存在する場合、JavaScriptトレースを優先して表示します。

ネイティブスタックトレースの例：

ネイティブスタックトレースの原因を特定するには：

スタックフレームには開発者のworkspaceディレクトリが含まれ、シンボルパスが表示されます。

例：

Amazonスタックフレームにはworkspaceディレクトリの参照はなく、システムパスが表示されます。

例：

Amazonサポートへの問い合わせ

次のいずれかの問題が発生した場合は、Amazonサポートにお問い合わせください。

• JavaScriptのみのアプリにネイティブスタックトレースが表示される
• スタックトレースがコードを参照しない
• JavaScriptスタックトレースで、一番上のフレームがアプリコードを指していない

関連トピック

• Vega Studioを使用してアプリのクラッシュをデバッグする方法
• Vega Studioを使用して1行ずつデバッグを実行する方法
• 開発者メニューのツールを使用してアプリをデバッグする方法

---

Last updated: 2025年9月30日