Przygotowujący są wywoływani przed testami na poziomie testu , na którym są zdefiniowani. Umożliwia to skonfigurowanie dowolnego urządzenia do płynnego przeprowadzania testów.
Interfejs podstawowy
Interfejsem podstawowym jest
ITargetPreparer,
który umożliwia implementację metody setUp do wykonania. Zalecamy zaimplementowanie naszej podstawowej klasy abstrakcyjnej
BaseTargetPreparer,
która zapewnia wbudowaną funkcję wyłączania, aby łatwo wyłączyć przygotowującego.
Interfejs czyszczenia
Naturalnym rozszerzeniem setUp jest tearDown, który jest udostępniany przez inny
interfejs,
ITargetCleaner. Udostępnia on interfejs tearDown, który umożliwia wyczyszczenie wszystkiego, co zostało wykonane w setUp po zakończeniu testu.
Klasa BaseTargetPreparer rozszerza też ITargetCleaner.
Rekomendacje
Zalecamy, aby każdy przygotowujący był ograniczony do jednej głównej funkcji, np. instalowania APK lub uruchamiania polecenia. Umożliwia to łatwiejsze ponowne wykorzystanie przygotowujących.
Zanim dodasz nowego przygotowującego, sprawdź też listę dostępnych przygotowujących, aby uniknąć powielania pracy. Przygotowujący są dostępni 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>
Więcej informacji znajdziesz też w artykule Konfigurowanie pakietów.
Konfiguracja najwyższego poziomu
Jeśli przygotowujący jest określony w konfiguracji najwyższego poziomu, jest uruchamiany tylko raz na każdym urządzeniu. Przykładem jest
cts-common.xml,
który jest konfiguracją najwyższego poziomu dla testów pakietu CTS (Android Compatibility Test Suite).
Konfiguracja na poziomie modułu
Jeśli przygotowujący jest określony na poziomie modułu, jest zawsze uruchamiany przed tym modułem. Przykładem jest
backup/AndroidTest.xml,
który określa, jak Tradefed uruchamia moduł CTS backup.
Pamiętaj, że przygotowujący jest uruchamiany przed modułem, ale po wszystkich narzędziach do sprawdzania stanu systemu.