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.

TestAppInstallSetup

public class TestAppInstallSetup
extends BaseTargetPreparer implements IAbiReceiver, IDiscoverDependencies, IIncrementalSetup

java.lang.Object
↳	com.android.tradefed.targetprep.BaseTargetPreparer
	↳	com.android.tradefed.targetprep.TestAppInstallSetup

Sottoclassi dirette note

CompanionTestAppInstallSetup, CompatTargetPreparer, SuiteApkInstaller

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à.
SuiteApkInstaller	Installa gli APK specificati per la configurazione della suite: dalla variabile $ANDROID_TARGET_OUT_TESTCASES o da ROOT_DIR nelle informazioni di build.

Sottoclassi indirette note

InstallApexModuleTargetPreparer, ModuleOemTargetPreparer

InstallApexModuleTargetPreparer
ModuleOemTargetPreparer

Un ITargetPreparer che installa una o più app da una cartella IDeviceBuildInfo.getTestsDir() sul dispositivo.

Questo preparatore cercherà in directory alternative se il file zip dei test non esiste o non contiene l'APK richiesto. La ricerca verrà eseguita in ordine dall'ultima directory alternativa specificata alla prima.

Riepilogo

Costanti
`String`	`INSTALLED_PACKAGES_KEY` La chiave per una proprietà `TestInformation` che contiene un elenco separato da virgole di nomi dei pacchetti degli APK installati.

Campi
`protected double`	`mBlockFilterPercentage`
`protected int`	`mIncrementalInstallTimeout`
`protected boolean`	`mIncrementalInstallation`

Costruttori pubblici
`TestAppInstallSetup()`

Metodi pubblici
`void`	`addInstallArg(String arg)` Aggiunge un argomento di installazione apk da utilizzare.
`void`	`addSplitApkFileNames(String fileNames)` Aggiunge un insieme di nomi di file divisi da "," in una stringa da installare come APK suddivisi
`void`	`addTestFile(File file)` Aggiunge un file o una directory all'elenco degli APK da installare.
`void`	`addTestFileName(String fileName)` Aggiunge un nome file all'elenco degli APK da installare.
`IAbi`	`getAbi()`
`ITestDevice`	`getDevice()` Restituisce il dispositivo a cui deve essere applicato il preparatore.
`TestInformation`	`getTestInfo()`
`List<File>`	`getTestsFileName()` Restituisce una copia dell'elenco dei nomi degli APK di test specificati.
`boolean`	`isCleanUpEnabled()` Restituisce True se gli APK verranno puliti durante l'eliminazione.
`final boolean`	`isInstantMode()` Restituisce un valore che indica se l'installazione in modalità istantanea è stata attivata.
`Set<String>`	`reportDependencies()`
`void`	`setAaptVersion(AaptParser.AaptVersion aaptVersion)` Imposta la versione di AAPT per l'analisi dell'APK.
`void`	`setAbi(IAbi abi)`
`void`	`setAltDir(File altDir)` Imposta una directory alternativa.
`void`	`setAltDirBehavior(AltDirBehavior altDirBehavior)` Imposta comportamenti alternativi della directory.
`void`	`setCleanApk(boolean shouldClean)` Specifica se l'APK installato deve essere pulito durante l'operazione di tearDown
`void`	`setForceQueryable(boolean forceQueryable)` Il valore predefinito di force queryable è true.
`void`	`setIncrementalSetupEnabled(boolean shouldEnable)` Imposta se attivare la configurazione incrementale sui preparatori TradeFed.
`final void`	`setInstantMode(boolean mode)` Specifica se utilizzare o meno --instant durante l'installazione dell'APK.
`void`	`setShouldGrantPermission(boolean shouldGrant)` Se viene fornito un userId, grantPermission può essere impostato per l'installazione dell'APK.
`void`	`setUp(ITestDevice device, IBuildInfo buildInfo)` Questo metodo è obsoleto. Callback temporaneo compatibile con le versioni precedenti.
`void`	`setUp(TestInformation testInfo)`
`void`	`setUserId(int userId)` Se l'APK deve essere installato per un determinato utente, imposta l'ID dell'utente per l'installazione.
`void`	`tearDown(TestInformation testInfo, Throwable e)`

Metodi protetti
`File`	`getLocalPathForFilename(TestInformation testInfo, String apkFileName)` Risolvi il percorso apk effettivo in base alle informazioni sull'artefatto di test all'interno delle informazioni sulla build.
`void`	`installer(TestInformation testInfo, Map<File, String> appFilesAndPackages)` Tentativo di installare un pacchetto o un pacchetto suddiviso sul dispositivo.
`String`	`parsePackageName(File testAppFile)` Recupera il nome del pacchetto dall'app di test.
`Map<File, String>`	`resolveApkFiles(TestInformation testInfo, List<File> apkFiles)` Helper per risolvere alcuni apk nei rispettivi file e pacchetti.
`void`	`setTestInformation(TestInformation testInfo)`
`void`	`uninstallPackage(ITestDevice device, String packageName)` Prova a rimuovere il pacchetto dal dispositivo.

Costanti

INSTALLED_PACKAGES_KEY

public static final String INSTALLED_PACKAGES_KEY

La chiave per una proprietà TestInformation che contiene un elenco separato da virgole di nomi dei pacchetti degli APK installati. Viene utilizzato per comunicare l'elenco dei pacchetti installati ad altri preparatori, ad esempio RunOnSecondaryUserTargetPreparer.

Valore costante: "INSTALLED_PACKAGES_KEY"

Campi

mBlockFilterPercentage

protected double mBlockFilterPercentage

mIncrementalInstallTimeout

protected int mIncrementalInstallTimeout

mIncrementalInstallation

protected boolean mIncrementalInstallation

Costruttori pubblici

TestAppInstallSetup

public TestAppInstallSetup ()

Metodi pubblici

addInstallArg

public void addInstallArg (String arg)

Aggiunge un argomento di installazione apk da utilizzare.

Parametri
`arg`	`String`

addSplitApkFileNames

public void addSplitApkFileNames (String fileNames)

Aggiunge un insieme di nomi di file divisi da "," in una stringa da installare come APK suddivisi

Parametri
`fileNames`	`String`: una stringa di nomi di file separati da ","

addTestFile

public void addTestFile (File file)

Aggiunge un file o una directory all'elenco degli APK da installare.

Parametri
`file`	`File`

addTestFileName

public void addTestFileName (String fileName)

Aggiunge un nome file all'elenco degli APK da installare.

Parametri
`fileName`	`String`

getAbi

public IAbi getAbi ()

Resi
`IAbi`

getDevice

public ITestDevice getDevice ()

Restituisce il dispositivo a cui deve essere applicato il preparatore.

Resi
`ITestDevice`

Genera
	com.android.tradefed.targetprep.TargetSetupError
`TargetSetupError`

getTestInfo

public TestInformation getTestInfo ()

Resi
`TestInformation`

getTestsFileName

public List<File> getTestsFileName ()

Restituisce una copia dell'elenco dei nomi degli APK di test specificati.

Resi
`List<File>`

isCleanUpEnabled

public boolean isCleanUpEnabled ()

Restituisce True se gli APK verranno puliti durante l'eliminazione.

Resi
`boolean`

isInstantMode

public final boolean isInstantMode ()

Restituisce un valore che indica se l'installazione in modalità istantanea è stata attivata.

Resi
`boolean`

reportDependencies

public Set<String> reportDependencies ()

Resi
`Set<String>`

setAaptVersion

public void setAaptVersion (AaptParser.AaptVersion aaptVersion)

Imposta la versione di AAPT per l'analisi dell'APK.

Parametri
`aaptVersion`	`AaptParser.AaptVersion`

setAbi

public void setAbi (IAbi abi)

Parametri
`abi`	`IAbi`

setAltDir

public void setAltDir (File altDir)

Imposta una directory alternativa.

Parametri
`altDir`	`File`

setAltDirBehavior

public void setAltDirBehavior (AltDirBehavior altDirBehavior)

Imposta comportamenti alternativi della directory.

Parametri
`altDirBehavior`	`AltDirBehavior`

setCleanApk

public void setCleanApk (boolean shouldClean)

Specifica se l'APK installato deve essere pulito durante l'operazione di tearDown

Parametri
`shouldClean`	`boolean`

setForceQueryable

public void setForceQueryable (boolean forceQueryable)

Il valore predefinito di force queryable è true. Imposta il valore su false se non è possibile eseguire query sull'APK da installare.

Parametri
`forceQueryable`	`boolean`

setIncrementalSetupEnabled

public void setIncrementalSetupEnabled (boolean shouldEnable)

Imposta se attivare la configurazione incrementale sui preparatori TradeFed.

Parametri
`shouldEnable`	`boolean`

setInstantMode

public final void setInstantMode (boolean mode)

Specifica se utilizzare o meno --instant durante l'installazione dell'APK. Non avrà alcun effetto se è impostata la modalità di installazione forzata.

Parametri
`mode`	`boolean`

setShouldGrantPermission

public void setShouldGrantPermission (boolean shouldGrant)

Se viene fornito un userId, grantPermission può essere impostato per l'installazione dell'APK.

Parametri
`shouldGrant`	`boolean`

setUp

public void setUp (ITestDevice device, 
                IBuildInfo buildInfo)

Questo metodo è obsoleto.
Callback temporaneo compatibile con le versioni precedenti.

Parametri
`device`	`ITestDevice`
`buildInfo`	`IBuildInfo`

Genera
`BuildError`
`DeviceNotAvailableException`
`TargetSetupError`

setUp

public void setUp (TestInformation testInfo)

Parametri
`testInfo`	`TestInformation`

Genera
`BuildError`
`DeviceNotAvailableException`
`TargetSetupError`

setUserId

public void setUserId (int userId)

Se l'APK deve essere installato per un determinato utente, imposta l'ID dell'utente per l'installazione.

Parametri
`userId`	`int`

tearDown

public void tearDown (TestInformation testInfo, 
                Throwable e)

Parametri
`testInfo`	`TestInformation`
`e`	`Throwable`

Genera
`DeviceNotAvailableException`

Metodi protetti

getLocalPathForFilename

protected File getLocalPathForFilename (TestInformation testInfo, 
                String apkFileName)

Risolvi il percorso apk effettivo in base alle informazioni sull'artefatto di test all'interno delle informazioni sulla build.

Parametri
`testInfo`	`TestInformation`: il `TestInformation` per la chiamata.
`apkFileName`	`String`: il nome file dell'APK da installare

Resi
`File`	un `File` che rappresenta il file APK fisico sull'host o `null` se il file non esiste.

Genera
`TargetSetupError`

programma di installazione

protected void installer (TestInformation testInfo, 
                Map<File, String> appFilesAndPackages)

Tentativo di installare un pacchetto o un pacchetto suddiviso sul dispositivo.

Parametri
`testInfo`	`TestInformation`: il `TestInformation` per la chiamata
`appFilesAndPackages`	`Map`: Gli APK e il relativo pacchetto da installare.

Genera
`DeviceNotAvailableException`
`TargetSetupError`

parsePackageName

protected String parsePackageName (File testAppFile)

Recupera il nome del pacchetto dall'app di test.

Parametri
`testAppFile`	`File`

Resi
`String`

Genera
`TargetSetupError`

resolveApkFiles

protected Map<File, String> resolveApkFiles (TestInformation testInfo, 
                List<File> apkFiles)

Helper per risolvere alcuni apk nei rispettivi file e pacchetti.

Parametri
`testInfo`	`TestInformation`
`apkFiles`	`List`

Resi
`Map<File, String>`

Genera
`DeviceNotAvailableException`
`TargetSetupError`

setTestInformation

protected void setTestInformation (TestInformation testInfo)

Parametri
`testInfo`	`TestInformation`

uninstallPackage

protected void uninstallPackage (ITestDevice device, 
                String packageName)

Prova a rimuovere il pacchetto dal dispositivo.

Parametri
`device`	`ITestDevice`
`packageName`	`String`

Genera
`DeviceNotAvailableException`