A partire dal 2026, per allinearci al nostro modello di sviluppo trunk stabile e garantire la stabilità della piattaforma per l'ecosistema, pubblicheremo il codice sorgente su AOSP nel secondo e nel quarto trimestre. Per compilare e contribuire ad AOSP, utilizza android-latest-release. Il branch del manifest android-latest-release farà sempre riferimento alla release più recente pubblicata su AOSP. Per saperne di più, consulta la sezione Modifiche ad 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

Sottoclassi indirette note

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

AFlagsTargetPreparer	Utilizza `aflags` per ignorare i flag prima di eseguire un test.
AdbStopServerPreparer	Target preparer per arrestare il server adb sull'host prima e dopo l'esecuzione dei test adb.
AllTestAppsInstallSetup	Un `ITargetPreparer` che installa tutte le app da una cartella `IDeviceBuildInfo.getTestsDir()` sul dispositivo.
AoaTargetPreparer	`ITargetPreparer` che esegue una serie di azioni (ad es. clic e scorrimenti) utilizzando il protocollo Android Open Accessory (AOAv2).
AppSetup	Un `ITargetPreparer` che installa un APK e i relativi test.
ArtChrootPreparer	Crea la directory chroot per i test ART.
BaseEmulatorPreparer	Preparatore comune per l'avvio di un emulatore locale.
BaseSwitchUserTargetPreparer	Un `ITargetPreparer` che passa al tipo di utente specificato in setUp.
BaseSystemTestEnvPreparer	Riavvia l'ambiente di test del sistema di base
BaseTargetPreparer	Classe di implementazione di base per `ITargetPreparer` che consente di controllare se l'oggetto è disattivato o meno.
BuildInfoRecorder	Un `ITargetPreparer` che scrive i metadati delle informazioni di build in un file specificato.
CheckPairingPreparer	Un `CompanionAwarePreparer` che verifica l'accoppiamento Bluetooth tra il dispositivo principale e quello complementare
CompanionAllocator	Classe base che si occupa di allocare e liberare il dispositivo complementare `getCompanionDeviceSelectionOptions()` deve essere implementato per descrivere i criteri necessari per allocare il dispositivo companion
CompanionAwarePreparer	Un `ITargetPreparer` che incapsula la logica di recupero di un dispositivo complementare già allocato.
CompanionRunCommandTargetPreparer	Un `ITargetPreparer` che esegue i comandi specificati sul dispositivo complementare allocato
CompanionTestAppInstallSetup	Un `ITargetPreparer` che installa una o più app da una cartella `IDeviceBuildInfo.getTestsDir()` su un dispositivo complementare allocato.
CompatTargetPreparer	Un `ITargetPreparer` che prepara il dispositivo per l'esecuzione dei test di compatibilità.
CompileBootImageWithSpeedTargetPreparer	Ricompila il classpath di avvio e il server di sistema con il filtro del compilatore "speed".
CpuThrottlingWaiter	Un `ITargetPreparer` che attende il ripristino della frequenza massima su tutti i core al livello più alto disponibile
CreateAvdPreparer
CreateUserPreparer	Target preparer per la creazione di un utente secondario e la relativa pulizia alla fine.
CrosDutTopologyPreparer	Un preparatore che esegue lo strumento dt-converter per generare la configurazione e i parametri di test.
CrosLsNexusPreparer	Un preparatore che avvia e arresta il servizio LSNexus per un dispositivo ChromeOS.
CtsSettingsSetup	Un `ITargetPreparer` che configura le impostazioni di un dispositivo in preparazione all'esecuzione dei test CTS.
DeviceActionTargetPreparer	Un `ITargetPreparer` per eseguire azioni del dispositivo.
DeviceBuildInfoBootStrapper	Un `ITargetPreparer` che sostituisce i campi delle informazioni sulla build con gli attributi letti dal dispositivo Questa opzione è utile per testare i dispositivi con build generate da una sorgente esterna (ad es.
DeviceBuildInfoInjector	Un `ITargetPreparer` che inserisce i metadati `DeviceBuildDescriptor` nel `IBuildInfo`.
DeviceCleaner	Esegue il riavvio o la formattazione come azione di pulizia dopo il test e, facoltativamente, spegne lo schermo
DeviceFlashPreparer	Un `ITargetPreparer` che mostra un'immagine sull'hardware Android fisico.
DeviceImageZipFlashingTargetPreparer	Uno strumento di preparazione del target che esegue il flash del dispositivo con le immagini del dispositivo fornite tramite un formato specifico.
DeviceOwnerTargetPreparer	Un `ITargetPreparer` che configura un componente proprietario del dispositivo.
DeviceSetup	Un `ITargetPreparer` che configura un dispositivo per il test in base agli `Option` forniti.
DeviceStorageFiller	Il preparatore di destinazione riempie lo spazio di archiviazione in modo che sia disponibile una certa quantità di spazio libero.
DeviceStringPusher	Target preparer per scrivere una stringa in un file.
DeviceUpdateTargetPreparer	Un abstract `ITargetPreparer` che si occupa dei passaggi comuni per l'aggiornamento dei dispositivi con un file immagine del dispositivo da una fonte esterna (anziché un servizio di build).
DeviceWiper	Un `ITargetPreparer` che cancella i dati utente
DexMetadataExtractor	Installa i file di metadati Dex per gli APK specificati.
DisableSELinuxTargetPreparer	Preparatore di destinazione che disattiva SELinux se è abilitato.
DynamicSystemPreparer	Un `ITargetPreparer` che configura un'immagine di sistema sopra una build del dispositivo con l'aggiornamento di sistema dinamico.
EhideTargetPreparer	Avvia ehide, che nasconde l'interfaccia Ethernet dallo stack di rete Android.
EraseUserDataPreparer	Un `ITargetPreparer` che cancella i dati utente sul dispositivo.
FastbootCommandPreparer	Target preparer che attiva fastboot e invia i comandi fastboot.
FastbootUpdateBootstrapPreparer	Un `ITargetPreparer` che organizza i file specificati (bootloader, radio, zip dell'immagine del dispositivo) in `IDeviceBuildInfo` per eseguire il flashing dei dispositivi con `FastbootDeviceFlasher`, quindi inserisce gli attributi del dispositivo post-avvio nelle informazioni sulla build a scopo di generazione dei report sui risultati.
FeatureFlagTargetPreparer	Questa classe è obsoleta. Utilizza invece `AFlagsTargetPreparer`.
FoldableModePreparer	Un preparatore di destinazione che può cambiare lo stato pieghevole di un dispositivo.
FolderSaver	Un `ITargetPreparer` che estrae le directory dal dispositivo, le comprime e le salva nel backend di logging.
FutilityCommandPreparer	Preparer to execute futility commands.
GkiDeviceFlashPreparer	Un preparatore di destinazione che esegue il flash del dispositivo con l'immagine generica del kernel comune di Android.
GoogleAccountPreparer	Un `ITargetPreparer` che supporta la configurazione degli Account Google.
GoogleAppsSetup	Un `ITargetPreparer` che supporta varie opzioni di configurazione per le app Google Nota: prima di tutto, su un dispositivo deve essere configurato un account. Consulta `GoogleAccountPreparer`
GoogleDeviceFlashPreparer	Una specializzazione di `DeviceFlashPreparer` che supporta i passaggi personalizzati necessari per eseguire il flashing dei dispositivi Google.
GoogleDeviceSetup	Un'estensione di `DeviceSetup` che consente di configurare proprietà specifiche di Google aggiuntive.
GsiDeviceFlashPreparer	Uno strumento di preparazione del target che esegue il flashing del dispositivo con l'immagine di sistema generica di Android.
HsumBootStrategyPreparer
ILabPreparer	Interfaccia di marcatore per i preparatori del lab Consulta la sezione `ITargetPreparer` per una descrizione dello scopo di queste interfacce.
ITargetCleaner	Questa interfaccia è obsoleta. tearDown è stato spostato nell'interfaccia ITargetPreparer di base.
InstallAllTestZipAppsSetup	Un `ITargetPreparer` che installa tutte le app in un file zip di test.
InstallApexModuleTargetPreparer
InstallApkSetup	Un `ITargetPreparer` che installa uno o più APK che si trovano nel file system.
InstallBuildEnvApkSetup	Un `ITargetPreparer` che installa uno o più APK di test da un ambiente di build della piattaforma Android.
InstallKernelModulePreparer	Un preparatore di target che installa i moduli del kernel.
InstrumentationPreparer	Un `ITargetPreparer` che esegue la strumentazione
KillExistingEmulatorPreparer	Un `ITargetPreparer` che arresta un emulatore in esecuzione.
KnownFailurePreparer	Prepara il target per saltare il nuovo tentativo in caso di errore noto.
LocalEmulatorLaunch	Un TargetPreparer che avvia un emulatore localmente da un ambiente di build Android.
LocalEmulatorSnapshot	Un TargetPreparer destinato alla generazione di un'istantanea emulatore pulita da un ambiente di sviluppo/build Android
MixKernelTargetPreparer	Un `ITargetPreparer` che consente di combinare un'immagine del kernel con l'immagine del dispositivo.
MixRadioTargetPreparer	Un `ITargetPreparer` che consente di combinare un'immagine della radio con l'immagine del dispositivo.
ModuleOemTargetPreparer
NativeLeakCollector	Un `ITargetPreparer` che esegue "dumpsys meminfo --unreachable -a" per identificare la memoria nativa non raggiungibile attualmente detenuta da ogni processo.
NoApkTestSkipper	Preparatore speciale che consente di saltare completamente un'invocazione (preparazione e test) se non sono presenti APK da testare.
PerfettoPreparer	Perfetto preparer esegue il push del file di configurazione nel dispositivo in una posizione standard a cui perfetto ha accesso.
ProfileTargetPreparer	Classe base per la configurazione del preparatore del target per qualsiasi utente del profilo `android.os.usertype.profile.XXX`.
PushFileInvoker	Questa classe è obsoleta. Usa invece `PushFilePreparer`
PushFilePreparer	Un `ITargetPreparer` che tenta di trasferire un numero qualsiasi di file da qualsiasi percorso host a qualsiasi percorso del dispositivo.
PythonVirtualenvPreparer	Configura un virtualenv Python sull'host e installa i pacchetti.
RamdumpPreparer	Attiva Ramdump.
RebootTargetPreparer	Target preparer che riavvia il dispositivo.
RecoveryLogPreparer	Un preparatore della destinazione utilizzato per raccogliere i log prima del recupero.
RemoveSystemAppPreparer	Un `ITargetPreparer` per rimuovere un APK dalla partizione di sistema prima di un'esecuzione del test.
RestartSystemServerTargetPreparer	Target preparer che riavvia il server di sistema senza riavviare il dispositivo.
RootTargetPreparer	Target preparer che esegue "adb root" o "adb unroot" in base all'opzione "force-root".
RootcanalForwarderPreparer
RunCommandTargetPreparer
RunHostCommandTargetPreparer	Target preparer per eseguire comandi host arbitrari prima e dopo l'esecuzione del test.
RunHostScriptTargetPreparer	Target preparer che esegue uno script prima di eseguire un test.
RunOnCloneProfileTargetPreparer
RunOnPrivateProfileTargetPreparer
RunOnSdkSandboxTargetPreparer	Un `ITargetPreparer` per indicare che i test devono essere eseguiti nella sandbox dell'SDK.
RunOnSecondaryUserTargetPreparer	Un `ITargetPreparer` per assicurarsi che il test venga eseguito come utente secondario.
RunOnSystemUserTargetPreparer	Un `ITargetPreparer` che indica che i test devono essere eseguiti sull'utente (anziché sull'utente corrente).
RunOnWorkProfileTargetPreparer	Un `ITargetPreparer` che crea un profilo di lavoro durante la configurazione e indica che i test devono essere eseguiti in quell'utente.
SemaphoreTokenTargetPreparer	Questo è un preparatore utilizzato per utilizzare il token per serializzare l'esecuzione del test nell'host tradefed.
SettingsSetup	Un `ITargetPreparer` che configura le impostazioni del dispositivo tramite l'instrumentazione di SettingsUtil.apk.
SideloadOtaTargetPreparer	Un preparatore di destinazione che esegue il sideload di un pacchetto OTA specificato, applica il pacchetto, attende l'avvio del dispositivo e inserisce le proprietà di build del dispositivo da utilizzare come informazioni sulla build Questo preparatore di destinazione presuppone che il dispositivo sia in modalità adb normale all'avvio e garantirà che il dispositivo esca nella stessa modalità, ma con la build più recente applicata.
StopServicesSetup	Un `ITargetPreparer` che interrompe i servizi sul dispositivo.
StubTargetPreparer	Implementazione vuota segnaposto di un `ITargetPreparer`.
SuiteApkInstaller	Installa gli APK specificati per la configurazione della suite: dalla variabile $ANDROID_TARGET_OUT_TESTCASES o da ROOT_DIR nelle informazioni di build.
SwitchUserTargetPreparer	Implementazione predefinita di `BaseSwitchUserTargetPreparer`. Per ulteriori informazioni, consulta la documentazione Javadoc di questa classe.
TearDownPassThroughPreparer	Consente di eseguire tearDown sui preparatori inclusi in una configurazione come oggetto.
TemperatureThrottlingWaiter	Un `ITargetPreparer` che attende che la temperatura del dispositivo scenda fino al valore ottimale
TestAppInstallSetup	Un `ITargetPreparer` che installa una o più app da una cartella `IDeviceBuildInfo.getTestsDir()` sul dispositivo.
TestFilePushSetup	Un `ITargetPreparer` che trasferisce uno o più file/directory da una cartella `IDeviceBuildInfo.getTestsDir()` al dispositivo.
TestSystemAppInstallSetup	Un `ITargetPreparer` che installa una o più app da una cartella `IDeviceBuildInfo.getTestsDir()` nella partizione /system del dispositivo.
TimeWaster	Un semplice preparatore di destinazione per perdere tempo e potenzialmente riavviare il dispositivo.
UserCleaner	Un `ITargetPreparer` che rimuove gli utenti secondari durante lo smontaggio.
VisibleBackgroundUserPreparer	Preparatore di destinazione per l'esecuzione di test in un utente avviato in background.
WaitForDeviceDatetimePreparer	Un `ITargetPreparer` che attende l'impostazione della data e dell'ora sul dispositivo Facoltativamente, questo preparatore può forzare un `TargetSetupError` se la data e l'ora non sono impostate entro il timeout.
WifiPreparer	Un `ITargetPreparer` che configura il Wi-Fi sul dispositivo, se necessario.

Prepara l'ambiente di test per l'esecuzione del test.

Ad esempio, installa software, modifica le impostazioni dell'ambiente per i test, avvia target e così via.

Tieni presente che in una configurazione possono essere specificati più ITargetPreparer. È consigliabile che ogni ITargetPreparer documenti chiaramente la configurazione preliminare e successiva dell'ambiente previsto. Ad esempio, un ITargetPreparer che configura un dispositivo per i test deve essere eseguito dopo l'ITargetPreparer che installa il software.

Riepilogo

Metodi pubblici
`default void`	`setUp(ITestDevice device, IBuildInfo buildInfo)` Questo metodo è obsoleto. Usa invece `setUp(TestInformation)`
`default void`	`setUp(TestInformation testInformation)` Esegui la configurazione del target per il test.
`default void`	`tearDown(TestInformation testInformation, Throwable e)` Esegui la pulizia/lo smontaggio del target dopo il test.
`default void`	`tearDown(ITestDevice device, IBuildInfo buildInfo, Throwable e)` Questo metodo è obsoleto. Usa invece `tearDown(TestInformation,Throwable)`

Metodi pubblici

setUp

public void setUp (ITestDevice device, 
                IBuildInfo buildInfo)

Questo metodo è obsoleto.
Utilizza invece setUp(TestInformation)

Esegui la configurazione del target per il test.

Parametri
`device`	`ITestDevice`: il `ITestDevice` da preparare.
`buildInfo`	`IBuildInfo`: dati sulla build in fase di test.

Genera
`DeviceNotAvailableException`	se il dispositivo non risponde
`BuildError`	Se si verifica un errore relativo a BuildInfo
`TargetSetupError`	se si è verificato un errore irreversibile durante la configurazione dell'ambiente

setUp

public void setUp (TestInformation testInformation)

Esegui la configurazione del target per il test.

Parametri
`testInformation`	`TestInformation`: il `TestInformation` della chiamata.

Genera
`DeviceNotAvailableException`	se il dispositivo non risponde
`BuildError`	Se si verifica un errore durante la preparazione della build
`TargetSetupError`	se si è verificato un errore irreversibile durante la configurazione dell'ambiente

tearDown

public void tearDown (TestInformation testInformation, 
                Throwable e)

Esegui la pulizia/lo smontaggio del target dopo il test.

Parametri
`testInformation`	`TestInformation`: il `TestInformation` della chiamata.
`e`	`Throwable`: se la chiamata è terminata con un'eccezione, questa sarà l'eccezione rilevata a livello di chiamata. In caso contrario, sarà `null`.

Genera
`DeviceNotAvailableException`	se il dispositivo non risponde

tearDown

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

Questo metodo è obsoleto.
Utilizza invece tearDown(TestInformation,Throwable)

Esegui la pulizia/lo smontaggio del target dopo il test.

Parametri
`device`	`ITestDevice`: il `ITestDevice` da preparare.
`buildInfo`	`IBuildInfo`: dati sulla build in fase di test.
`e`	`Throwable`: se la chiamata è terminata con un'eccezione, questa sarà l'eccezione rilevata a livello di chiamata. In caso contrario, sarà `null`.

Genera
`DeviceNotAvailableException`	se il dispositivo non risponde