Obiekty do przygotowywania danych są wywoływane przed testami na poziomie testu, na którym są zdefiniowane. Umożliwia to skonfigurowanie dowolnego urządzenia w celu płynnego przeprowadzania testów.
Interfejs podstawowy
Interfejs podstawowy to ITargetPreparer, który umożliwia wykonanie metody setUp. Zalecamy wdrożenie podstawowej abstrakcyjnej klasy BaseTargetPreparer, która zawiera funkcję wyłączania, dzięki której można łatwo wyłączyć przygotowywanie.
Czystszy interfejs
Naturalnym rozszerzeniem usługi setUp jest usługa tearDown, która jest dostępna w ramach innego interfejsu, ITargetCleaner. Umożliwia to korzystanie z interfejsu tearDown, który pozwala usunąć wszystko, co zostało wykonane w ramach setUp po zakończeniu testu.
Klasa BaseTargetPreparer rozszerza też zakres ITargetCleaner.
Rekomendacje
Zalecamy, aby każdy przygotowujący miał dostęp tylko do jednej głównej funkcji, np. do instalowania pliku APK lub wykonywania polecenia. Ułatwia to ponowne wykorzystanie osób przygotowawczych.
Przed dodaniem nowego autora sprawdź też listę dostępnych autorów, aby uniknąć powielania pracy. Materiały przygotowujące są dostępne w: tools/tradefederation/core/src/com/android/tradefed/targetprep/.
Konfiguracja XML
Tag obiektu to target_preparer, na przykład:
<target_preparer class="com.android.tradefed.targetprep.InstallApkSetup">
<option name="install-arg" value="-d"/>
</target_preparer>
Aby uzyskać więcej informacji, zapoznaj się też z artykułem Konfigurowanie pakietów.
Konfiguracja na najwyższym poziomie
W przypadku ustawienia najwyższego poziomu narzędzie przygotowujące jest uruchamiane tylko raz na każdym urządzeniu. Przykładem może być cts-common.xml, czyli konfiguracja najwyższego poziomu do testów zgodności z Androidem Compatibility Test Suite (CTS).
Konfiguracja na poziomie modułu
Jeśli jest określony na poziomie modułu, zawsze jest wykonywany przed tym modułem. Przykładem jest backup/AndroidTest.xml, który określa sposób działania modułu backup CTS w Tradefed.
Pamiętaj, że chociaż narzędzie do przygotowania jest uruchamiane przed modułem, uruchamia się po sprawdzaniu stanu systemu.