À partir du 27 mars 2025, nous vous recommandons d'utiliser android-latest-release au lieu de aosp-main pour créer et contribuer à AOSP. Pour en savoir plus, consultez la section Modifications apportées à AOSP.

Cette page a été traduite par l'API Cloud Translation.

InstallApexModuleTargetPreparer

public class InstallApexModuleTargetPreparer
extends SuiteApkInstaller

java.lang.Object
↳	com.android.tradefed.targetprep.BaseTargetPreparer
	↳	com.android.tradefed.targetprep.TestAppInstallSetup
		↳	com.android.tradefed.targetprep.suite.SuiteApkInstaller
			↳	com.android.tradefed.targetprep.InstallApexModuleTargetPreparer

Sous-classes directes connues

ModuleOemTargetPreparer

Résumé

Champs
`protected static final String`	`APEX_OPTION`
`protected static final String`	`APEX_SUFFIX`
`protected static final String`	`APK_SUFFIX`
`protected static final String`	`APK_ZIP_OPTION`
`protected static final String`	`CHILD_SESSION_CREATION_CMD`
`protected static final String`	`PARENT_SESSION_CREATION_CMD`
`public static final String`	`ROLLBACK_STATE_COMMITTED`
`public static final String`	`ROLLBACK_STATE_UNKNOWN`
`protected static final String`	`SPLIT_APKS_SUFFIX`
`protected File`	`mTrainFolderPath`

Constructeurs publics
`InstallApexModuleTargetPreparer()`

Méthodes publiques
	`getModulesToInstall(TestInformation testInfo)` Récupère les modules à installer sur le train, en fonction des modules préchargés sur l'appareil.
`void`	`setIgnoreIfNotPreloaded(boolean skip)`
`void`	`setSkipApexTearDown(boolean skip)`
`void`	`setUp(TestInformation testInfo)`
`void`	`tearDown(TestInformation testInfo, Throwable e)`

Méthodes protégées
`void`	`addApksToTestFiles()`
`void`	`addStagedReadyTimeoutForAdb( cmd)`
`void`	`addTimeoutMillisForBundletool( extraArgs)`
`void`	`checkApexActivation(ITestDevice device)` Vérifiez si tous les sommets sont activés.
	`collectApexInfoFromApexModules( testAppFileNames, TestInformation testInfo)` Collecte des informations apex à partir des modules apex pour la vérification de l'activation.
	`getApkInstalled()`
`String`	`getBundletoolFileName()`
`BundletoolUtil`	`getBundletoolUtil()`
`String`	`getModuleKeywordFromApexPackageName(String packageName)` Récupère le mot clé (par exemple, "tzdata" pour com.android.tzdata.apex) à partir du nom du package apex.
	`getModulesFailToActivate( activatedApexes)` Récupérez les modules qui n'ont pas pu être activés.
	`getSplitsForApks(TestInformation testInfo, File moduleFile)` Extraction et retour des fractionnements pour les APK spécifiés.
`void`	`initBundletoolUtil(TestInformation testInfo)` Initialise l'utilitaire bundletool pour cette classe.
`void`	`installTrain(TestInformation testInfo, moduleFilenames)` Tentative d'installation d'un train principal contenant Apex sur l'appareil.
`void`	`installUsingBundleTool(TestInformation testInfo, testAppFileNames)` Tente d'installer un ou plusieurs modules principaux à l'aide de bundletool.
`void`	`installer(TestInformation testInfo, testAppFileNames)` Essayez d'installer un package ou un package fractionné sur l'appareil.
`ITestDevice.ApexInfo`	`retrieveApexInfo(File testApexFile, DeviceDescriptor deviceDescriptor)` Récupère ApexInfo, qui contient packageName et versionCode à partir du fichier Apex donné.

Champs

APEX_OPTION

protected static final String APEX_OPTION

APEX_SUFFIX

protected static final String APEX_SUFFIX

APK_SUFFIX

protected static final String APK_SUFFIX

APK_ZIP_OPTION

protected static final String APK_ZIP_OPTION

CHILD_SESSION_CREATION_CMD

protected static final String CHILD_SESSION_CREATION_CMD

PARENT_SESSION_CREATION_CMD

protected static final String PARENT_SESSION_CREATION_CMD

ROLLBACK_STATE_COMMITTED

public static final String ROLLBACK_STATE_COMMITTED

ROLLBACK_STATE_UNKNOWN

public static final String ROLLBACK_STATE_UNKNOWN

SPLIT_APKS_SUFFIX

protected static final String SPLIT_APKS_SUFFIX

mTrainFolderPath

protected File mTrainFolderPath

Constructeurs publics

InstallApexModuleTargetPreparer

public InstallApexModuleTargetPreparer ()

Méthodes publiques

getModulesToInstall

public  getModulesToInstall (TestInformation testInfo)

Récupère les modules à installer sur le train, en fonction des modules préchargés sur l'appareil. Les modules qui ne sont pas préchargés ne seront pas installés.

Paramètres
`testInfo`	`TestInformation`: `TestInformation`

Renvoie
	Liste des modules à installer sur l'appareil.

Génère
`DeviceNotAvailableException`	lorsque l'appareil n'est pas disponible.
`TargetSetupError`	lorsque les modules obligatoires ne sont pas installés ou que le module ne peut pas être installé.

setIgnoreIfNotPreloaded

public void setIgnoreIfNotPreloaded (boolean skip)

Paramètres
`skip`	`boolean`

setSkipApexTearDown

public void setSkipApexTearDown (boolean skip)

Paramètres
`skip`	`boolean`

setUp

public void setUp (TestInformation testInfo)

Paramètres
`testInfo`	`TestInformation`

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

tearDown

public void tearDown (TestInformation testInfo, 
                Throwable e)

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

Génère
`DeviceNotAvailableException`
`DeviceRuntimeException`

Méthodes protégées

addApksToTestFiles

protected void addApksToTestFiles ()

addStagedReadyTimeoutForAdb

protected void addStagedReadyTimeoutForAdb ( cmd)

Paramètres
`cmd`

addTimeoutMillisForBundletool

protected void addTimeoutMillisForBundletool ( extraArgs)

Paramètres
`extraArgs`

checkApexActivation

protected void checkApexActivation (ITestDevice device)

Vérifiez si tous les sommets sont activés.

Paramètres
`device`	`ITestDevice`: en cours de test.

Génère
`TargetSetupError`	en cas d'échec de l'activation.
`DeviceNotAvailableException`

collectApexInfoFromApexModules

protected  collectApexInfoFromApexModules ( testAppFileNames, 
                TestInformation testInfo)

Collecte des informations apex à partir des modules apex pour la vérification de l'activation.

Paramètres
`testAppFileNames`	: liste des noms de fichiers des modules à installer
`testInfo`	`TestInformation`: L'`TestInformation`

Renvoie
	une liste contenant les apexinfo des modules Apex dans les listes de fichiers d'entrée

Génère
`TargetSetupError`

getApkInstalled

protected  getApkInstalled ()

Renvoie

getBundletoolFileName

protected String getBundletoolFileName ()

Renvoie
`String`

getBundletoolUtil

protected BundletoolUtil getBundletoolUtil ()

Renvoie
`BundletoolUtil`

getModuleKeywordFromApexPackageName

protected String getModuleKeywordFromApexPackageName (String packageName)

Récupère le mot clé (par exemple, "tzdata" pour com.android.tzdata.apex) à partir du nom du package apex.

Paramètres
`packageName`	`String`: nom du package du fichier Apex.

Renvoie
`String`	une chaîne Le mot clé du nom du package Apex.

getModulesFailToActivate

protected  getModulesFailToActivate ( activatedApexes)

Récupérez les modules qui n'ont pas pu être activés.

Paramètres
`activatedApexes`	: ensemble des sommets actifs sur l'appareil

Renvoie
	une liste contenant les apexinfo des modules Apex d'entrée qui n'ont pas pu être activés.

Génère
`DeviceNotAvailableException`
`TargetSetupError`

getSplitsForApks

protected  getSplitsForApks (TestInformation testInfo, 
                File moduleFile)

Extraction et retour des fractionnements pour les APK spécifiés.

Paramètres
`testInfo`	`TestInformation`: `TestInformation`
`moduleFile`	`File`: fichier de module à partir duquel extraire les fractionnements.

Renvoie
	un File[] contenant les fractionnements.

Génère
`TargetSetupError`	Si bundletool est introuvable ou si le fichier de spécifications de l'appareil ne parvient pas à être généré.

initBundletoolUtil

protected void initBundletoolUtil (TestInformation testInfo)

Initialise l'utilitaire bundletool pour cette classe.

Paramètres
`testInfo`	`TestInformation`: `TestInformation` de l'appel.

Génère
`TargetSetupError`	si bundletool est introuvable.

installTrain

protected void installTrain (TestInformation testInfo, 
                 moduleFilenames)

Tentative d'installation d'un train principal contenant Apex sur l'appareil.

Paramètres
`testInfo`	`TestInformation`: `TestInformation`
`moduleFilenames`	: liste de chaînes. Liste des noms de fichiers des modules principaux à installer.

Génère
`DeviceNotAvailableException`
`TargetSetupError`

installUsingBundleTool

protected void installUsingBundleTool (TestInformation testInfo, 
                 testAppFileNames)

Tente d'installer un ou plusieurs modules principaux à l'aide de bundletool.

Paramètres
`testInfo`	`TestInformation`: `TestInformation`
`testAppFileNames`	: noms de fichiers des modules préchargés à installer.

Génère
`DeviceNotAvailableException`
`TargetSetupError`

programme d'installation

protected void installer (TestInformation testInfo, 
                 testAppFileNames)

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

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

Génère
`DeviceNotAvailableException`
`TargetSetupError`

retrieveApexInfo

protected ITestDevice.ApexInfo retrieveApexInfo (File testApexFile, 
                DeviceDescriptor deviceDescriptor)

Récupère ApexInfo, qui contient packageName et versionCode à partir du fichier Apex donné.

Paramètres
`testApexFile`	`File`: fichier Apex à partir duquel nous récupérons des informations.
`deviceDescriptor`	`DeviceDescriptor`

Renvoie
`ITestDevice.ApexInfo`	un `ApexInfo` contenant le packageName et le versionCode du fichier donné

Génère
`TargetSetupError`	si l'analyseur aapt n'a pas réussi à analyser le fichier.