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

Định cấu hình hành vi cho điểm chuẩn bằng cách chỉ định các đối số khác nhau cho trình chạy đo lường. Bạn có thể áp dụng các quy tắc này cho cấu hình Gradle hoặc thêm trực tiếp trong khi chạy công cụ đo lường qua dòng lệnh.

Để thiết lập các đối số đo lường khi chạy phép đo điểm chuẩn trên Android Studio, hãy làm như sau:

  1. Chỉnh sửa cấu hình chạy bằng cách nhấp vào Edit (Chỉnh sửa) rồi chọn cấu hình bạn muốn chỉnh sửa.
    Hình 1. Chỉnh sửa cấu hình chạy.
  2. Chỉnh sửa các đối số đo lường bằng cách nhấp vào bên cạnh trường Instrumentation arguments (Đối số đo lường).
    Hình 2. Chỉnh sửa đối số đo lường.
  3. Nhấp vào rồi thêm đối số đo lường bắt buộc.
    Hình 3. Thêm đối số đo lường.

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.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. Bạn có thể dùng phương pháp này với các bài kiểm thử thông thường trong quá trình xác minh.

  • 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.

  • Loại đối số: chuỗi
  • Các tuỳ chọn hiện có:
    • MethodTracing
    • StackSampling
    • None
  • Mặc định là: None

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

androidx.benchmark.startupMode.enable (Không dùng nữa)

Định cấu hình lại hành vi lặp lại để hỗ trợ mã đo điểm chuẩn trong quá trình khởi động. Điểm chuẩn được thực hiện mà không cần vòng lặp khởi động cho 10 phép đo. Để giảm thiểu hao tổn khi đo điểm chuẩn vi mô, tính năng trung bình vòng lặp sẽ bị tắt.

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