Przygotowywanie docelowych danych jest wywoływane przed testami na poziomie testu, na którym są zdefiniowane. Umożliwia to skonfigurowanie dowolnego urządzenia do 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 wykonaniu testu.
Klasa BaseTargetPreparer rozszerza też klasę 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. Dzięki temu można łatwiej ponownie użyć narzędzia do przygotowywania.
Zanim dodasz nowego autora, sprawdź listę dostępnych autorów, aby uniknąć powielania pracy. Przygotowują je osoby z kraju 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
Jeśli jest to określone w ustawieniach na najwyższym poziomie, narzędzie do przygotowywania jest uruchamiane tylko raz na każde urządzenie. Przykładem jest cts-common.xml, czyli konfiguracja najwyższego poziomu dla testów Compatibility Test Suite (CTS) na Androida.
Konfiguracja na poziomie modułu
Jeśli jest określony na poziomie modułu, zawsze jest wykonywany przed tym modułem. Przykładem jest plik 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.