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

في مجموعة اختبارات الاتصالات في 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 بالنسبة إلى كل اختبار حالة في هذه القائمة، إذا تعذّر إجراء اختبار، تتم إعادة المحاولة مرة واحدة. إذا تعذّر الاختبار مجددًا، تتم وضع علامة عليه بأنّه تعذّر.