Paramètres utilisateur

Dans Android Comms Test Suite (ACTS) , des informations ou des paramètres de test supplémentaires peuvent être spécifiés à partir de la configuration ACTS. Les paramètres utilisateur peuvent être dans n'importe quel format compatible JSON et sont décodés dans le type approprié en Python (par exemple, dict , list et str ). Il existe deux endroits où les paramètres utilisateur peuvent être spécifiés :

  • Au niveau racine de la configuration

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

  • Au sein d'un banc d'essai

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

Si un paramètre utilisateur est trouvé au niveau racine et dans le banc de test, la valeur spécifique au banc de test est utilisée.

Dans une classe de test ACTS, les utilisateurs peuvent lire ces informations en utilisant les éléments suivants :

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

Paramètres utilisateur spéciaux

Vous trouverez ci-dessous une liste de paramètres utilisateur facultatifs utiles qui ont des propriétés spéciales dans ACTS :

  • consecutive_failure_limit : Nombre d'échecs de tests consécutifs à autoriser avant de bloquer les tests restants dans la même classe de tests. S'il n'est pas spécifié, le comportement par défaut consiste à exécuter tous les tests, quels que soient les échecs. Ce paramètre est utile dans les cas où le banc de test est mal configuré, entraînant l'échec de tous les tests.

  • quiet_tests : Liste des classes de tests ou des cas de tests spécifiés au format test_class ou test_class . test_name , par exemple, BleScanApiTest ou BleScanApiTest.test_start_ble_scan_with_default_settings . Chaque scénario de test de cette liste ne générera aucun artefact d'échec de test (par exemple, rapports de bogues, journaux qxdm). Si un nom de classe de test est spécifié sans scénario de test, tous les scénarios de test de la classe donnée sont configurés pour ignorer les rapports de bogues. Cet indicateur peut être utilisé pour supprimer la sortie des cas de test problématiques qui devraient échouer.

  • retry_tests : Liste des classes de tests ou des cas de tests spécifiés au format test_class ou test_class . test_name , par exemple, BleScanApiTest ou BleScanApiTest.test_start_ble_scan_with_default_settings . Pour chaque scénario de test de cette liste, si un test échoue, il est réessayé une fois. Si le test échoue une deuxième fois, il est marqué comme un échec.