پارامترهای کاربر

در مجموعه آزمایشی Android Comms (ACTS) ، اطلاعات یا پارامترهای آزمایش اضافی را می توان از داخل پیکربندی ACTS مشخص کرد. پارامترهای کاربر می توانند در هر فرمت سازگار با JSON باشند و به نوع مناسب در پایتون رمزگشایی می شوند (به عنوان مثال، dict ، list و str ). دو مکان وجود دارد که پارامترهای کاربر را می توان مشخص کرد:

  • در سطح ریشه پیکربندی

    {
    "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). اگر نام یک کلاس آزمایشی بدون یک مورد آزمایشی مشخص شده باشد، همه موارد آزمایشی در کلاس داده شده طوری تنظیم می‌شوند که گزارش‌های اشکال را رد کنند. این پرچم را می توان برای سرکوب خروجی برای موارد آزمایش مشکل دار که انتظار می رود شکست بخورند استفاده شود.

  • retry_tests : فهرست کلاس‌های تست یا موارد تست مشخص شده با فرمت test_class یا test_class . test_name ، برای مثال، BleScanApiTest یا BleScanApiTest.test_start_ble_scan_with_default_settings . برای هر مورد آزمایشی در این لیست، اگر آزمایشی ناموفق باشد، یک بار دوباره امتحان می شود. اگر آزمایش برای بار دوم ناموفق باشد، به عنوان ناموفق علامت گذاری می شود.