Parameter pengguna

Di Android Comms Test Suite (ACTS), informasi pengujian atau parameter tambahan dapat ditentukan dari dalam konfigurasi ACTS. Parameter pengguna dapat menggunakan format apa pun yang sesuai dengan JSON, dan didekode ke dalam jenis yang sesuai di Python (misalnya, dict, list, dan str). Ada dua tempat untuk menentukan parameter pengguna:

• Di level root konfigurasi

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

• Di dalam testbed

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

Jika parameter pengguna ditemukan dalam tingkat root dan di dalam tempat pengujian, nilai khusus tempat pengujian akan digunakan.

Di class uji ACTS, pengguna dapat membaca informasi ini menggunakan kode berikut:

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

Parameter pengguna khusus

Berikut adalah daftar parameter pengguna opsional berguna yang memiliki properti khusus di ACTS:

• consecutive_failure_limit: Jumlah kegagalan uji berturut-turut yang diizinkan sebelum memblokir pengujian yang tersisa di class pengujian yang sama. Jika tidak ditentukan, perilaku default-nya adalah menjalankan semua pengujian, terlepas dari kegagalannya. Parameter ini berguna jika testbed tidak dikonfigurasi dengan benar, yang menyebabkan semua pengujian gagal.

• quiet_tests: Daftar class pengujian atau kasus pengujian yang ditentukan dengan format test_class atau test_class.test_name, misalnya, BleScanApiTest atau BleScanApiTest.test_start_ble_scan_with_default_settings. Setiap kasus pengujian dalam daftar ini tidak akan memiliki artefak kegagalan uji yang dihasilkan (misalnya, laporan bug, log qxdm). Jika nama class pengujian ditentukan tanpa kasus pengujian, semua kasus pengujian di class yang diberikan akan ditetapkan untuk melewati laporan bug. Flag ini dapat digunakan untuk menyembunyikan output untuk kasus pengujian bermasalah yang diperkirakan gagal.

• retry_tests: Daftar class pengujian atau kasus pengujian yang ditentukan dengan format test_class atau test_class.test_name, misalnya, BleScanApiTest atau BleScanApiTest.test_start_ble_scan_with_default_settings. Untuk setiap kasus pengujian dalam daftar ini, jika pengujian gagal, pengujian akan dicoba lagi satu kali. Jika pengujian gagal untuk kedua kalinya, pengujian ditandai sebagai gagal.