Od 27 marca 2025 r. zalecamy używanie android-latest-release zamiast aosp-main do kompilowania i wspołtworzenia AOSP. Więcej informacji znajdziesz w artykule o zmianach w AOSP.

Ta strona została przetłumaczona przez Cloud Translation API.

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 i 76 inne.

AdbStopServerPreparer	Użyj narzędzia do przygotowywania docelowego, aby zatrzymać serwer adb na hoście przed i po wykonaniu testów adb.
AllTestAppsInstallSetup	`ITargetPreparer`, który instaluje na urządzeniu wszystkie aplikacje z folderu `IDeviceBuildInfo.getTestsDir()`.
AoaTargetPreparer	`ITargetPreparer`, który wykonuje serię działań (np. kliknięć i przesuń) za pomocą protokołu Android Open Accessory (AOAv2).
AppSetup	`ITargetPreparer`, który instaluje plik APK i jego testy.
ArtChrootPreparer	Utwórz katalog chroot na potrzeby testów ART.
BaseEmulatorPreparer	Wspólny program do uruchamiania lokalnego emulatora.
BaseTargetPreparer	Podstawowa klasa implementacji obiektu `ITargetPreparer`, która umożliwia określenie, czy obiekt ma być wyłączony.
BuildInfoRecorder	`ITargetPreparer`, który zapisuje metadane informacji o kompilacji w określonym pliku.
CheckPairingPreparer	`CompanionAwarePreparer`, który weryfikuje parowanie BT między urządzeniem głównym a urządzeniem dodatkowym.
CompanionAllocator	Klasa bazowa, która zajmuje się przydzielaniem i zwalnianiem urządzenia towarzyszącego Aby opisać kryteria potrzebne do przydzielenia urządzenia towarzyszącego, należy zaimplementować element `getCompanionDeviceSelectionOptions()`.
CompanionAwarePreparer	`ITargetPreparer`, który zawiera logikę uzyskiwania już przypisanego urządzenia towarzyszącego.
CompanionRunCommandTargetPreparer	`ITargetPreparer`, który wykonuje określone polecenia na przypisanym urządzeniu towarzyszącym.
CompanionTestAppInstallSetup	`ITargetPreparer`, który instaluje co najmniej jedną aplikację z folderu `IDeviceBuildInfo.getTestsDir()` na przypisanym urządzeniu towarzyszącym.
CompileBootImageWithSpeedTargetPreparer	Ponowne skompilowanie ścieżki klas rozruchu i serwera systemu za pomocą filtra kompilatora „speed”.
CpuThrottlingWaiter	`ITargetPreparer`, który czeka, aż maksymalna częstotliwość na wszystkich rdzeniach zostanie przywrócona do najwyższego dostępnego poziomu.
CreateAvdPreparer
CreateUserPreparer	Przygotuj docelowy program do tworzenia użytkownika i oczyszczania go na koniec.
DeviceActionTargetPreparer	`ITargetPreparer` do wykonywania działań na urządzeniu.
DeviceBuildInfoBootStrapper	`ITargetPreparer`, który zastępuje pola informacji o kompilacji atrybutami odczytanymi z urządzenia. Jest to przydatne podczas testowania urządzeń z kompilacją wygenerowaną z zewnętrznego źródła (np.
DeviceBuildInfoInjector	`ITargetPreparer`, który wstawia metadane `DeviceBuildDescriptor` do `IBuildInfo`.
DeviceCleaner	Po zakończeniu testu wykonuje ponowne uruchomienie lub formatowanie jako działanie czyszczące, a opcjonalnie wyłącza ekran.
DeviceFlashPreparer	`ITargetPreparer`, który wyświetla obraz na fizycznym sprzęcie z Androidem.
DeviceImageZipFlashingTargetPreparer	Narzędzie do przygotowywania danych docelowych, które flashuje urządzenie za pomocą obrazów urządzeń dostarczonych w określonym formacie.
DeviceOwnerTargetPreparer	`ITargetPreparer`, który konfiguruje komponent właściciela urządzenia.
DeviceSetup	`ITargetPreparer`, który konfiguruje urządzenie do testowania na podstawie podanych `Option`.
DeviceStorageFiller	Ustaw wartość docelową na wypełnienie pamięci, aby zwolnić trochę miejsca.
DeviceStringPusher	Ustawienie docelowego narzędzia do przygotowywania danych, które ma zapisać ciąg znaków do pliku.
DeviceUpdateTargetPreparer	abstraktna `ITargetPreparer`, która obsługuje typowe czynności związane z aktualizowaniem urządzeń za pomocą pliku obrazu urządzenia pochodzącego ze źródła zewnętrznego (w przeciwieństwie do usługi kompilacji).
DeviceWiper	`ITargetPreparer`, który czyści dane użytkownika.
DisableSELinuxTargetPreparer	Usługa przygotowywania docelowego, która wyłącza SELinux, jeśli jest włączona.
DynamicSystemPreparer	`ITargetPreparer`, który konfiguruje obraz systemu na kompilacji urządzenia za pomocą dynamicznej aktualizacji systemu.
EraseUserDataPreparer	`ITargetPreparer`, który czyści dane użytkownika na urządzeniu.
FastbootCommandPreparer	Przygotowywanie docelowego urządzenia, które uruchamia fastboot i wysyła polecenia fastboot.
FastbootUpdateBootstrapPreparer	`ITargetPreparer`, który umieszcza określone pliki (bootloader, radio, obraz urządzenia ZIP) w `IDeviceBuildInfo`, aby umożliwić flashowanie urządzeń za pomocą `FastbootDeviceFlasher`, a następnie wstrzykuje atrybuty urządzenia po uruchomieniu w informacjach o kompilacji na potrzeby raportowania wyników.
FeatureFlagTargetPreparer	Aktualizuje DeviceConfig (flagi funkcji dostosowane przez usługę zdalną).
FoldableModePreparer	Obiekt przygotowujący docelowy, który może przełączać stan składania urządzenia.
FolderSaver	`ITargetPreparer`, który pobiera katalogi z urządzenia, kompresuje je i zapisuje w logach na zapleczu.
GkiDeviceFlashPreparer	Narzędzie do przygotowywania urządzeń do wgrania na nie ogólnego obrazu jądra Androida.
GsiDeviceFlashPreparer	Narzędzie do przygotowywania urządzeń docelowych, które flashuje urządzenie za pomocą ogólnego obrazu systemu Android.
ILabPreparer	Interfejs markera dla przygotowujących laboratorium Opis tych interfejsów znajdziesz w artykule `ITargetPreparer`.
ITargetCleaner	Ten interfejs został wycofany. Metoda tearDown została przeniesiona do podstawowego interfejsu ITargetPreparer.
InstallAllTestZipAppsSetup	`ITargetPreparer`, który instaluje wszystkie aplikacje w pliku ZIP z testami.
InstallApexModuleTargetPreparer
InstallApkSetup	`ITargetPreparer`, który instaluje co najmniej 1 plik APK znajdujący się w systemie plików.
InstallBuildEnvApkSetup	`ITargetPreparer`, który instaluje co najmniej 1 testowy plik APK z otoczenia kompilacji na platformie Android.
InstallKernelModulePreparer	Przygotowywanie docelowego modułu, który instaluje moduły jądra.
InstrumentationPreparer	`ITargetPreparer`, który wykonuje instrumentację.
KillExistingEmulatorPreparer	`ITargetPreparer`, który wyłącza uruchomiony emulator.
KnownFailurePreparer	Ustawienie docelowego przygotowującego, aby pominąć ponowne próby po wystąpieniu znanego błędu.
LocalEmulatorLaunch	Narzędzie TargetPreparer, które uruchamia emulator lokalnie z otoczenia kompilacji Androida.
LocalEmulatorSnapshot	Narzędzie TargetPreparer służące do generowania czystego zrzutu ekranu emulatora z Androida w środowisku kompilacji/tworzenia.
MixKernelTargetPreparer	`ITargetPreparer`, który umożliwia łączenie obrazu jądra z obrazem urządzenia.
ModuleOemTargetPreparer
NativeLeakCollector	`ITargetPreparer`, który wykonuje polecenie „dumpsys meminfo --unreachable -a”, aby zidentyfikować niedostępną pamięć natywną obecnie używaną przez każdy proces.
NoApkTestSkipper	Specjalny program przygotowujący, który pozwala całkowicie pominąć wywołanie (przygotowanie i testy), jeśli nie ma plików APK do testów.
PerfettoPreparer	Narzędzie do przygotowywania danych do przesyłania do perfetto przesyła plik konfiguracji na urządzenie w standardowej lokalizacji, do której ma dostęp.
ProfileTargetPreparer	Podstawowa klasa do konfigurowania przygotowującego docelowego dla dowolnego użytkownika profilu `android.os.usertype.profile.XXX`.
PushFileInvoker	Ta klasa została wycofana. Użyj w zamian `PushFilePreparer`
PushFilePreparer	`ITargetPreparer`, który próbuje przesłać 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	Ustaw wykonawcę, który uruchamia ponownie urządzenie.
RecoveryLogPreparer	Użytkownik przygotowujący docelowy używał tego pliku do zbierania dzienników przed przywróceniem.
RemoveSystemAppPreparer	`ITargetPreparer` do usuwania pliku APK z partycji systemowej przed uruchomieniem testu.
RestartSystemServerTargetPreparer	Urządzenie do przygotowywania, które uruchamia ponownie serwer systemu bez restartowania urządzenia.
RootTargetPreparer	Narzędzie do przygotowywania docelowego, które wykonuje polecenie „adb root” lub „adb unroot” na podstawie opcji „force-root”.
RootcanalForwarderPreparer
RunCommandTargetPreparer
RunHostCommandTargetPreparer	Ustaw docelowego przygotowującego, aby przed i po wykonaniu testu mógł on uruchamiać dowolne polecenia gospodarza.
RunHostScriptTargetPreparer	Przygotowanie docelowego, które wykonuje skrypt przed uruchomieniem testu.
RunOnCloneProfileTargetPreparer
RunOnPrivateProfileTargetPreparer
RunOnSdkSandboxTargetPreparer	`ITargetPreparer` oznacza, że testy powinny być uruchamiane w piaskownicy SDK.
RunOnSecondaryUserTargetPreparer	`ITargetPreparer`, aby mieć pewność, że test jest przeprowadzany przez dodatkowego użytkownika.
RunOnSystemUserTargetPreparer	`ITargetPreparer` oznaczający, że testy powinny być przeprowadzane na użytkowniku (a nie na bieżącym użytkowniku).
RunOnWorkProfileTargetPreparer	`ITargetPreparer`, który tworzy profil służbowy w ramach konfiguracji i oznacza, że testy powinny być uruchamiane na tym użytkowniku.
SemaphoreTokenTargetPreparer	To jest obiekt przygotowujący, który służy do używania tokena do serializacji wykonania testu w hostie tradefed.
SideloadOtaTargetPreparer	Przygotowuje docel, który umożliwia przesyłanie boczne określonego pakietu OTA, stosuje go, czeka na uruchomienie urządzenia i wstrzykuje właściwości kompilacji urządzenia do użycia jako informacje o kompilacji. Ten przygotowawczy program docelowy zakłada, że po uruchomieniu urządzenie będzie w zwykłym trybie adb, i zapewni, że urządzenie wyjdzie z tego trybu, ale z zastosowaniem nowszej wersji.
StopServicesSetup	`ITargetPreparer`, który zatrzymuje usługi na urządzeniu.
StubTargetPreparer	Obiekt zastępczy pustej implementacji `ITargetPreparer`.
SuiteApkInstaller	Instaluje określone pliki APK dla konfiguracji pakietu: z użyciem zmiennej $ANDROID_TARGET_OUT_TESTCASES lub katalogu ROOT_DIR w informacjach o kompilacji.
SwitchUserTargetPreparer	`ITargetPreparer`, który w metodzie setup przełącza się na określony typ użytkownika.
TearDownPassThroughPreparer	Umożliwia uruchamianie funkcji tearDown w przypadku przygotowujących, które są uwzględnione w konfiguracji jako obiekt.
TemperatureThrottlingWaiter	`ITargetPreparer`, który czeka, aż temperatura urządzenia spadnie do wartości docelowej.
TestAppInstallSetup	`ITargetPreparer`, który instaluje co najmniej jedną aplikację z folderu `IDeviceBuildInfo.getTestsDir()` na urządzeniu.
TestFilePushSetup	`ITargetPreparer`, który przesyła co najmniej 1 plik lub 1 katalog z folderu `IDeviceBuildInfo.getTestsDir()` na urządzenie.
Testowanie konfiguracji instalacji aplikacji systemowej	`ITargetPreparer`, który instaluje co najmniej jedną aplikację z folderu `IDeviceBuildInfo.getTestsDir()` na partycji /system na urządzeniu.
Marnotrawienie czasu	Prosty sposób na zmarnowanie czasu i możliwe ponowne uruchomienie urządzenia.
UserCleaner	`ITargetPreparer`, który usuwa użytkowników dodatkowych podczas rozwiązywania.
VisibleBackgroundUserPreparer	Przygotowanie docelowego dla przeprowadzania testów w ramach widocznego w tle procesu użytkownika.
WaitForDeviceDatetimePreparer	`ITargetPreparer`, która czeka na ustawienie daty i godziny na urządzeniu Opcjonalnie może wymusić `TargetSetupError`, jeśli data i godzina nie zostaną ustawione w czasie limitu.
WifiPreparer	`ITargetPreparer`, która w razie potrzeby konfiguruje Wi-Fi na urządzeniu.

Przygotowuje środowisko testowe do przeprowadzenia testu.

Na przykład instalowanie oprogramowania, dostosowywanie ustawień środowiska do testowania, uruchamianie celów itp.

Pamiętaj, że w konfiguracji można określić wiele wartości ITargetPreparer. Zalecamy, aby każdy ITargetPreparer wyraźnie dokumentował oczekiwane środowisko przed konfiguracją i po konfiguracji. Przykładowo ITargetPreparer, który konfiguruje urządzenie do testowania, musi być uruchomiony po ITargetPreparerze, który instaluje oprogramowanie.

Podsumowanie

Metody publiczne
`default void`	`setUp(ITestDevice device, IBuildInfo buildInfo)` Ta metoda została wycofana. Użyj w zamian `setUp(com.android.tradefed.invoker.TestInformation)`
`default void`	`setUp(TestInformation testInformation)` Przeprowadź konfigurację docelową na potrzeby testowania.
`default void`	`tearDown(TestInformation testInformation, Throwable e)` Po zakończeniu testowania wykonaj czyszczenie lub rozbiórkę docelowego środowiska.
`default void`	`tearDown(ITestDevice device, IBuildInfo buildInfo, Throwable e)` Ta metoda została wycofana. Użyj w zamian `tearDown(com.android.tradefed.invoker.TestInformation, Throwable)`

Metody publiczne

setUp

public void setUp (ITestDevice device, 
                IBuildInfo buildInfo)

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

Przeprowadź konfigurację docelową na potrzeby testowania.

Parametry
`device`	`ITestDevice`: `ITestDevice` do przygotowania.
`buildInfo`	`IBuildInfo`: dane o kompilacji testowanej w ramach testu.

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

setUp

public void setUp (TestInformation testInformation)

Przeprowadź konfigurację docelową na potrzeby testowania.

Parametry
`testInformation`	`TestInformation`: `TestInformation` wywołania.

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

tearDown

public void tearDown (TestInformation testInformation, 
                Throwable e)

Po zakończeniu testowania wykonaj czyszczenie lub rozbiórkę docelowego środowiska.

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 to `null`.

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

tearDown

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

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

Po zakończeniu testowania wykonaj czyszczenie lub rozbiórkę docelowego środowiska.

Parametry
`device`	`ITestDevice`: `ITestDevice` do przygotowania.
`buildInfo`	`IBuildInfo`: dane o kompilacji testowanej w ramach testu.
`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 to `null`.

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