ITargetPreparer

public interface ITargetPreparer
implements IDisableable

com.android.tradefed.targetprep.ITargetPreparer

Znane podklasy pośrednie AdbStopServerPreparer , AllTestAppsInstallSetup , AoaTargetPreparer , AppSetup , ArtChrootPreparer , BaseEmulatorPreparer , BaseTargetPreparer , BuildInfoRecorder , CheckPairingPreparer , CompanionAllocator , CompanionAwarePreparer , CompanionRunCommandTargetPreparer , CompanionTestAppInstallSetup , CompileBootImageWithSpeedTargetPreparer , CpuThrottlingWaiter , and 68 others. AdbStopServerPreparer Przygotowujący docelowy, aby zatrzymać serwer adb na hoście przed i po uruchomieniu testów adb. AllTestAppsInstallSetup ITargetPreparer , który instaluje wszystkie aplikacje z IDeviceBuildInfo#getTestsDir() na urządzeniu. AoaTargetPreparer ITargetPreparer , który wykonuje szereg akcji (np. kliknięć i przeciągnięć) przy użyciu protokołu Android Open Accessory (AOAv2). Konfiguracja aplikacji ITargetPreparer , który instaluje apk i jego testy. ArtChrootPreparer Utwórz katalog chroot do testów ART. BaseEmulatorPreparer Wspólny program przygotowujący do uruchomienia lokalnego emulatora. Przygotowujący cel podstawowy Podstawowa klasa implementacji dla ITargetPreparer , która pozwala kontrolować, czy obiekt jest wyłączony, czy nie. BuildInfoRecorder ITargetPreparer , który zapisuje metadane informacji o kompilacji w określonym pliku. SprawdźPairingPreparer CompanionAwarePreparer , który weryfikuje powiązanie BT między urządzeniami podstawowymi i towarzyszącymi Towarzysz Alokator Klasa podstawowa, która zajmuje się przydzielaniem i zwalnianiem urządzenia towarzyszącego getCompanionDeviceSelectionOptions() należy zaimplementować, aby opisać kryteria potrzebne do przydzielenia urządzenia towarzyszącego CompanionAwarePreparer ITargetPreparer , który hermetyzuje logikę pobierania już przydzielonego urządzenia towarzyszącego. CompanionRunCommandTargetPreparer ITargetPreparer , który uruchamia określone polecenia na przydzielonym urządzeniu towarzyszącym CompanionTestAppInstallSetup ITargetPreparer , który instaluje co najmniej jedną aplikację z IDeviceBuildInfo#getTestsDir() na przydzielonym urządzeniu towarzyszącym. CompileBootImageWithSpeedTargetPreparer Rekompiluje ścieżkę klasy startowej i serwer systemowy z filtrem kompilatora „speed”. Procesor Przepustowość Kelner ITargetPreparer , który czeka, aż maksymalna częstotliwość na wszystkich rdzeniach zostanie przywrócona do najwyższego dostępnego poziomu UtwórzAvdPreparer Utwórz UserPreparer Przygotowujący cel do stworzenia użytkownika i oczyszczenia go na końcu. DeviceBuildInfoBootStrapper ITargetPreparer , który zastępuje pola informacji o kompilacji atrybutami odczytanymi z urządzenia Jest to przydatne do testowania urządzeń z kompilacjami wygenerowanymi z zewnętrznego źródła (np DeviceBuildInfoInjector ITargetPreparer , który wstawia metadane DeviceBuildDescriptor do IBuildInfo . Urządzenie do czyszczenia Wykonuje ponowne uruchomienie lub formatowanie jako czynność czyszczenia po teście i opcjonalnie wyłącza ekran Urządzenie FlashPreparer ITargetPreparer , który miga obraz na fizycznym sprzęcie z systemem Android. DeviceImageZipFlashingTargetPreparer Przygotowujący cel, który flashuje urządzenie obrazami urządzenia dostarczonymi w określonym formacie. Właściciel urządzeniaTargetPreparer ITargetPreparer , który konfiguruje składnik właściciela urządzenia. Konfiguracja urządzenia ITargetPreparer , który konfiguruje urządzenie do testowania na podstawie dostarczonych Option . DeviceStorage Filler Docelowy przyrząd przygotowujący, aby zapełnić pamięć, aby dostępna była pewna ilość wolnego miejsca. UrządzenieStringPusher Przygotowujący docelowy, aby zapisać ciąg do pliku. Urządzenie docelowe aktualizacji urządzenia Abstrakcyjny ITargetPreparer , który zajmuje się typowymi czynnościami związanymi z aktualizowaniem urządzeń za pomocą pliku obrazu urządzenia ze źródła zewnętrznego (w przeciwieństwie do usługi kompilacji). DeviceWiper ITargetPreparer , który czyści dane użytkownika Wyłącz SELinuxTargetPreparer Przygotowujący obiekt docelowy, który wyłącza SELinux, jeśli jest włączony. Przygotowujący system dynamiczny ITargetPreparer , który konfiguruje obraz systemu na kompilacji urządzenia z dynamiczną aktualizacją systemu. Usuń narzędzie do przygotowania danych użytkownika ITargetPreparer , który czyści dane użytkownika na urządzeniu. FastbootCommandPreparer Przygotowujący cel, który uruchamia fastboot i wysyła polecenia fastboot. FastbootUpdateBootstrapPreparer ITargetPreparer , który przygotowuje określone pliki (program ładujący, radio, plik zip obrazu urządzenia) do IDeviceBuildInfo , aby uzyskać urządzenia flashowane za pomocą FastbootDeviceFlasher , a następnie wstrzykuje atrybuty urządzenia po uruchomieniu do informacji o kompilacji w celu raportowania wyników. FeatureFlagTargetPreparer Aktualizuje DeviceConfig (flagi funkcji dostrojone przez usługę zdalną). Przygotowujący tryb składania Przygotowujący cel, który może przełączyć stan składania urządzenia. Wygaszacz folderów ITargetPreparer , który ściąga katalogi z urządzenia, kompresuje je i zapisuje w zapleczu logowania. GkiDeviceFlashPreparer Docelowy program przygotowawczy, który flashuje urządzenie za pomocą ogólnego obrazu jądra systemu Android. GsiDeviceFlashPreparer Docelowy program przygotowawczy, który flashuje urządzenie z ogólnym obrazem systemu Android. ILabPreparer Interfejs markera dla osób przygotowujących laboratorium Zobacz ITargetPreparer , aby uzyskać opis, do czego te interfejsy są przeznaczone. ITargetCleaner Ten interfejs jest przestarzały. tearDown został przeniesiony do bazowego interfejsu ITargetPreparer. InstallAllTestZipAppsSetup ITargetPreparer , który instaluje wszystkie aplikacje w testowym pliku zip. InstallApexModuleTargetPreparer InstallApkSetup ITargetPreparer , który instaluje jeden lub więcej apków znajdujących się w systemie plików. InstallBuildEnvApkSetup ITargetPreparer , który instaluje co najmniej jeden testowy pakiet apk z środowiska kompilacji platformy Android. Przygotowujący oprzyrządowanie ITargetPreparer , który uruchamia oprzyrządowanie KillExistingEmulatorPreparer ITargetPreparer , który zamyka uruchomiony emulator. Znany Przygotowujący Awarię Docelowy program przygotowujący, aby pominąć ponawianie próby znanego niepowodzenia. Uruchomienie emulatora lokalnego TargetPreparer, który uruchamia emulator lokalnie ze środowiska kompilacji systemu Android. Migawka lokalnego emulatora TargetPreparer przeznaczony do generowania czystej migawki emulatora ze środowiska kompilacji/rozwoju Androida ModułOemTargetPreparer NativeLeakCollector ITargetPreparer , który uruchamia "dumpsys meminfo --unreachable -a" w celu zidentyfikowania nieosiągalnej pamięci natywnej aktualnie przechowywanej przez każdy proces. Brak apkTestSkipper Specjalny program przygotowujący, który pozwala całkowicie pominąć wywołanie (przygotowanie i testy) w przypadku braku apków do testów. PerfettoPreparer Przygotowujący Perfetto przesyła plik konfiguracyjny do urządzenia w standardowej lokalizacji, do której ma dostęp perfetto. PushFileInvoker Ta klasa jest przestarzała. Zamiast tego użyj PushFilePreparer PushFilePreparer ITargetPreparer , który próbuje wypchnąć dowolną liczbę plików z dowolnej ścieżki hosta do dowolnej ścieżki urządzenia. PythonVirtualenvPreparer Konfiguruje środowisko wirtualne Pythona na hoście i instaluje pakiety. RebootTargetPreparer Przygotowujący cel, który ponownie uruchamia urządzenie. Przygotowywanie dziennika odzyskiwania Docelowy program przygotowujący używany do zbierania dzienników przed odzyskaniem. UsuńSystemAppPreparer ITargetPreparer do usuwania apk z partycji systemowej przed uruchomieniem testowym. RestartSystemServerTargetPreparer Przygotowujący obiekt docelowy, który ponownie uruchamia serwer systemowy bez ponownego uruchamiania urządzenia. Przygotowujący główny cel Przygotowujący obiekt docelowy, który wykonuje „adb root” lub „adb unroot” na podstawie opcji „force-root”. RunCommandTargetPreparer RunHostCommandTargetPreparer Docelowy program przygotowujący do uruchamiania dowolnych poleceń hosta przed i po uruchomieniu testu. RunHostScriptTargetPreparer Przygotowujący cel, który wykonuje skrypt przed uruchomieniem testu. RunOnSdkSandboxTargetPreparer ITargetPreparer oznaczający, że testy powinny być uruchamiane w piaskownicy sdk. Uruchom na drugim etapie przygotowania użytkownika docelowego ITargetPreparer , który tworzy drugorzędnego użytkownika w konfiguracji i oznacza, że ​​testy powinny być uruchamiane na tym użytkowniku. RunOnSystemUserTargetPreparer ITargetPreparer , który oznacza, że ​​testy powinny być uruchamiane na użytkowniku (a nie na bieżącym użytkowniku). RunOnWorkProfileTargetPreparer ITargetPreparer , który tworzy profil do pracy w konfiguracji i oznacza, że ​​testy powinny być uruchamiane na tym użytkowniku. SemaphoreTokenTargetPreparer Jest to program przygotowujący używany do użycia tokena do serializacji wykonania testu na hoście z zasilaniem handlowym. SideloadOtaTargetPreparer Przygotowujący docelowy, który wykonuje sideload określonego pakietu OTA, stosuje pakiet, czeka na uruchomienie urządzenia i wstrzykuje właściwości kompilacji urządzenia do użycia jako informacje o kompilacji Ten program przygotowujący miejsce docelowe zakłada, że ​​urządzenie będzie działać w zwykłym trybie adb po uruchomieniu i zapewni, że urządzenie zakończy pracę w tym samym trybie, ale z zastosowaną nowszą kompilacją. ZatrzymajUsługiKonfiguracja ITargetPreparer , który zatrzymuje usługi na urządzeniu. Przygotowujący obiekt docelowy Pusta implementacja elementu ITargetPreparer . Instalator aplikacji Suite Instaluje określone pliki APK do konfiguracji pakietu: ze zmiennej $ANDROID_TARGET_OUT_TESTCASES lub ROOT_DIR w informacjach o kompilacji. Przełącz użytkownikaTargetPreparer ITargetPreparer , który przełącza się na określony rodzaj użytkownika w konfiguracji. TearDownPassThroughPreparer Umożliwia uruchamianie rozkładania na narzędziach przygotowujących, które są uwzględnione w konfiguracji jako obiekt. Przepustnica temperaturyKelner ITargetPreparer , który czeka, aż temperatura urządzenia spadnie do wartości docelowej Ustawienia instalacji aplikacji testowej ITargetPreparer , który instaluje co najmniej jedną aplikację z folderu IDeviceBuildInfo.getTestsDir() na urządzeniu. TestFilePushSetup ITargetPreparer , który wypycha jeden lub więcej plików/katalogów z folderu IDeviceBuildInfo.getTestsDir() na urządzenie. Konfiguracja instalacji aplikacji systemu testowego ITargetPreparer , który instaluje co najmniej jedną aplikację z folderu IDeviceBuildInfo.getTestsDir() na partycji /system na urządzeniu. Coś co marnuje czas Prosty program do przygotowania celu, który pozwala marnować czas i potencjalnie ponownie uruchamiać urządzenie. UserCleaner ITargetPreparer , który usuwa drugorzędnych użytkowników podczas rozkładania. WaitForDeviceDatetimePreparer ITargetPreparer , który czeka na ustawienie daty i godziny na urządzeniu Opcjonalnie ten przygotowujący może wymusić TargetSetupError , jeśli data/godzina nie jest ustawiona w ramach limitu czasu, lub wymusić datę i godzinę hosta na urządzeniu, WifiPreparer ITargetPreparer , który w razie potrzeby konfiguruje Wi-Fi na urządzeniu.

---

Przygotowuje środowisko testowe do uruchomienia testowego.

Na przykład instaluje oprogramowanie, modyfikuje ustawienia środowiska do testowania, uruchamia cele itp.

Należy zauważyć, że w konfiguracji można określić wiele ITargetPreparer . Zaleca się, aby każdy element ITargetPreparer jasno udokumentował oczekiwaną konfigurację środowiska przed i po konfiguracji. np. ITargetPreparer konfigurujący urządzenie do testowania musi być uruchamiany po ITargetPreparer, który instaluje oprogramowanie.

Streszczenie

Metody publiczne
default void	setUp ( ITestDevice device, IBuildInfo buildInfo) Ta metoda jest przestarzała. Zamiast tego użyj setUp(com.android.tradefed.invoker.TestInformation)
default void	setUp ( TestInformation testInformation) Wykonaj docelową konfigurację do testowania.
default void	tearDown ( TestInformation testInformation, Throwable e) Po przetestowaniu wykonaj docelowe czyszczenie/usuwanie.
default void	tearDown ( ITestDevice device, IBuildInfo buildInfo, Throwable e) Ta metoda jest przestarzała. Zamiast tego użyj tearDown(com.android.tradefed.invoker.TestInformation, Throwable)

Metody publiczne

organizować coś

public void setUp (ITestDevice device, 
                IBuildInfo buildInfo)

Ta metoda jest przestarzała.
Zamiast tego użyj setUp(com.android.tradefed.invoker.TestInformation)

Wykonaj docelową konfigurację do testowania.

Parametry
device	ITestDevice : ITestDevice do przygotowania.
buildInfo	IBuildInfo : dane o testowanej kompilacji.

Rzuty
TargetSetupError	jeśli wystąpił błąd krytyczny podczas konfigurowania środowiska
BuildError	Jeśli wystąpi błąd związany z BuildInfo
DeviceNotAvailableException	jeśli urządzenie przestało odpowiadać

organizować coś

public void setUp (TestInformation testInformation)

Wykonaj docelową konfigurację do testowania.

Parametry
testInformation	TestInformation : TestInformation wywołania.

Rzuty
TargetSetupError	jeśli wystąpił błąd krytyczny podczas konfigurowania środowiska
BuildError	Jeśli wystąpi błąd z powodu przygotowywanej kompilacji
DeviceNotAvailableException	jeśli urządzenie przestało odpowiadać

zburzyć

public void tearDown (TestInformation testInformation, 
                Throwable e)

Po przetestowaniu wykonaj docelowe czyszczenie/usuwanie.

Parametry
testInformation	TestInformation : TestInformation wywołania.
e	Throwable : jeśli wywołanie zakończyło się wyjątkiem, będzie to wyjątek przechwycony na poziomie wywołania. W przeciwnym razie będzie null .

Rzuty
DeviceNotAvailableException	jeśli urządzenie przestało odpowiadać

zburzyć

public void tearDown (ITestDevice device, 
                IBuildInfo buildInfo, 
                Throwable e)

Ta metoda jest przestarzała.
Zamiast tego użyj tearDown(com.android.tradefed.invoker.TestInformation, Throwable)

Po przetestowaniu wykonaj docelowe czyszczenie/usuwanie.

Parametry
device	ITestDevice : ITestDevice do przygotowania.
buildInfo	IBuildInfo : dane o testowanej kompilacji.
e	Throwable : jeśli wywołanie zakończyło się wyjątkiem, będzie to wyjątek przechwycony na poziomie wywołania. W przeciwnym razie będzie null .

Rzuty
DeviceNotAvailableException	jeśli urządzenie przestało odpowiadać