Đối số đo lường dụng cụ Microbenchmark (Điểm chuẩn vi mô)

Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Định cấu hình hành vi của Microbenchmark bằng các đối số đo lường sau. Bạn có thể thêm các đối số này vào cấu hình Gradle hoặc áp dụng trực tiếp trong khi chạy các công cụ đo lường qua dòng lệnh. Để đặt những đối số này cho tất cả các lần chạy kiểm thử dòng lệnh và Android Studio, hãy thêm chúng vào testInstrumentationRunnerArguments:

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

Bạn cũng có thể thiết lập đối số đo lường khi chạy phép đo điểm chuẩn trong Android Studio. Để thay đổi các đối số, hãy làm như sau:

Nếu bạn đang chạy phép đo điểm chuẩn từ dòng lệnh, hãy sử dụng -P android.testInstrumentationRunnerArguments.[name of the argument]:

./gradlew :benchmark:connectedAndroidTest -P android.testInstrumentationRunnerArguments.androidx.benchmark.profiling.mode=StackSampling

Nếu bạn đang gọi trực tiếp lệnh đo lường (có thể là trường hợp trong môi trường kiểm thử CI), hãy truyền đối số đến am instrument bằng -e:

adb shell am instrument -e androidx.benchmark.profiling.mode StackSampling -w com.example.macrobenchmark/androidx.benchmark.junit4.AndroidBenchmarkRunner

Để biết thêm thông tin về cách định cấu hình điểm chuẩn trong CI, hãy xem phần Đo điểm chuẩn trong CI

additionalTestOutputDir

Định cấu hình nơi lưu báo cáo điểm chuẩn JSON và kết quả phân tích tài nguyên trên thiết bị.

• Loại đối số: chuỗi đường dẫn tệp
• Mặc định là: kiểm tra thư mục bên ngoài của APK

androidx.benchmark.cpuEventCounter.enable (thử nghiệm)

Đếm các sự kiện CPU được chỉ định trong androidx.benchmark.cupEventCounter.events. Yêu cầu quyền truy cập thư mục gốc.

• Loại đối số: boolean
• Mặc định là: false

androidx.benchmark.cpuEventCounter.events (thử nghiệm)

Chỉ định loại sự kiện CPU cần tính. Để sử dụng đối số này, bạn phải đặt androidx.benchmark.cpuEventCounter.enable thành true.

• Loại đối số: danh sách chuỗi được phân tách bằng dấu phẩy
• Các tuỳ chọn hiện có:
  • Instructions
  • CPUCycles
  • L1DReferences
  • L1DMisses
  • BranchInstructions
  • BranchMisses
  • L1IReferences
  • L1IMisses
• Mặc định là: Instructions, CpuCycles, BranchMisses

androidx.benchmark.dryRunMode.enable

Cho phép bạn chạy phép đo điểm chuẩn trong một vòng lặp để xác minh rằng các điểm chuẩn đó hoạt động đúng cách.

Điều này có nghĩa là:

• Không thực thi lỗi cấu hình (ví dụ: để dễ dàng chạy các kiểm thử chính xác thông thường trên trình mô phỏng)
• Điểm chuẩn chỉ chạy một vòng lặp, không có thời gian khởi động
• Không thu thập dữ liệu đo lường và dấu vết để giảm thời gian chạy

Điều này giúp tối ưu hoá cho mức độ tải kiểm thử và xác thực logic điểm chuẩn trên bản dựng và độ chính xác của phép đo.

• Loại đối số: boolean
• Mặc định là: false

androidx.benchmark.iterations

Ghi đè số lần lặp lại mục tiêu theo thời gian để đảm bảo lượng công việc nhất quán. Đối số này thường chỉ hữu ích khi bật tính năng phân tích tài nguyên để đảm bảo thực hiện lượng công việc nhất quán trong một bản theo dõi phân tích khi so sánh các phương thức triển khai hoặc chạy khác nhau. Trong các trường hợp khác, điều này có thể làm giảm độ chính xác hoặc độ ổn định của hoạt động đo lường.

• Loại đối số: số nguyên
• Mặc định là: không chỉ định

androidx.benchmark.junit4.SideEffectRunListener

Bạn có thể nhận được kết quả đo điểm chuẩn không nhất quán nếu thực thi công việc không liên quan ở chế độ nền trong khi đang chạy phép đo điểm chuẩn.

Để tắt công việc ở chế độ nền trong quá trình đo điểm chuẩn, hãy đặt loại đối số đo lường listener thành androidx.benchmark.junit4.SideEffectRunListener.

• Loại đối số: chuỗi
• Các tuỳ chọn hiện có:
  • androidx.benchmark.junit4.SideEffectRunListener
• Mặc định là: không chỉ định

androidx.benchmark.output.enable

Cho phép ghi tệp JSON kết quả vào bộ nhớ ngoài.

• Loại đối số: boolean
• Mặc định là: true

androidx.benchmark.profiling.mode

Cho phép chụp tệp các theo dõi trong khi chạy điểm chuẩn. Vui lòng xem bài viết Phân tích Microbenchmark để biết các tuỳ chọn có sẵn.

Xin lưu ý rằng một số phiên bản hệ điều hành Android không hỗ trợ tính năng theo dõi phương thức mà không ảnh hưởng đến các phép đo tiếp theo. Microbenchmark sẽ gửi một ngoại lệ để ngăn chặn điều này, vì vậy, hãy sử dụng đối số mặc định để chỉ ghi lại dấu vết phương thức khi an toàn. Xem Vấn đề #316174880.

• Loại đối số: chuỗi
• Các tuỳ chọn hiện có:
  • MethodTracing
  • StackSampling
  • None
• Mặc định là: Phiên bản an toàn của MethodTracing chỉ ghi lại dấu vết phương thức nếu thiết bị có thể thực hiện việc này mà không ảnh hưởng đến các phép đo.

androidx.benchmark.suppressErrors

Chấp nhận danh sách lỗi được phân tách bằng dấu phẩy để chuyển thành cảnh báo.

• Loại đối số: danh sách chuỗi
• Các tuỳ chọn hiện có:
  • DEBUGGABLE
  • LOW-BATTERY
  • EMULATOR
  • CODE-COVERAGE
  • UNLOCKED
  • SIMPLEPERF
  • ACTIVITY-MISSING
• Mặc định là: danh sách trống