Thông số người dùng

Trong Android Comms Test Suite (ACTS) , thông tin hoặc tham số kiểm tra bổ sung có thể được chỉ định từ bên trong cấu hình ACTS. Thông số người dùng có thể ở bất kỳ định dạng tuân thủ JSON nào và được giải mã thành loại thích hợp trong Python (ví dụ: dict , list và str ). Có hai nơi có thể chỉ định tham số người dùng:

  • Ở cấp độ gốc của cấu hình

    {
    "testbed": {
        ...
    },
    "my_user_param1": "my_value",
    "my_user_param2": {"another": ["value"]}
}

  • Trong một giường thử nghiệm

    {
    "testbed": {
        "my_testbed": {
            "AndroidDevice": [...],
            ...,
            "my_user_param1": "my_value",
            "my_user_param2": {"another": ["value"]}
        }
    },
}

Nếu tìm thấy thông số người dùng ở cấp độ gốc và trong nền thử nghiệm thì giá trị dành riêng cho thử nghiệm sẽ được sử dụng.

Trong lớp kiểm tra ACTS, người dùng có thể đọc thông tin này bằng cách sử dụng:

class MyActsTest
    def setup_class(self):
        self.my_param_1 = self.user_params['my_user_param1']

        # Get the parameter with a default value if not found within config.
        self.my_param_2 = self.user_params.get('my_user_param2', default={})

Thông số người dùng đặc biệt

Dưới đây là danh sách các tham số người dùng tùy chọn hữu ích có các thuộc tính đặc biệt trong ACTS:

  • consecutive_failure_limit : Số lần kiểm tra thất bại liên tiếp cho phép trước khi chặn các bài kiểm tra còn lại trong cùng một lớp kiểm tra. Nếu không được chỉ định, hành vi mặc định là chạy tất cả các thử nghiệm, bất kể lỗi. Tham số này hữu ích trong trường hợp nền thử nghiệm được cấu hình không đúng, khiến tất cả các thử nghiệm đều thất bại.

  • quiet_tests : Danh sách các lớp kiểm thử hoặc trường hợp kiểm thử được chỉ định với định dạng test_class hoặc test_class . test_name , ví dụ: BleScanApiTest hoặc BleScanApiTest.test_start_ble_scan_with_default_settings . Mỗi trường hợp kiểm thử trong danh sách này sẽ không tạo ra bất kỳ thành phần lỗi kiểm thử nào (ví dụ: báo cáo lỗi, nhật ký qxdm). Nếu tên lớp kiểm thử được chỉ định mà không có trường hợp kiểm thử thì tất cả trường hợp kiểm thử trong lớp đã cho sẽ được đặt để bỏ qua báo cáo lỗi. Cờ này có thể được sử dụng để ngăn chặn đầu ra đối với các trường hợp kiểm thử có vấn đề dự kiến ​​sẽ thất bại.

  • retry_tests : Danh sách các lớp kiểm thử hoặc trường hợp kiểm thử được chỉ định với định dạng test_class hoặc test_class . test_name , ví dụ: BleScanApiTest hoặc BleScanApiTest.test_start_ble_scan_with_default_settings . Đối với mỗi trường hợp kiểm thử trong danh sách này, nếu kiểm thử thất bại thì nó sẽ được thử lại một lần. Nếu thử nghiệm thất bại lần thứ hai, nó được đánh dấu là thất bại.