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

ใน 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"]}
            }
        },
    }
    

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

ในชั้นเรียนทดสอบ 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) หากระบุชื่อคลาสทดสอบโดยไม่มีเฟรมทดสอบ ระบบจะตั้งค่าเฟรมทดสอบทั้งหมดในคลาสนั้นให้ข้ามการรายงานข้อบกพร่อง คุณสามารถใช้ Flag นี้เพื่อระงับเอาต์พุตสำหรับกรณีทดสอบที่มีปัญหาซึ่งคาดว่าจะดำเนินการไม่สำเร็จ

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