Les préparateurs cibles sont invoqués avant les tests dans le niveau de test dans lequel ils sont définis. Cela permet la configuration de n’importe quel appareil pour que les tests se déroulent sans problème.
Interface de base
L'interface de base est ITargetPreparer , qui permet d'exécuter l'implémentation d'une méthode setUp . Nous vous recommandons d'implémenter notre classe abstraite de base BaseTargetPreparer , qui fournit une fonctionnalité de désactivation intégrée pour désactiver facilement un préparateur.
Interface plus propre
L'extension naturelle de setUp est tearDown et est fournie par une interface différente, 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 recommandons à chaque préparateur de se limiter à une seule fonction principale, par exemple installer un APK ou exécuter une commande. Cela permet une réutilisation plus facile des préparateurs.
Vérifiez également la liste des préparateurs disponibles avant d’en ajouter un nouveau pour éviter les duplications de travail. Les préparateurs sont disponibles dans tools/tradefederation/core/src/com/android/tradefed/targetprep/ .
Configuration XML
La balise d'objet est target_preparer , par exemple :
<target_preparer class="com.android.tradefed.targetprep.InstallApkSetup">
<option name="install-arg" value="-d"/>
</target_preparer>
Reportez-vous également à Configurer les suites pour connaître le contexte.
Configuration de niveau supérieur
S'il est spécifié dans une configuration de niveau supérieur, le préparateur ne s'exécute qu'une seule fois pour chaque appareil. Un exemple est cts-common.xml , qui est une configuration de niveau supérieur pour les tests CTS (Android Compatibility Test Suite).
Configuration au niveau du module
S'il est spécifié au niveau du module, le préparateur s'exécute toujours avant ce module. Un exemple est backup/AndroidTest.xml , qui définit comment Tradefed exécute le module CTS backup .
Notez que même si le préparateur s'exécute avant le module, il s'exécute après tous les vérificateurs d'état du système .