W 2026 r., aby dostosować się do naszego modelu stabilnego rozwoju trunk i zapewnić stabilność platformy w ekosystemie, będziemy publikować kod źródłowy w AOSP w drugim i czwartym kwartale. Do tworzenia i współtworzenia AOSP używaj gałęzi android-latest-release. Gałąź manifestu android-latest-release będzie zawsze odwoływać się do najnowszej wersji przesłanej do AOSP. Więcej informacji znajdziesz w artykule Zmiany w AOSP.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

ITargetPreparer

public interface ITargetPreparer
implements IDisableable

com.android.tradefed.targetprep.ITargetPreparer

Znane podklasy pośrednie

AFlagsTargetPreparer, AdbStopServerPreparer, AllTestAppsInstallSetup, AoaTargetPreparer, AppSetup, ArtChrootPreparer, BaseEmulatorPreparer, BaseSwitchUserTargetPreparer, BaseSystemTestEnvPreparer, BaseTargetPreparer, BuildInfoRecorder, CheckPairingPreparer, CompanionAllocator, CompanionAwarePreparer, CompanionRunCommandTargetPreparer i 94 inne.

AFlagsTargetPreparer	Używa `aflags` do zastępowania flag przed uruchomieniem testu.
AdbStopServerPreparer	Przygotowanie docelowe do zatrzymania serwera adb na hoście przed i po uruchomieniu testów adb.
AllTestAppsInstallSetup	`ITargetPreparer`, która instaluje wszystkie aplikacje z folderu `IDeviceBuildInfo.getTestsDir()` na urządzeniu.
AoaTargetPreparer	`ITargetPreparer`, który wykonuje serię działań (np. kliknięć i przesunięć) 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	Typowy preparer do uruchamiania lokalnego emulatora.
BaseSwitchUserTargetPreparer	`ITargetPreparer`, która w funkcji setUp przełącza się na określony typ użytkownika.
BaseSystemTestEnvPreparer	Uruchamia ponownie środowisko testowe systemu podstawowego
BaseTargetPreparer	Podstawowa klasa implementacji dla `ITargetPreparer`, która umożliwia określenie, czy obiekt jest wyłączony.
BuildInfoRecorder	`ITargetPreparer`, który zapisuje metadane informacji o kompilacji w określonym pliku.
CheckPairingPreparer	`CompanionAwarePreparer`, która weryfikuje parowanie BT między urządzeniem podstawowym a urządzeniem towarzyszącym.
CompanionAllocator	Klasa bazowa, która zajmuje się przydzielaniem i zwalnianiem urządzenia towarzyszącego Należy wdrożyć parametr `getCompanionDeviceSelectionOptions()`, aby opisać kryteria wymagane do przypisania urządzenia towarzyszącego.
CompanionAwarePreparer	`ITargetPreparer`, który zawiera logikę pobierania już przydzielonego urządzenia towarzyszącego.
CompanionRunCommandTargetPreparer	`ITargetPreparer`, który wykonuje określone polecenia na przydzielonym urządzeniu towarzyszącym.
CompanionTestAppInstallSetup	`ITargetPreparer`, która instaluje co najmniej 1 aplikację z folderu `IDeviceBuildInfo.getTestsDir()` na przypisanym urządzeniu towarzyszącym.
CompatTargetPreparer	`ITargetPreparer`, który przygotowuje urządzenie do przeprowadzania testów zgodności.
CompileBootImageWithSpeedTargetPreparer	Ponownie kompiluje ścieżkę klas rozruchowych i serwer systemowy za pomocą filtra kompilatora „speed”.
CpuThrottlingWaiter	`ITargetPreparer`, która czeka, aż maksymalna częstotliwość na wszystkich rdzeniach zostanie przywrócona do najwyższego dostępnego poziomu.
CreateAvdPreparer
CreateUserPreparer	Przygotowanie miejsca docelowego do utworzenia użytkownika dodatkowego i jego usunięcia na koniec.
CrosDutTopologyPreparer	Przygotowujący, który uruchamia narzędzie dt-converter, aby wygenerować konfigurację testu i parametry testu.
CrosLsNexusPreparer	Przygotowujący, który uruchamia i zatrzymuje usługę LSNexus na urządzeniu z ChromeOS.
CtsSettingsSetup	`ITargetPreparer`, który konfiguruje ustawienia urządzenia w przygotowaniu do uruchomienia testów CTS.
DeviceActionTargetPreparer	`ITargetPreparer` wykonywać działania na urządzeniu.
DeviceBuildInfoBootStrapper	`ITargetPreparer`, który zastępuje pola informacji o kompilacji atrybutami odczytanymi z urządzenia. Jest to przydatne w przypadku testowania urządzeń z kompilacjami wygenerowanymi ze źródła zewnętrznego (np.
DeviceBuildInfoInjector	`ITargetPreparer`, który wstawia `DeviceBuildDescriptor` metadane do `IBuildInfo`.
DeviceCleaner	wykonuje ponowne uruchomienie lub formatowanie jako działanie czyszczące po teście i opcjonalnie wyłącza ekran;
DeviceFlashPreparer	`ITargetPreparer`, który wyświetla obraz na fizycznym urządzeniu z Androidem.
DeviceImageZipFlashingTargetPreparer	Przygotowujący urządzenie docelowe, który przesyła do niego obrazy w określonym formacie.
DeviceOwnerTargetPreparer	Obiekt `ITargetPreparer`, który konfiguruje komponent właściciela urządzenia.
DeviceSetup	`ITargetPreparer`, który konfiguruje urządzenie do testowania na podstawie podanych `Option`.
DeviceStorageFiller	Przygotuj urządzenie docelowe, aby zapełnić pamięć, tak aby było dostępne trochę wolnego miejsca.
DeviceStringPusher	Przygotowanie urządzenia docelowego do zapisania ciągu znaków w pliku.
DeviceUpdateTargetPreparer	Abstrakcyjny element `ITargetPreparer`, który wykonuje typowe czynności związane 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óra usuwa dane użytkownika.
DexMetadataExtractor	Instaluje pliki metadanych Dex dla określonych plików APK.
DisableSELinuxTargetPreparer	Przygotowujący urządzenie docelowe, który wyłącza SELinux, jeśli jest włączony.
DynamicSystemPreparer	`ITargetPreparer`, który konfiguruje obraz systemu na podstawie kompilacji urządzenia za pomocą dynamicznej aktualizacji systemu.
EhideTargetPreparer	Uruchamia ehide, który ukrywa interfejs Ethernet przed stosem sieciowym Androida.
EraseUserDataPreparer	`ITargetPreparer`, która usuwa dane użytkowników z urządzenia.
FastbootCommandPreparer	Przygotowanie urządzenia docelowego, które wywołuje fastboot i wysyła polecenia fastboot.
FastbootUpdateBootstrapPreparer	`ITargetPreparer`, który przenosi określone pliki (program rozruchowy, radio, obraz urządzenia w formacie ZIP) do `IDeviceBuildInfo`, aby wgrać na urządzenia `FastbootDeviceFlasher`, a następnie wstawia atrybuty urządzenia po uruchomieniu do informacji o kompilacji na potrzeby raportowania wyników.
FeatureFlagTargetPreparer	Ta klasa została wycofana. Użyj w zamian zasady `AFlagsTargetPreparer`.
FoldableModePreparer	Przygotowujący element docelowy, który może zmieniać stan urządzenia składanego.
FolderSaver	`ITargetPreparer`, który pobiera katalogi z urządzenia, kompresuje je i zapisuje w backendzie logowania.
FutilityCommandPreparer	Przygotowanie do wykonania poleceń bezużytecznych.
GkiDeviceFlashPreparer	Przygotowujący urządzenie docelowe, który flashuje urządzenie za pomocą ogólnego obrazu jądra systemu Android.
GoogleAccountPreparer	`ITargetPreparer`, który obsługuje konfigurowanie kont Google.
GoogleAppsSetup	`ITargetPreparer`, który obsługuje różne opcje konfiguracji aplikacji Google. Uwaga: najpierw musisz skonfigurować konto na urządzeniu. Zobacz `GoogleAccountPreparer`
GoogleDeviceFlashPreparer	Specjalizacja `DeviceFlashPreparer`, która obsługuje niestandardowe kroki wymagane do flashowania urządzeń Google.
GoogleDeviceSetup	Rozszerzenie `DeviceSetup`, które umożliwia konfigurowanie dodatkowych usług Google.
GsiDeviceFlashPreparer	Przygotowujący urządzenie, który wgrywa na nie ogólny obraz systemu Androida.
HsumBootStrategyPreparer
ILabPreparer	Interfejs znacznika dla osób przygotowujących materiały laboratoryjne Opis tych interfejsów znajdziesz w sekcji `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 testu.
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 plik APK testu ze środowiska kompilacji platformy Android.
InstallKernelModulePreparer	Przygotowuje urządzenie docelowe, instalując moduły jądra.
InstrumentationPreparer	`ITargetPreparer`, która uruchamia instrumentację
KillExistingEmulatorPreparer	Obiekt `ITargetPreparer`, który wyłącza działający emulator.
KnownFailurePreparer	Wskaż preparer, aby pominąć ponawianie próby w przypadku znanego błędu.
LocalEmulatorLaunch	Obiekt TargetPreparer, który uruchamia emulator lokalnie ze środowiska kompilacji Androida.
LocalEmulatorSnapshot	Element TargetPreparer przeznaczony do generowania czystego zrzutu emulatora ze środowiska kompilacji/programistycznego Androida.
MixKernelTargetPreparer	Obraz `ITargetPreparer`, który umożliwia połączenie obrazu jądra z obrazem urządzenia.
MixRadioTargetPreparer	`ITargetPreparer`, która umożliwia połączenie obrazu radia z obrazem urządzenia.
ModuleOemTargetPreparer
NativeLeakCollector	`ITargetPreparer`, który uruchamia polecenie „dumpsys meminfo --unreachable -a”, aby zidentyfikować nieosiągalną pamięć natywną aktualnie zajmowaną przez każdy proces.
NoApkTestSkipper	Specjalny preparer, który umożliwia całkowite pominięcie wywołania (przygotowania i testów), jeśli nie ma plików APK do testowania.
PerfettoPreparer	Przygotowujący Perfetto przesyła plik konfiguracyjny na urządzenie w standardowej lokalizacji, do której Perfetto ma dostęp.
ProfileTargetPreparer	Klasa bazowa do konfigurowania narzędzia do przygotowywania danych o odbiorcach dla dowolnego użytkownika profilu `android.os.usertype.profile.XXX`.
PushFileInvoker	Ta klasa została wycofana. Zamiast niej używaj zasady `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 wirtualne środowisko Pythona na hoście i instaluje pakiety.
RamdumpPreparer	Włącz Ramdump.
RebootTargetPreparer	Przygotowujący urządzenie docelowe, który ponownie uruchamia urządzenie.
RecoveryLogPreparer	Przygotowanie miejsca docelowego używane do zbierania dzienników przed odzyskiwaniem.
RemoveSystemAppPreparer	`ITargetPreparer` – usuwanie pliku APK z partycji systemowej przed uruchomieniem testu.
RestartSystemServerTargetPreparer	Przygotowujący, który ponownie uruchamia serwer systemowy bez ponownego uruchamiania urządzenia.
RootTargetPreparer	Przygotowuje urządzenie docelowe, wykonując polecenia „adb root” lub „adb unroot” w zależności od opcji „force-root”.
RootcanalForwarderPreparer
RunCommandTargetPreparer
RunHostCommandTargetPreparer	Przygotowanie docelowe do uruchamiania dowolnych poleceń hosta przed i po uruchomieniu testu.
RunHostScriptTargetPreparer	Przygotowywanie urządzenia docelowego, które wykonuje skrypt przed uruchomieniem testu.
RunOnCloneProfileTargetPreparer
RunOnPrivateProfileTargetPreparer
RunOnSdkSandboxTargetPreparer	Wartość `ITargetPreparer` oznacza, że testy powinny być przeprowadzane w piaskownicy SDK.
RunOnSecondaryUserTargetPreparer	`ITargetPreparer`, aby mieć pewność, że test zostanie uruchomiony jako użytkownik dodatkowy.
RunOnSystemUserTargetPreparer	Znak `ITargetPreparer`, który oznacza, że testy powinny być przeprowadzane na użytkowniku (a nie na obecnym użytkowniku).
RunOnWorkProfileTargetPreparer	`ITargetPreparer`, który tworzy profil służbowy podczas konfiguracji i oznacza, że testy powinny być przeprowadzane na tym użytkowniku.
SemaphoreTokenTargetPreparer	Jest to preparer używany do serializacji wykonywania testów na hoście Tradefed za pomocą tokena.
Ustawienia	`ITargetPreparer`, która konfiguruje ustawienia urządzenia za pomocą instrumentacji SettingsUtil.apk.
SideloadOtaTargetPreparer	Przygotowujący urządzenie docelowe, który wykonuje instalację pakietu OTA z zewnętrznego źródła, stosuje pakiet, czeka na uruchomienie urządzenia i wstrzykuje właściwości kompilacji urządzenia, aby używać ich jako informacji o kompilacji. Ten preparator zakłada, że urządzenie będzie w momencie uruchomienia w zwykłym trybie adb, i zapewni, że urządzenie wyjdzie z tego trybu, ale z zastosowaną nowszą kompilacją.
StopServicesSetup	`ITargetPreparer`, która zatrzymuje usługi na urządzeniu.
StubTargetPreparer	Pusta implementacja obiektu zastępczego `ITargetPreparer`.
SuiteApkInstaller	Instaluje określone pliki APK na potrzeby konfiguracji pakietu: ze zmiennej $ANDROID_TARGET_OUT_TESTCASES lub z ROOT_DIR w informacjach o kompilacji.
SwitchUserTargetPreparer	Domyślna implementacja `BaseSwitchUserTargetPreparer` – więcej informacji znajdziesz w dokumentacji Javadoc tej klasy.
TearDownPassThroughPreparer	Umożliwia uruchamianie funkcji tearDown na preparatorach uwzględnionych w konfiguracji jako obiekt.
TemperatureThrottlingWaiter	`ITargetPreparer`, która czeka, aż temperatura urządzenia spadnie do docelowej wartości.
TestAppInstallSetup	`ITargetPreparer`, która instaluje co najmniej 1 aplikację z folderu `IDeviceBuildInfo.getTestsDir()` na urządzeniu.
TestFilePushSetup	`ITargetPreparer`, która przesyła co najmniej 1 plik lub katalog z folderu `IDeviceBuildInfo.getTestsDir()` na urządzenie.
TestSystemAppInstallSetup	`ITargetPreparer`, która instaluje co najmniej 1 aplikację z folderu `IDeviceBuildInfo.getTestsDir()` na partycji /system na urządzeniu.
TimeWaster	Prosty program do przygotowywania celu, który pozwala zabić czas i potencjalnie ponownie uruchomić urządzenie.
UserCleaner	`ITargetPreparer`, która usuwa użytkowników dodatkowych podczas zamykania.
VisibleBackgroundUserPreparer	Przygotowanie urządzenia docelowego do uruchamiania testów na użytkowniku, który jest uruchamiany w tle.
WaitForDeviceDatetimePreparer	`ITargetPreparer`, który czeka na ustawienie daty i godziny na urządzeniu. Opcjonalnie osoba przygotowująca może wymusić `TargetSetupError`, jeśli data i godzina nie zostaną ustawione w określonym czasie.
WifiPreparer	`ITargetPreparer`, która w razie potrzeby konfiguruje Wi-Fi na urządzeniu.

Przygotowuje środowisko testowe do przeprowadzenia testu.

Na przykład instaluje oprogramowanie, dostosowuje ustawienia środowiska na potrzeby testowania, uruchamia cele itp.

Pamiętaj, że w konfiguracji można określić wiele elementów ITargetPreparer. Zaleca się, aby każdy interfejs ITargetPreparer wyraźnie dokumentował oczekiwane wstępne i końcowe ustawienia środowiska. Na przykład interfejs ITargetPreparer, który konfiguruje urządzenie do testowania, musi być uruchamiany po interfejsie ITargetPreparer, który instaluje oprogramowanie.

Podsumowanie

Metody publiczne
`default void`	`setUp(ITestDevice device, IBuildInfo buildInfo)` Ta metoda została wycofana. Zamiast niej używaj zasady `setUp(TestInformation)`.
`default void`	`setUp(TestInformation testInformation)` Skonfiguruj środowisko docelowe na potrzeby testów.
`default void`	`tearDown(TestInformation testInformation, Throwable e)` Po zakończeniu testowania wyczyść/zdemontuj środowisko docelowe.
`default void`	`tearDown(ITestDevice device, IBuildInfo buildInfo, Throwable e)` Ta metoda została wycofana. Zamiast niej używaj zasady `tearDown(TestInformation,Throwable)`.

Metody publiczne

setUp

public void setUp (ITestDevice device, 
                IBuildInfo buildInfo)

Ta metoda została wycofana.
Zamiast niej używaj kolumny setUp(TestInformation)

Skonfiguruj środowisko docelowe na potrzeby testów.

Parametry
`device`	`ITestDevice`: `ITestDevice` do przygotowania.
`buildInfo`	`IBuildInfo`: dane o kompilacji poddanej testom.

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

setUp

public void setUp (TestInformation testInformation)

Skonfiguruj środowisko docelowe na potrzeby testów.

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

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

tearDown

public void tearDown (TestInformation testInformation, 
                Throwable e)

Po zakończeniu testowania wyczyść/zdemontuj środowisko docelowe.

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

Zgłasza
`DeviceNotAvailableException`	jeśli urządzenie przestało odpowiadać,

tearDown

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

Ta metoda została wycofana.
Zamiast niej używaj kolumny tearDown(TestInformation,Throwable)

Po zakończeniu testowania wyczyść/zdemontuj środowisko docelowe.

Parametry
`device`	`ITestDevice`: `ITestDevice` do przygotowania.
`buildInfo`	`IBuildInfo`: dane o kompilacji poddanej testom.
`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`.

Zgłasza
`DeviceNotAvailableException`	jeśli urządzenie przestało odpowiadać,