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

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

additionalTestOutputDir

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

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

androidx.benchmark.dryRunMode.enable

ベンチマークを 1 ループで実行し、正常に動作することを確認できます。検証の一環として、定期的なテストで使用できます。

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

androidx.benchmark.iterations

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

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

androidx.benchmark.output.enable

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

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

androidx.benchmark.profiling.mode

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

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

androidx.benchmark.suppressErrors

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

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

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

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

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