معلمات المستخدم

في حزمة اختبار مراسلات Android (ACTS)، يمكن تحديد معلومات أو معلَمات اختبار إضافية من داخل إعدادات ACTS. يمكن أن تكون مَعلمات المستخدم بأي تنسيق متوافق مع JSON، ويتم فك ترميزها إلى النوع المناسب في Python (مثل 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 لكل حالة اختبار في هذه القائمة، إذا فشل الاختبار، تتم إعادة المحاولة مرة واحدة. إذا فشل الاختبار مرة ثانية، يتم وضع علامة عليه كفشل.