計測引数を追加する

以下の計測引数を指定して、ライブラリの動作を設定します。これらは Gradle の設定に追加することも、コマンドラインから計測を実行する際に直接適用することもできます。Android Studio とコマンドラインのすべてのテスト実行にこれらの引数を設定するには、testInstrumentationRunnerArguments に追加します。

android {
    defaultConfig {
        // ...
        testInstrumentationRunnerArguments["androidx.benchmark.dryRunMode.enable"] = "true"
    }
}

Android Studio からベンチマークを実行するときに計測引数をセットアップすることもできます。引数を変更する手順は次のとおりです。

[編集] をクリックしてから対象の実行設定をクリックし、編集します。

図 1. 実行設定を編集する
計測引数ごとに その他アイコンをクリックして、計測引数を編集します。

図 2. 計測引数を編集する
[その他の計測パラメータ] の追加アイコンをクリックして、必要な計測引数を追加します。

図 3. 必要な計測引数を追加する

コマンドラインから直接呼び出す場合は、-P android.testInstrumentationRunnerArguments.[name of the argument] を使用します。

./gradlew :benchmark:connectedAndroidTest -P android.testInstrumentationRunnerArguments.androidx.benchmark.enabledRules=BaselineProfile

androidx.benchmark.compilation.enabled

ベンチマークの各反復処理間のコンパイルを無効にできます。デフォルトでは、ターゲットアプリは、measureRepeated に渡される CompilationMode に準拠するように、各ベンチマーク間で再インストールされ、再コンパイルされます。このパラメータを無効にすると、再インストールとコンパイルの両方をスキップできます（テストスイートを実行する前にターゲットアプリを完全にコンパイルし、その完全にコンパイルされたターゲットに対してすべてのベンチマークを実行する場合など）。

引数タイプ: ブール値
デフォルト設定: true

androidx.benchmark.dryRunMode.enable

ベンチマークを 1 回のループで実行して、正常に機能するかどうかを検証できます。検証の一環として、定期的なテストで使用できます。

引数タイプ: ブール値
デフォルト設定: false

androidx.benchmark.enabledRules

1 種類のテスト（ベースラインプロファイル生成または Macrobenchmark テスト）のみにフィルタリングを実行できます。カンマ区切りのリストもサポートされます。

引数のタイプ: 文字列
利用可能なオプション:
- Macrobenchmark
- BaselineProfile
デフォルト設定: 指定なし

$packageName に対して Macrobenchmark を実行すると、メソッドトレースが有効になります。この場合、VM の実行速度が通常より遅くなるため、トレースファイルの指標は相対的な観点でのみ考慮します（初回の実行速度と 2 回目の実行速度を比較するなど）。

androidx.benchmark.perfettoSdkTracing.enable

Jetpack Compose のコンポジションのトレースなどの androidx.tracing.perfetto トレースポイントを有効にします。トレースポイントを有効にするとターゲットプロセスが起動するため、StartupMode.COLD が使用されていない場合にのみ効果があります。

引数タイプ: ブール値
デフォルト設定: false

androidx.benchmark.startupProfiles.enable

ベンチマーク実行時に起動プロファイルの生成を無効にできます。

引数タイプ: ブール値
デフォルト設定: true

androidx.benchmark.suppressErrors

エラーのカンマ区切りのリストを受け入れて、警告に変換できます。

引数のタイプ: 文字列のリスト
利用可能なオプション:
- DEBUGGABLE
  
  DEBUGGABLE エラーは、ターゲットパッケージのマニフェストに debuggable=true と設定された状態で実行されていることを示しています。これによりデバッグ機能がサポートされ、ランタイムパフォーマンスが著しく低下します。このエラーを回避するには、debuggable=false を使用してベンチマークを実行します。debuggable 引数は、ベンチマークの改善が実際のユーザーエクスペリエンスに反映されなかったり、リリースパフォーマンスが低下したりする可能性があるという点で、実行速度に影響します。
- LOW-BATTERY
  
  バッテリー残量が少ない場合、一般にデバイスは、大きなコアを無効にするなど、パフォーマンスを低下させてバッテリー残量を節約します。これは、デバイスが電源に接続されている場合でも発生します。パフォーマンスを低下させて意図的にアプリのプロファイリングを行っている場合にのみ、このエラーを除外します。
- EMULATOR
  
  EMULATOR エラーは、ベンチマークがエミュレータで実行されていることを示しています。これは、実際のユーザーデバイスを表すものではありません。エミュレータでベンチマークが改善しても、実際のユーザーエクスペリエンスには反映されない場合や、実際のデバイスのパフォーマンスが低下する場合があります。代わりに実機を使用してベンチマークを行う必要があります。このエラーは、細心の注意を払って除外します。
- NOT-PROFILEABLE
  
  ターゲットパッケージ $packageName が、<profileable shell=true> に設定されていない状態で実行されています。Android 10 と 11 では、Macrobenchmark がターゲットプロセスから詳細なトレース情報（アプリやライブラリで定義されたシステムトレースセクションなど）をキャプチャできるようにするために profileable が必要になります。このエラーは、細心の注意を払って除外します。
- METHOD-TRACING-ENABLED
  
  ベンチマーク対象のアプリで Macrobenchmark を実行すると、メソッドトレースが有効になります。この場合、VM の実行速度が通常より遅くなるため、トレースファイルの指標は相対的な観点でのみ考慮します（初回の実行速度と 2 回目の実行速度を比較するなど）。このエラーを除外すると、メソッドトレースオプションが異なるビルドのベンチマークを比較した場合に、結果が不正確になる可能性があります。
デフォルト設定: 空のリスト

additionalTestOutputDir

JSON ベンチマークレポートとプロファイリング結果を保存するデバイス上の場所を指定します。

引数のタイプ: パスの文字列
デフォルト設定: テスト APK の外部ディレクトリ

あなたへのおすすめ

注: JavaScript がオフになっている場合はリンクテキストが表示されます
Microbenchmark 計測引数
ベースラインプロファイルを作成する
JankStats ライブラリ

Control your app