Parameter pengguna

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

  • Di tingkat root konfigurasi

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

  • 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 pengujian ACTS, pengguna dapat membaca informasi ini menggunakan hal 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 yang berguna dan memiliki properti khusus di ACTS:

  • consecutive_failure_limit: Jumlah kegagalan pengujian berturut-turut yang diizinkan sebelum memblokir pengujian yang tersisa di class pengujian yang sama. Jika tidak ditentukan, perilaku defaultnya adalah menjalankan semua pengujian, terlepas dari kegagalan. Parameter ini berguna jika testbed tidak dikonfigurasi dengan benar, sehingga 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 tertentu akan disetel untuk melewati laporan bug. Flag ini dapat digunakan untuk menyembunyikan output untuk kasus pengujian bermasalah yang diperkirakan akan 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 gagal, pengujian akan dicoba lagi sekali. Jika gagal untuk kali kedua, pengujian akan ditandai sebagai gagal.