Java/Kotlin の割り当てを記録する

Java / Kotlin の割り当てを記録すると、パフォーマンス上の問題を引き起こす可能性がある、望ましくないメモリパターンを特定できます。プロファイラは、オブジェクト割り当てに関して次の内容を表示できます。

  • 割り当てられたオブジェクトの種類とオブジェクトのメモリ使用量。
  • 各割り当てのスタック トレースと含まれているスレッド。
  • オブジェクトの割り当てが解除されたとき。

ユーザーによる通常の操作と極端な操作の際のメモリ割り当てを記録して、コードが短時間にオブジェクトを割り当てすぎている領域、またはメモリリークが発生するオブジェクトを割り当てている領域を正確に特定する。アプリのメモリをプロファイリングする理由

Java / Kotlin の割り当てを記録する方法

Java / Kotlin の割り当てを記録するには、プロファイラの [Home] タブから [Track Memory Consumption (Java/Kotlin Allocations)] タスクを選択します。Java / Kotlin の割り当てを記録するには、デバッグ可能なアプリ(Profiler: run 'app' as debuggable (complete data) を使用)が必要です。

Android Studio Profiler の割り当てトラッキングの記録コントロール
Android Studio Profiler の割り当てトラッキング記録コントロール。

Android Studio は、デフォルトですべてのオブジェクト割り当てをメモリにキャプチャします。多数のオブジェクトを割り当てるアプリの場合は、プロファイリング中にアプリが目に見えて遅くなることがあります。プロファイリング中のパフォーマンスを改善するには、[Allocation Tracking] プルダウンに移動し、[Full] ではなく [Sampled] を選択します。サンプリング時に、プロファイラはメモリ内のオブジェクト割り当てを定期的に収集します。

記録中にガベージ コレクション イベントを強制実行するには、ゴミ箱アイコン をクリックします。

Java / Kotlin 割り当ての概要

録画を停止すると、次のようになります。

解析された Java / Kotlin 割り当て記録の概要
解析された Java と Kotlin の割り当て記録の概要。
  • イベント タイムラインには、アクティビティの状態、ユーザー入力イベント、画面の回転イベントが表示されます。
  • メモリ使用量のタイムラインには、次の情報が表示されます。タイムラインの一部を選択して、特定の期間にフィルタします。
    • 各メモリカテゴリで使用されているメモリ使用量の積み上げ棒グラフ。左の Y 軸はメモリ使用量を、上部の色キーはメモリカテゴリを示しています。
    • 割り当てられたオブジェクトの数を表す破線。右の Y 軸はオブジェクトの数を示しています。
    • 各ガベージ コレクション イベントのアイコン。
  • [Table] タブには、クラスのリストが表示されます。[Total Count] は、選択した期間の終了時点での割り当て数([Allocations] から [Deallocations] を引いた値)です。そのため、[Total Count] の値が最も高いクラスを最初にデバッグするのが合理的です。選択した期間中のピーク時の割り当てに基づいてクラスのトラブルシューティングを行う場合は、[割り当て] で優先度を設定します。同様に、[Remaining Size] は、[Allocations Size] から [Deallocations Size] を引いた値(バイト単位)です。
  • [Table] リストでクラスをクリックすると、[Instance] ペインが開き、関連するオブジェクトのリストが表示されます。このリストには、オブジェクトが割り当てられた日時、割り当てが解除された日時、シャローサイズが含まれます。
  • [可視化] タブには、選択した期間中のコールスタック内のすべてのオブジェクトの集計ビューが表示されます。基本的には、表示されているインスタンスを含むコールスタックが使用するメモリの合計量が表示されます。最初の行にはスレッド名が表示されます。デフォルトでは、オブジェクトは割り当てサイズに基づいて左から右に積み上げられます。プルダウンを使用して順序を変更します。

    集計された割り当てコールスタックを示す [Visualization] タブ

  • ヒープのプルダウンを使用して、特定のヒープにフィルタします。ヒープダンプのキャプチャ時に使用可能なフィルタに加えて、JNI ヒープ(Java Native Interface(JNI)参照の割り当てと開放が行われる場所を示すヒープ)内のクラスをフィルタできます。

  • [配置] プルダウンを使用して、割り当ての配置方法を選択します。ヒープダンプをキャプチャするときに使用できる配置に加えて、コールスタックで並べ替えることもできます。

メモリをカウントする方法

上部に表示される数値は、Android システムに応じて、アプリがコミットしたすべてのプライベート メモリ ページに基づいています。このカウントには、システムまたは他のアプリで共有されるページは含まれません。メモリカウントのカテゴリは次のとおりです。

メモリ割り当てカテゴリのカラーキーの凡例
メモリ割り当てカテゴリのカラーキーの凡例。
  • Java: Java または Kotlin コードから割り当てられたオブジェクトのメモリ。
  • Native: C または C++ コードから割り当てられたオブジェクトのメモリ。

    Android フレームワークでは、コードを Java または Kotlin で記述していても、画像アセットやその他のグラフィックを処理するときなどはネイティブ メモリを使用してユーザーのさまざまなタスクが処理されるため、アプリで C++ を使用していない場合でも、使用された一部のネイティブ メモリがここに表示される場合があります。

  • Graphics: GL サーフェスや GL テクスチャなど、画面にピクセルを表示するためにグラフィック バッファキューに使用されたメモリこのメモリは専用の GPU メモリではなく、CPU と共有されるメモリであることにご注意ください。

  • Stack: アプリのネイティブ スタックと Java スタックの両方によって使用されたメモリ。通常、アプリが実行しているスレッドの数に関係します。

  • Code: DEX バイトコード、最適化またはコンパイルされた DEX コードなど、コードとリソースのためにアプリが使用したメモリ。so ライブラリ、フォント。

  • Others: アプリによって使用された、カテゴリが不明なメモリ。

  • Allocated: アプリによって割り当てられた Java / Kotlin オブジェクトの数。C または C++ で割り当てられたオブジェクトはカウントされません。

割り当てレコードを検査する

割り当て記録を調べる手順は次のとおりです。

  1. [Table] タブのクラスリストに目をとおして、Allocations または Total Count の値が著しく大きく(最適化の対象によって異なります)、リークが発生している可能性があるオブジェクトを見つけます。
  2. [Instance View] ペインでインスタンスをクリックします。そのインスタンスに該当する内容に応じて、[Fields] タブまたは [Allocation コールスタック] タブが開きます。[フィールド] タブまたは [割り当てコールスタック] タブの情報を使用して、インスタンスが本当に必要か、不要な重複かを確認します。
[Fields] タブと [Allocation Call Stack] タブが表示されている [Instance details] ペイン
[Fields] タブと [Allocation コールスタック] タブが表示されているインスタンスの詳細ウィンドウ。

リストのエントリを右クリックすると、関連するソースコードに切り替えできます。

グローバル JNI 参照の表示

Java Native Interface(JNI)は、Java コードとネイティブ コードが互いに呼び出せるようにするフレームワークです。JNI 参照はネイティブ コードによって手動で管理されるため、次のような問題が発生する可能性があります。

  • ネイティブ コードによって使用される Java オブジェクトが長期間存在し続ける。
  • JNI 参照が最初に明示的に削除されずに破棄されると、Java ヒープ上の一部のオブジェクトに到達不能となる可能性があります。
  • グローバル JNI 参照制限を使い切っている。

このような問題のトラブルシューティングには、プロファイラで [View JNI heap] を選択してすべてのグローバル JNI 参照を表示し、Java タイプとネイティブ コールスタックでフィルタします。[Fields] タブでインスタンス フィールドを右クリックし、[Go to instance] を選択して、関連する割り当てコールスタックを表示します。

グローバル JNI 参照を示す JNI ヒープビュー
グローバル JNI 参照を示す JNI ヒープビュー。

[Allocation Call Stack] タブには、コード内のどこで JNI 参照の割り当てと解放が行われているかが表示されます。

JNI 参照の割り当てと解放が行われる場所を示す [Allocation コールスタック] タブ
JNI 参照の割り当てと解放が行われる場所を示す [Allocation コールスタック] タブ。

JNI について詳しくは、JNI に関するヒントをご覧ください。