Préparateurs cibles

Les préparateurs de cibles sont appelés avant les tests au niveau de test dans lequel ils sont définis. Cela permet de configurer n'importe quel appareil pour que les tests se déroulent correctement.

Interface de base

L'interface de base est ITargetPreparer, qui permet d'exécuter une méthode setUp. Mer nous vous recommandons d'implémenter la classe abstraite de base BaseTargetPreparer, qui fournit une fonction de désactivation intégrée pour désactiver facilement un préparateur.

Interface plus claire

L'extension naturelle de setUp est tearDown et est fournie par une autre interface, ITargetCleaner. Cela fournit l'interface tearDown qui permet de nettoyer tout ce qui a été fait dans setUp après l'exécution du test.

La classe BaseTargetPreparer étend également ITargetCleaner.

Recommandations

Nous vous recommandons de limiter chaque préparateur à une seule fonction principale, par exemple l'installation d'un APK ou l'exécution d'une commande. Cela permet de réutiliser plus facilement les préparateurs.

Vérifiez également la liste des préparateurs disponibles avant d'en ajouter un nouveau à éviter de dupliquer le travail. Des préparateurs sont disponibles dans tools/tradefederation/core/src/com/android/tradefed/targetprep/.

Configuration XML

Le tag d'objet est target_preparer, par exemple:

<target_preparer class="com.android.tradefed.targetprep.InstallApkSetup">
    <option name="install-arg" value="-d"/>
</target_preparer>

Consultez également Configurer des suites pour obtenir plus d'informations.

Configuration de premier niveau

Si spécifié dans une configuration de niveau supérieur, le préparateur ne s'exécute qu'une seule fois pour chaque appareil. Par exemple, cts-common.xml, qui est une configuration de premier niveau pour les tests de la suite de tests de compatibilité Android (CTS).

Configuration au niveau du module

S'il est spécifié au niveau du module, le programme de préparation s'exécute toujours avant cela. de ce module. Par exemple, backup/AndroidTest.xml, qui définit la manière dont Tradefed exécute le module CTS backup.

Bien que le programme de préparation s'exécute avant le module, il s'exécute après les vérificateurs de l'état du système.