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 79 innych.

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	Wspólny preparer do uruchamiania lokalnego emulatora.
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 `getCompanionDeviceSelectionOptions()` należy wdrożyć, aby opisać kryteria potrzebne do przydzielenia urządzenia towarzyszącego.
CompanionAwarePreparer	`ITargetPreparer`, która 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 jedną aplikację z `IDeviceBuildInfo.getTestsDir()` folderu na przypisanym urządzeniu towarzyszącym.
CompileBootImageWithSpeedTargetPreparer	Ponownie kompiluje ścieżkę klasy rozruchowej 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	Przygotowuje miejsce docelowe do utworzenia użytkownika i usuwa go na koniec.
DeviceActionTargetPreparer	`ITargetPreparer` – wykonywanie działań 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óra 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	Przygotowywanie urządzenia docelowego, które wyświetla obrazy urządzenia w określonym formacie.
DeviceOwnerTargetPreparer	Obiekt `ITargetPreparer`, który konfiguruje komponent właściciela urządzenia.
DeviceSetup	`ITargetPreparer`, który konfiguruje urządzenie na potrzeby 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 interfejs `ITargetPreparer`, który wykonuje typowe czynności związane z aktualizowaniem urządzeń za pomocą pliku obrazu urządzenia z zewnętrznego źródła (w przeciwieństwie do usługi kompilacji).
DeviceWiper	`ITargetPreparer`, która usuwa dane użytkownika.
DisableSELinuxTargetPreparer	Przygotowujący urządzenie docelowe, który wyłącza SELinux, jeśli jest włączony.
DynamicSystemPreparer	`ITargetPreparer`, który konfiguruje obraz systemu na kompilacji urządzenia za pomocą dynamicznej aktualizacji systemu.
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 przygotowuje określone pliki (program rozruchowy, radio, plik ZIP z obrazem urządzenia) w `IDeviceBuildInfo`, aby flashować urządzenia za pomocą `FastbootDeviceFlasher`, a następnie wstawia atrybuty urządzenia po uruchomieniu do informacji o kompilacji na potrzeby raportowania wyników.
FeatureFlagTargetPreparer	Aktualizuje DeviceConfig (flagi funkcji dostosowane przez usługę zdalną).
FoldableModePreparer	Przygotowujący element 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 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.
GsiDeviceFlashPreparer	Przygotowujący urządzenie, który wgrywa na nie ogólny obraz systemu Androida.
ILabPreparer	Interfejs znacznika dla osób przygotowujących moduły Opis tych interfejsów znajdziesz w sekcji `ITargetPreparer`.
ITargetCleaner	Ten interfejs został wycofany. Funkcja 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 plik APK testowy ze środowiska kompilacji platformy Android.
InstallKernelModulePreparer	Przygotowujący urządzenie docelowe, który instaluje moduły jądra.
InstrumentationPreparer	`ITargetPreparer`, która uruchamia instrumentację
KillExistingEmulatorPreparer	Obiekt `ITargetPreparer`, który zamyka działający emulator.
KnownFailurePreparer	Przygotuj element docelowy, aby pominąć ponawianie znanej awarii.
LocalEmulatorLaunch	Obiekt TargetPreparer, który uruchamia emulator lokalnie ze środowiska kompilacji Androida.
LocalEmulatorSnapshot	Obiekt TargetPreparer przeznaczony do generowania czystego zrzutu emulatora ze środowiska kompilacji/programistycznego Androida.
MixKernelTargetPreparer	`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 moduł przygotowujący, 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. Użyj w zamian 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.
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 restartuje 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 pakietu SDK.
RunOnSecondaryUserTargetPreparer	Znak `ITargetPreparer`, aby upewnić się, że test jest przeprowadzany 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 za pomocą tokena na hoście Tradefed.
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	`ITargetPreparer`, który w funkcji setUp przełącza się na określony rodzaj użytkownika.
TearDownPassThroughPreparer	Umożliwia uruchamianie funkcji tearDown w przypadku przygotowujących, które są uwzględnione w konfiguracji jako obiekt.
TemperatureThrottlingWaiter	`ITargetPreparer`, która czeka, aż temperatura urządzenia spadnie do docelowej wartości.
TestAppInstallSetup	`ITargetPreparer`, która instaluje na urządzeniu co najmniej jedną aplikację z folderu `IDeviceBuildInfo.getTestsDir()`.
TestFilePushSetup	`ITargetPreparer`, który przesyła co najmniej 1 plik lub katalog z folderu `IDeviceBuildInfo.getTestsDir()` na urządzenie.
TestSystemAppInstallSetup	`ITargetPreparer`, który instaluje co najmniej jedną aplikację z folderu `IDeviceBuildInfo.getTestsDir()` na partycji /system na urządzeniu.
TimeWaster	Prosty preparator celu, który ma na celu marnowanie czasu i potencjalne ponowne uruchomienie urządzenia.
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óry 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 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. Użyj w zamian zasady `setUp(com.android.tradefed.invoker.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. Użyj w zamian zasady `tearDown(com.android.tradefed.invoker.TestInformation, Throwable)`

Metody publiczne

setUp

public void setUp (ITestDevice device, 
                IBuildInfo buildInfo)

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

Skonfiguruj środowisko docelowe na potrzeby testów.

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

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

setUp

public void setUp (TestInformation testInformation)

Skonfiguruj środowisko docelowe na potrzeby testów.

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

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

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 zasady tearDown(com.android.tradefed.invoker.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ć,