Argumen Instrumentasi Macrobenchmark

Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Mengonfigurasi perilaku library dengan argumen instrumentasi berikut. Argumen ini dapat ditambahkan ke konfigurasi Gradle atau diterapkan secara langsung saat menjalankan instrumentasi dari command line. Jika menggunakan Gradle, tambahkan argumen ke testInstrumentationRunnerArguments:

android {
    defaultConfig {
        // ...
        testInstrumentationRunnerArguments["androidx.benchmark.enabledRules"] = "BaselineProfile"
    }
}

Jika memanggil langsung dari command line, gunakan -P android.testInstrumentationRunnerArguments.[name of the argument].

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

androidx.benchmark.compilation.enabled

Mengizinkan penonaktifan kompilasi di antara setiap iterasi benchmark. Secara default, aplikasi target diinstal ulang dan dikompilasi ulang di antara setiap benchmark, agar sesuai dengan CompilationMode yang diteruskan ke measureRepeated. Menonaktifkan ini memungkinkan Anda melewati penginstalan ulang dan kompilasi jika, misalnya, Anda ingin mengompilasi aplikasi target sepenuhnya satu kali sebelum menjalankan rangkaian pengujian, dan menjalankan semua tolok ukur terhadap target yang dikompilasi sepenuhnya.

  • Jenis argumen: boolean
  • Default: true

androidx.benchmark.dryRunMode.enable

Memungkinkan benchmark dijalankan dalam satu loop untuk memastikannya berfungsi dengan benar. Dapat digunakan dengan pengujian biasa sebagai bagian dari verifikasi.

  • Jenis argumen: boolean
  • Default: false

androidx.benchmark.enabledRules

Memungkinkan pemfilteran berjalan hanya ke satu jenis pengujian - pembuatan Profil Baseline atau pengujian Macrobenchmark. Daftar yang dipisahkan koma juga didukung.

  • Jenis argumen: string
  • Opsi yang tersedia:
    • Macrobenchmark
    • BaselineProfile
  • Default: Tidak ditentukan

androidx.benchmark.fullTracing.enable (Eksperimental)

Mengaktifkan tracepoint androidx.tracing.perfetto seperti pelacakan komposisi Jetpack Compose. Perhatikan bahwa perubahan ini hanya berpengaruh jika StartupMode.COLD tidak digunakan, karena mengaktifkan tracepoint akan mengaktifkan proses target.

  • Jenis argumen: boolean
  • Default: false

androidx.benchmark.suppressErrors

Menerima daftar error yang dipisahkan koma untuk diubah menjadi peringatan.

  • Jenis argumen: daftar string
  • Opsi yang tersedia:
    • DEBUGGABLE
    • LOW-BATTERY
    • EMULATOR
    • NOT-PROFILEABLE
  • Default: daftar kosong

additionalTestOutputDir

Mengonfigurasi tempat laporan benchmark JSON dan hasil profiling akan disimpan di perangkat.

  • Jenis argumen: string jalur file
  • Default: direktori eksternal APK pengujian