พารามิเตอร์ผู้ใช้

ใน Android Comms Test Suite (ACTS) คุณระบุข้อมูลหรือพารามิเตอร์การทดสอบเพิ่มเติมได้จากภายในการกำหนดค่า ACTS พารามิเตอร์ผู้ใช้จะอยู่ในรูปแบบใดก็ได้ที่เป็นไปตาม JSON และถอดรหัสเป็นประเภทที่เหมาะสมใน Python (เช่น dict, list และ str) การระบุพารามิเตอร์ผู้ใช้ได้ 2 แห่ง ได้แก่

  • ที่ระดับรากของการกำหนดค่า

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

  • ภายในกลุ่มทดสอบ

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

หากพบพารามิเตอร์ผู้ใช้ภายในระดับรากและภายในทดสอบ ระบบจะใช้ค่าเฉพาะของ testbed

ในชั้นเรียนทดสอบ ACTS ผู้ใช้จะอ่านข้อมูลต่อไปนี้ได้

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={})

พารามิเตอร์ผู้ใช้พิเศษ

ต่อไปนี้คือรายการพารามิเตอร์ผู้ใช้ที่ไม่บังคับซึ่งมีประโยชน์ ซึ่งมีพร็อพเพอร์ตี้พิเศษใน ACTS

  • consecutive_failure_limit: จำนวนการทดสอบล้มเหลวติดต่อกันที่อนุญาตก่อนบล็อกการทดสอบที่เหลือในคลาสการทดสอบเดียวกัน หากไม่ได้ระบุไว้ การทำงานเริ่มต้นคือการเรียกใช้การทดสอบทั้งหมด โดยไม่คำนึงถึงความล้มเหลว พารามิเตอร์นี้มีประโยชน์ในกรณีที่มีการกำหนดค่าที่ทดสอบไม่ถูกต้อง ซึ่งทำให้การทดสอบทั้งหมดล้มเหลว

  • quiet_tests: รายการคลาสการทดสอบหรือกรอบการทดสอบที่ระบุด้วยรูปแบบ test_class หรือ test_class.test_name เช่น BleScanApiTest หรือ BleScanApiTest.test_start_ble_scan_with_default_settings กรอบการทดสอบแต่ละรายการในรายการนี้จะไม่มีการสร้างอาร์ติแฟกต์ที่ล้มเหลวในการทดสอบ (เช่น รายงานข้อบกพร่อง บันทึก qxdm) หากระบุชื่อคลาสการทดสอบโดยไม่มีกรอบการทดสอบ กรอบการทดสอบทั้งหมดในคลาสที่ระบุจะถูกตั้งค่าให้ข้ามรายงานข้อบกพร่อง แฟล็กนี้สามารถใช้ระงับเอาต์พุตสำหรับกรอบการทดสอบที่เป็นปัญหาซึ่งคาดว่าจะล้มเหลวได้

  • retry_tests: รายการคลาสการทดสอบหรือกรอบการทดสอบที่ระบุด้วยรูปแบบ test_class หรือ test_class.test_name เช่น BleScanApiTest หรือ BleScanApiTest.test_start_ble_scan_with_default_settings สำหรับกรอบการทดสอบแต่ละรายการในรายการนี้ หากการทดสอบล้มเหลวจะมีการลองซ้ำ 1 ครั้ง หากการทดสอบล้มเหลวในครั้งที่ 2 ระบบจะทำเครื่องหมายเป็นล้มเหลว