Les préparateurs de cibles sont appelés avant les tests du niveau de test dans lequel ils sont définis. Cela permet de configurer n'importe quel appareil pour que les tests s'exécutent facilement.
Interface de base
L'interface de base est ITargetPreparer, ce 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 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é effectué 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 autre pour éviter de dupliquer le travail. Des préparateurs sont disponibles dans tools/tradefederation/core/src/com/android/tradefed/targetprep/.
Configuration XML
La balise de l'objet est target_preparer, par exemple:
<target_preparer class="com.android.tradefed.targetprep.InstallApkSetup">
<option name="install-arg" value="-d"/>
</target_preparer>
Pour plus de contexte, consultez Configurer des suites.
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. cts-common.xml en est un exemple, car il s'agit d'une configuration de premier niveau pour les tests de la suite de tests de compatibilité Android (CTS).
Configuration au niveau du module
Si elle est spécifiée au niveau du module, le préparateur s'exécute toujours avant ce module. Par exemple, backup/AndroidTest.xml, qui définit la manière dont Tradefed exécute le module CTS backup.
Notez que bien que le préparateur s'exécute avant le module, il s'exécute après tous les outils de vérification de l'état du système.