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

BaseEmulatorPreparer, BaseTargetPreparer, BuildInfoRecorder, CreateAvdPreparer, CreateUserPreparer, DeviceBuildInfoBootStrapper, DeviceBuildInfoInjector, DeviceCleaner, DeviceFlashPreparer, DeviceImageZipFlashingTargetPreparer, DeviceSetup, DeviceUpdateTargetPreparer, FastbootUpdateBootstrapPreparer, FoldableModePreparer, GkiDeviceFlashPreparer oraz 15 innych.

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.
CreateAvdPreparer
CreateUserPreparer	Utwórz użytkownika i na końcu go wyczyść.
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.
DeviceSetup	`ITargetPreparer`, który konfiguruje urządzenie do testowania na podstawie podanych `Option`.
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).
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.
FoldableModePreparer	Obiekt do przygotowania docelowego, który może przełączać stan składania urządzenia.
GkiDeviceFlashPreparer	Narzędzie do przygotowywania urządzeń, które flashuje urządzenie za pomocą 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.
ITargetCleaner	Ten interfejs został wycofany. Metoda tearDown została przeniesiona do podstawowego interfejsu ITargetPreparer.
InstallApexModuleTargetPreparer
KillExistingEmulatorPreparer	`ITargetPreparer`, który wyłącza uruchomiony emulator.
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.
ModuleOemTargetPreparer
RecoveryLogPreparer	Osoba przygotowująca cel używała ich do zbierania dzienników przed przywróceniem.
RunCommandTargetPreparer
RunOnSecondaryUserTargetPreparer	`ITargetPreparer`, który tworzy w ramach konfiguracji dodatkowego użytkownika i oznacza, że testy powinny być uruchamiane na tym użytkowniku.
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.
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.
TestAppInstallSetup	`ITargetPreparer`, który instaluje co najmniej 1 aplikację z folderu `IDeviceBuildInfo.getTestsDir()` 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 moduł ITargetPreparer wyraźnie dokumentował oczekiwane środowisko przed konfiguracją i po konfiguracji. Przykładowo moduł ITargetPreparer, który konfiguruje urządzenie do testowania, musi być uruchomiony po module ITargetPreparer, który instaluje oprogramowanie.

Podsumowanie

Metody publiczne
`default void`	`setUp(ITestDevice device, IBuildInfo buildInfo)` Ta metoda została wycofana. Zamiast tego użyj `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. Zamiast tego użyj `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 wersji testowanej.

Rzuty
`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)

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 wersji.
`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 wersji testowanej.
`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ć.