Microbenchmark インストルメンテーション引数

インストルメンテーション ランナーにさまざまな引数を指定して、ベンチマークの動作を設定します。これらは Gradle の設定に適用できます。または、コマンドラインからインストルメンテーションを実行する際に直接追加することもできます。

Android Studio からベンチマークを実行するときにインストルメンテーション引数をセットアップする方法は次のとおりです。

additionalTestOutputDir

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

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

androidx.benchmark.dryRunMode.enable

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

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

androidx.benchmark.iterations

時間ベースの目標イテレーション数をオーバーライドして、処理量に一貫性を持たせます。これは通常、プロファイリングを有効にして、異なる実装または実行を比較する際に、プロファイリング トレース内で一定量の作業が実行されるように設定したい場合にのみ有用です。それ以外のシナリオでは、測定の精度や安定性が低下する可能性があります。

• 引数のタイプ: 整数
• デフォルト設定: 指定なし

androidx.benchmark.junit4.SideEffectRunListener

ベンチマークの実行中に無関係なバックグラウンド処理が実行されると、一貫性のあるベンチマーク結果が得られない可能性があります。

ベンチマーク実行中のバックグラウンド処理を無効にするには、listener インストルメンテーション引数のタイプを androidx.benchmark.junit4.SideEffectRunListener に設定します。

• 引数タイプ: 文字列
• 利用可能なオプション:
  • androidx.benchmark.junit4.SideEffectRunListener
• デフォルト設定: 指定なし

androidx.benchmark.output.enable

結果の JSON ファイルを外部ストレージに書き込めるようにします。

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

androidx.benchmark.profiling.mode

ベンチマークの実行中にトレース ファイルをキャプチャできるようにします。利用可能なオプションについては、Microbenchmark をプロファイリングするをご覧ください。

• 引数のタイプ: 文字列
• 利用可能なオプション:
  • MethodTracing
  • StackSampling
  • None
• デフォルト設定: None

androidx.benchmark.suppressErrors

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

• 引数のタイプ: 文字列のリスト
• 利用可能なオプション:
  • DEBUGGABLE
  • LOW-BATTERY
  • EMULATOR
  • CODE-COVERAGE
  • UNLOCKED
  • SIMPLEPERF
  • ACTIVITY-MISSING
• デフォルト設定: 空のリスト

androidx.benchmark.startupMode.enable（非推奨）

起動時のベンチマーク コードをサポートするようにループ動作を再設定します。ベンチマークは、ウォームアップ ループなしで 10 回の測定で実行されます。マイクロ ベンチマークのオーバーヘッドを最小限に抑えるために、ループ平均化は無効になっています。

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

あなたへのおすすめ

• 注: JavaScript がオフになっている場合はリンクテキストが表示されます
• Macrobenchmark インストルメンテーション引数
• Microbenchmark をプロファイリングする
• ベースライン プロファイルを作成する {:#creating-profile-rules}