À partir de 2026, pour nous aligner sur notre modèle de développement stable et garantir la stabilité de la plate-forme pour l'écosystème, nous publierons le code source sur AOSP au deuxième et au quatrième trimestre. Pour créer et contribuer à AOSP, nous vous recommandons d'utiliser android-latest-release au lieu de aosp-main. La branche de fichier manifeste android-latest-release fera toujours référence à la version la plus récente envoyée à AOSP. Pour en savoir plus, consultez Modifications apportées à AOSP.

TestAppInstallSetup

public class TestAppInstallSetup
extends BaseTargetPreparer implements IAbiReceiver, IDiscoverDependencies, IIncrementalSetup

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

Sous-classes directes connues

CompanionTestAppInstallSetup, SuiteApkInstaller

CompanionTestAppInstallSetup	Un `ITargetPreparer` qui installe une ou plusieurs applications à partir d'un dossier `IDeviceBuildInfo.getTestsDir()` sur un appareil associé attribué.
SuiteApkInstaller	Installe les APK spécifiés pour la configuration de la suite : à partir de la variable $ANDROID_TARGET_OUT_TESTCASES ou de ROOT_DIR dans les informations de compilation.

Sous-classes indirectes connues

InstallApexModuleTargetPreparer, ModuleOemTargetPreparer

InstallApexModuleTargetPreparer
ModuleOemTargetPreparer

Un ITargetPreparer qui installe une ou plusieurs applications à partir d'un dossier IDeviceBuildInfo.getTestsDir() sur l'appareil.

Ce préparateur recherchera dans d'autres répertoires si le fichier zip de test n'existe pas ou ne contient pas l'APK requis. La recherche s'effectue dans l'ordre inverse de celui des répertoires alternatifs spécifiés.

Résumé

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

Constructeurs publics
`TestAppInstallSetup()`

Méthodes publiques
`void`	`addInstallArg(String arg)` Ajoute un argument d'installation d'APK à utiliser.
`void`	`addSplitApkFileNames(String fileNames)` Ajoute un ensemble de noms de fichiers divisés par "," dans une chaîne à installer en tant qu'APK fractionnés.
`void`	`addTestFile(File file)` Ajoute un fichier ou un répertoire à la liste des APK à installer.
`void`	`addTestFileName(String fileName)` Ajoute un nom de fichier à la liste des APK à installer.
`IAbi`	`getAbi()`
`ITestDevice`	`getDevice()` Renvoie l'appareil auquel le préparateur doit s'appliquer.
`TestInformation`	`getTestInfo()`
	`getTestsFileName()` Renvoie une copie de la liste des noms d'APK de test spécifiés.
`boolean`	`isCleanUpEnabled()` Renvoie "True" si les APK seront nettoyés lors de la fermeture.
`final boolean`	`isInstantMode()` Indique si l'installation en mode instantané a été activée ou non.
	`reportDependencies()`
`void`	`setAaptVersion(AaptParser.AaptVersion aaptVersion)` Définit la version d'AAPT pour l'analyse des APK.
`void`	`setAbi(IAbi abi)`
`void`	`setAltDir(File altDir)` Définissez un autre répertoire.
`void`	`setAltDirBehavior(AltDirBehavior altDirBehavior)` Définissez d'autres comportements de répertoire.
`void`	`setCleanApk(boolean shouldClean)` Indique si l'APK installé doit être nettoyé lors de la fermeture.
`void`	`setForceQueryable(boolean forceQueryable)` La valeur par défaut de "force queryable" est "true".
`void`	`setIncrementalSetupEnabled(boolean shouldEnable)` Indiquez si vous souhaitez activer la configuration incrémentielle sur les préparateurs TradeFed.
`final void`	`setInstantMode(boolean mode)` Indique si l'option "--instant" doit être utilisée lors de l'installation de l'APK.
`void`	`setShouldGrantPermission(boolean shouldGrant)` Si un userId est fourni, grantPermission peut être défini pour l'installation de l'APK.
`void`	`setUp(ITestDevice device, IBuildInfo buildInfo)` Cette méthode est obsolète. Rappel temporaire rétrocompatible.
`void`	`setUp(TestInformation testInfo)`
`void`	`setUserId(int userId)` Si le fichier APK doit être installé pour un utilisateur spécifique, définit l'ID de l'utilisateur pour lequel l'installation doit être effectuée.
`void`	`tearDown(TestInformation testInfo, Throwable e)`

Méthodes protégées
`File`	`getLocalPathForFilename(TestInformation testInfo, String apkFileName)` Résolvez le chemin d'accès réel de l'APK en fonction des informations sur les artefacts de test dans les informations de compilation.
`void`	`installer(TestInformation testInfo, appFilesAndPackages)` Tente d'installer un package ou un package fractionné sur l'appareil.
`String`	`parsePackageName(File testAppFile)` Obtenez le nom du package à partir de l'application de test.
	`resolveApkFiles(TestInformation testInfo, apkFiles)` Outil permettant de résoudre certains fichiers APK dans leurs fichiers et packages.
`void`	`setTestInformation(TestInformation testInfo)`
`void`	`uninstallPackage(ITestDevice device, String packageName)` Essayez de supprimer le package de l'appareil.

Champs

mBlockFilterPercentage

protected double mBlockFilterPercentage

mIncrementalInstallTimeout

protected int mIncrementalInstallTimeout

mIncrementalInstallation

protected boolean mIncrementalInstallation

Constructeurs publics

TestAppInstallSetup

public TestAppInstallSetup ()

Méthodes publiques

addInstallArg

public void addInstallArg (String arg)

Ajoute un argument d'installation d'APK à utiliser.

Paramètres
`arg`	`String`

addSplitApkFileNames

public void addSplitApkFileNames (String fileNames)

Ajoute un ensemble de noms de fichiers divisés par "," dans une chaîne à installer en tant qu'APK fractionnés.

Paramètres
`fileNames`	`String` : chaîne de noms de fichiers séparés par une virgule.

addTestFile

public void addTestFile (File file)

Ajoute un fichier ou un répertoire à la liste des APK à installer.

Paramètres
`file`	`File`

addTestFileName

public void addTestFileName (String fileName)

Ajoute un nom de fichier à la liste des APK à installer.

Paramètres
`fileName`	`String`

getAbi

public IAbi getAbi ()

Renvoie
`IAbi`

getDevice

public ITestDevice getDevice ()

Renvoie l'appareil auquel le préparateur doit s'appliquer.

Renvoie
`ITestDevice`

Génère
	com.android.tradefed.targetprep.TargetSetupError
`TargetSetupError`

getTestInfo

public TestInformation getTestInfo ()

Renvoie
`TestInformation`

getTestsFileName

public  getTestsFileName ()

Renvoie une copie de la liste des noms d'APK de test spécifiés.

Renvoie

isCleanUpEnabled

public boolean isCleanUpEnabled ()

Renvoie "True" si les APK seront nettoyés lors de la fermeture.

Renvoie
`boolean`

isInstantMode

public final boolean isInstantMode ()

Indique si l'installation en mode instantané a été activée ou non.

Renvoie
`boolean`

reportDependencies

public  reportDependencies ()

Renvoie

setAaptVersion

public void setAaptVersion (AaptParser.AaptVersion aaptVersion)

Définit la version d'AAPT pour l'analyse des APK.

Paramètres
`aaptVersion`	`AaptParser.AaptVersion`

setAbi

public void setAbi (IAbi abi)

Paramètres
`abi`	`IAbi`

setAltDir

public void setAltDir (File altDir)

Définissez un autre répertoire.

Paramètres
`altDir`	`File`

setAltDirBehavior

public void setAltDirBehavior (AltDirBehavior altDirBehavior)

Définissez d'autres comportements de répertoire.

Paramètres
`altDirBehavior`	`AltDirBehavior`

setCleanApk

public void setCleanApk (boolean shouldClean)

Indique si l'APK installé doit être nettoyé lors de la fermeture.

Paramètres
`shouldClean`	`boolean`

setForceQueryable

public void setForceQueryable (boolean forceQueryable)

La valeur par défaut de "force queryable" est "true". Définissez-la sur "false" si l'APK à installer ne doit pas être interrogeable.

Paramètres
`forceQueryable`	`boolean`

setIncrementalSetupEnabled

public void setIncrementalSetupEnabled (boolean shouldEnable)

Indiquez si vous souhaitez activer la configuration incrémentielle sur les préparateurs TradeFed.

Paramètres
`shouldEnable`	`boolean`

setInstantMode

public final void setInstantMode (boolean mode)

Indique si l'option "--instant" doit être utilisée lors de l'installation de l'APK. N'aura aucun effet si le mode d'installation forcée est défini.

Paramètres
`mode`	`boolean`

setShouldGrantPermission

public void setShouldGrantPermission (boolean shouldGrant)

Si un userId est fourni, grantPermission peut être défini pour l'installation de l'APK.

Paramètres
`shouldGrant`	`boolean`

setUp

public void setUp (ITestDevice device, 
                IBuildInfo buildInfo)

Cette méthode est obsolète.
Temporary backward compatible callback.

Paramètres
`device`	`ITestDevice`
`buildInfo`	`IBuildInfo`

Génère
`BuildError`
`DeviceNotAvailableException`
`TargetSetupError`

setUp

public void setUp (TestInformation testInfo)

Paramètres
`testInfo`	`TestInformation`

Génère
`BuildError`
`DeviceNotAvailableException`
`TargetSetupError`

setUserId

public void setUserId (int userId)

Si le fichier APK doit être installé pour un utilisateur spécifique, définit l'ID de l'utilisateur pour lequel l'installation doit être effectuée.

Paramètres
`userId`	`int`

tearDown

public void tearDown (TestInformation testInfo, 
                Throwable e)

Paramètres
`testInfo`	`TestInformation`
`e`	`Throwable`

Génère
`DeviceNotAvailableException`

Méthodes protégées

getLocalPathForFilename

protected File getLocalPathForFilename (TestInformation testInfo, 
                String apkFileName)

Résolvez le chemin d'accès réel de l'APK en fonction des informations sur les artefacts de test dans les informations de compilation.

Paramètres
`testInfo`	`TestInformation` : `TestInformation` pour l'invocation.
`apkFileName`	`String` : nom de fichier de l'APK à installer

Renvoie
`File`	`ERROR(/File)` représentant le fichier APK physique sur l'hôte ou `null` si le fichier n'existe pas.

Génère
`TargetSetupError`

programme d'installation

protected void installer (TestInformation testInfo, 
                 appFilesAndPackages)

Tentez d'installer un package ou un package fractionné sur l'appareil.

Paramètres
`testInfo`	`TestInformation` : `TestInformation` pour l'invocation
`appFilesAndPackages`	: les APK et leur package à installer.

Génère
`DeviceNotAvailableException`
`TargetSetupError`

parsePackageName

protected String parsePackageName (File testAppFile)

Obtenez le nom du package à partir de l'application de test.

Paramètres
`testAppFile`	`File`

Renvoie
`String`

Génère
`TargetSetupError`

resolveApkFiles

protected  resolveApkFiles (TestInformation testInfo, 
                 apkFiles)

Outil permettant de résoudre certains fichiers APK dans leurs fichiers et packages.

Paramètres
`testInfo`	`TestInformation`
`apkFiles`

Renvoie

Génère
`DeviceNotAvailableException`
`TargetSetupError`

setTestInformation

protected void setTestInformation (TestInformation testInfo)

Paramètres
`testInfo`	`TestInformation`

uninstallPackage

protected void uninstallPackage (ITestDevice device, 
                String packageName)

Essayez de supprimer le package de l'appareil.

Paramètres
`device`	`ITestDevice`
`packageName`	`String`

Génère
`DeviceNotAvailableException`