このページは Cloud Translation API によって翻訳されました。

コンポジションのトレース

多くの場合、トレースはパフォーマンスの問題を初めて調査するときに最適な情報源です。これによって、何が問題であり、どこから調べ始めるべきかについて、仮説を立てることができます。

Android でサポートされているトレースには、システムトレースとメソッドトレースの 2 つのレベルがあります。

システムトレースは、トレース用に特別にマークされた領域のみを追跡するため、オーバーヘッドが少なく、アプリのパフォーマンスに大きく影響することはありません。システムトレースは、コードの特定のセクションの実行にかかっている時間を確認するのに便利です。

メソッドトレースは、アプリ内のすべての関数呼び出しを追跡します。これは非常に高額ですアプリのパフォーマンスに大きく影響しますが呼び出されている状況や呼び出されている関数、呼び出すことができます。

デフォルトでは、システムトレースには個別のコンポーズ可能な関数は含まれません。メソッドトレースで使用できます。

現在、システムトレース内にコンポーズ可能な関数を表示するための新しいシステムトレース機能をテストしています。この機能により、システムトレースレベルの煩わしさの低さと、メソッドトレースレベルのコンポジションの詳細を実現できます。

コンポジションのトレースをセットアップする

プロジェクトで再コンポジションのトレースを試すには、少なくとも次のバージョンに更新する必要があります。

Android Studio Flamingo
Compose UI: 1.3.0
Compose Compiler: 1.3.0

トレースを実行するデバイスまたはエミュレータも、API レベル 30 以上である必要があります。

さらに、Compose Runtime Tracing に新しい依存関係を追加する必要があります。

implementation("androidx.compose.runtime:runtime-tracing:1.0.0-beta01")

この依存関係により、再コンポジションを含むシステムトレースを取得すると、コンポーズ可能な関数が自動的に表示されます。

システムトレースを行う

システムトレースを行い、新しい再コンポジションのトレースの実際の動作を確認する手順は次のとおりです。

プロファイラを開きます。

図 2. Android Studio - プロファイリングを開始する
[CPU のタイムライン] をクリックします。

図 3. Android Studio Profiler - CPU のタイムライン
トレースする UI にアプリを移動し、[System Trace] と [Record] を選択します。

図 4. トレースオプション - システムトレース
アプリを使用すると、再コンポーズが行われ、記録が停止されます。トレースが処理されて表示されると、再コンポジションのトレースでコンポーザブルを確認できるようになります。キーボードとマウスを使用して、トレースでズームおよびパンできます。トレースの操作に慣れていない場合は、トレースを記録するのドキュメントをご覧ください。

図 5. システムトレース

グラフ内のコンポーザブルをダブルクリックすると、そのソースコードに移動します。
[Flame Chart] では、ファイルと行番号とともにコンポーザブルを確認することもできます。

図 6. フレームチャート

注意点

APK サイズのオーバーヘッド

この機能のオーバーヘッドはできる限り最小限に抑えることを目指していましたが、Compose コンパイラによって APK に埋め込まれたトレース文字列により、Compose アプリの APK サイズが増加します。このサイズ増加はアプリが Compose をあまり使用していない場合は比較的小さいか、完全な Compose については大規模にします。。また、これらのトレース文字列は、上記のようにトレースツールで確認できるように難読化されていません。バージョン 1.3.0 以降では、Compose コンパイラがこれらをすべてのアプリに挿入します。

製品版ビルドでトレース文字列を削除するには、次の ProGuard ルールを追加します。

-assumenosideeffects public class androidx.compose.runtime.ComposerKt {

   boolean isTraceInProgress();

   void traceEventStart(int,int,int,java.lang.String);

   void traceEventStart(int,java.lang.String);

   void traceEventEnd();

}

これらの関数は将来変更される可能性がありますが、変更については、Compose のリリースノートに記載されます。

APK サイズのコストは発生しますが、これらを維持することにより、プロファイリングされる APK が、アプリユーザーによって実行される APK と同じであることが保証されます。

正確なタイミング

パフォーマンステストと同様に、正確なプロファイリングを行うには、プロファイル可能なアプリに基づく app profileable と non-debuggable。

ターミナルからトレースをキャプチャする

ターミナルからコンポジショントレースをキャプチャできます。そのためには、通常は Android Studio によって自動的に行われる手順を実行する必要があります。

依存関係を追加する

まず、アプリに依存関係を追加します。

implementation("androidx.tracing:tracing-perfetto:1.0.0")
implementation("androidx.tracing:tracing-perfetto-binary:1.0.0")

レコードコマンドを生成する

Perfetto を使用してレコードコマンドを生成します。

次の例のように、track_event データソースセクションを手動で追加します。

adb shell perfetto \
  -c - --txt \
  -o /data/misc/perfetto-traces/trace \
<<EOF
buffers: {
    size_kb: 63488
    fill_policy: RING_BUFFER
}
buffers: {
    size_kb: 2048
    fill_policy: RING_BUFFER
}
data_sources: {
    config {
        name: "track_event"
    }
}
duration_ms: 10000
flush_period_ms: 30000
incremental_state_config {
    clear_period_ms: 5000
}
EOF

トレースをキャプチャする

アプリを起動し、トレースするセクションを準備します。

ブロードキャストを発行してアプリでトレースを有効にします。

# set app package variable, e.g. com.google.samples.apps.nowinandroid.debug
# can be found through `adb shell ps -ef` or `adb shell cmd package list packages`
package=<your app process>

# issue a broadcast to enable tracing
adb shell am broadcast \
-a androidx.tracing.perfetto.action.ENABLE_TRACING \
$package/androidx.tracing.perfetto.TracingReceiver

先ほど作成したレコードコマンドを開始します。

トレースを開く

adb pull <location>: デバイスのトレース（レコードコマンドで指定された場所）。
Perfetto で開きます。

Jetpack Macrobenchmark を使用してトレースをキャプチャする

パフォーマンスは Jetpack Macrobenchmark を使用して測定できます。トレースを結果として出力できますコンポジションのトレースを有効にするには、マクロベンチマークを使用するには、次のことを行う必要があります。

次の依存関係を Macrobenchmark テストモジュールに追加します。

implementation("androidx.tracing:tracing-perfetto:1.0.0")
implementation("androidx.tracing:tracing-perfetto-binary:1.0.0")

androidx.benchmark.fullTracing.enable=true インストルメンテーション引数を追加するベンチマークを実行する前にMacrobenchmark インストルメンテーション引数をご覧ください。インストルメンテーション引数を使用します。

フィードバック

この機能についてのフィードバック、バグ、ご要望がございましたら、ぜひお寄せください。Issue Tracker からフィードバックを送信できます。

レイアウトの検査