Les préparateurs de cible 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 s'exécutent correctement.
Interface de base
L'interface de base est
ITargetPreparer,
qui permet d'exécuter 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 de nettoyage
L'extension naturelle de setUp est tearDown, qui est fournie par une interface différente
,
ITargetCleaner. Elle 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.
Consultez également la liste des préparateurs disponibles avant d'en ajouter un pour éviter de dupliquer le 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>
Consultez également la section Configurer des suites pour le contexte.
Configuration de premier niveau
S'il est spécifié dans une configuration de premier niveau, le préparateur ne s'exécute qu'une seule fois pour chaque appareil. cts-common.xml en est un exemple. Il s'agit d'une configuration de premier niveau pour les tests de la Compatibility Test Suite Android (CTS).
Configuration au niveau du module
S'il est spécifié au niveau du module, le préparateur s'exécute toujours avant ce module.
backup/AndroidTest.xml en est un exemple. Il définit comment 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 vérificateurs d'état du système.