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

Trong Bộ kiểm thử giao tiếp Android (ACTS), bạn có thể chỉ định thêm thông tin hoặc tham số kiểm thử ngay trong cấu hình ACTS. Tham số người dùng có thể ở định dạng bất kỳ tuân thủ JSON và được giải mã thành loại thích hợp trong Python (ví dụ: dict, liststr). Có hai vị trí 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 môi trường thử nghiệm

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

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

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

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ố đặc biệt của người dùng

Dưới đây là danh sách các thông số người dùng không bắt buộc nhưng hữu ích có các thuộc tính đặc biệt trong ACTS:

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

  • quiet_tests: Danh sách các lớp kiểm thử hoặc trường hợp kiểm thử được chỉ định bằng đị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ỳ cấu phần phần mềm kiểm thử nào không thành công (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ì mọi trường hợp kiểm thử trong lớp nhất định đều được thiết lập để bỏ qua báo cáo lỗi. Bạn có thể dùng cờ này để chặn đầu ra đối với các trường hợp kiểm thử có vấn đề dự kiến không thành công.

  • retry_tests: Danh sách các lớp kiểm thử hoặc trường hợp kiểm thử được chỉ định bằng đị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 một kiểm thử không thành công, thì kiểm thử đó sẽ được thử lại một lần. Nếu kiểm thử không thành công lần thứ hai, thì lượt kiểm thử đó sẽ được đánh dấu là không thành công.