Ab 2026 werden wir, um unser stabiles Entwicklungsmodell für den Trunk zu unterstützen und die Plattformstabilität für das Ökosystem zu gewährleisten, den Quellcode im 2. und 4. Quartal in AOSP veröffentlichen. Verwenden Sie android-latest-release, um AOSP zu entwickeln und dazu beizutragen. Der Manifestzweig android-latest-release verweist immer auf das neueste Release, das an AOSP übertragen wurde. Weitere Informationen finden Sie unter Änderungen an AOSP.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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

Bekannte direkte Unterklassen

ModuleOemTargetPreparer

Zusammenfassung

Konstanten
`String`	`APEX_OPTION`
`String`	`APEX_SUFFIX`
`String`	`APK_SUFFIX`
`String`	`APK_ZIP_OPTION`
`String`	`CHILD_SESSION_CREATION_CMD`
`String`	`PARENT_SESSION_CREATION_CMD`
`String`	`ROLLBACK_STATE_COMMITTED`
`String`	`ROLLBACK_STATE_UNKNOWN`
`String`	`SPLIT_APKS_SUFFIX`

Felder
`protected File`	`mTrainFolderPath`

Öffentliche Konstruktoren
`InstallApexModuleTargetPreparer()`

Öffentliche Methoden
`List<File>`	`getModulesToInstall(TestInformation testInfo)` Ruft die Module ab, die auf dem Zug installiert werden sollen, basierend auf den auf dem Gerät vorinstallierten Modulen.
`void`	`setIgnoreIfNotPreloaded(boolean skip)`
`void`	`setSkipApexTearDown(boolean skip)`
`void`	`setUp(TestInformation testInfo)`
`void`	`tearDown(TestInformation testInfo, Throwable e)`

Geschützte Methoden
`void`	`addApksToTestFiles()`
`void`	`addStagedReadyTimeoutForAdb(List<String> cmd)`
`void`	`addTimeoutMillisForBundletool(List<String> extraArgs)`
`void`	`checkApexActivation(ITestDevice device)` Prüfen Sie, ob alle Scheitelpunkte aktiviert sind.
`List<ITestDevice.ApexInfo>`	`collectApexInfoFromApexModules(Map<File, String> testAppFileNames, TestInformation testInfo)` Ruft Apex-Informationen aus den Apex-Modulen für die Aktivierungsprüfung ab.
`List<String>`	`getApkInstalled()`
`String`	`getBundletoolFileName()`
`BundletoolUtil`	`getBundletoolUtil()`
`String`	`getModuleKeywordFromApexPackageName(String packageName)` Ruft das Keyword (z.B. „tzdata“ für com.android.tzdata.apex) aus dem APEX-Paketnamen ab.
`List<ITestDevice.ApexInfo>`	`getModulesFailToActivate(Set<ITestDevice.ApexInfo> activatedApexes)` Module abrufen, die nicht aktiviert werden konnten.
`List<File>`	`getSplitsForApks(TestInformation testInfo, File moduleFile)` Extrahiert und gibt Splits für die angegebenen APKs zurück.
`void`	`initBundletoolUtil(TestInformation testInfo)` Initialisiert das Bundletool-Dienstprogramm für diese Klasse.
`void`	`installTrain(TestInformation testInfo, List<File> moduleFilenames)` Es wird versucht, einen Mainline-Zug mit Apex auf dem Gerät zu installieren.
`void`	`installUsingBundleTool(TestInformation testInfo, List<File> testAppFileNames)` Es wird versucht, Mainline-Module mit Bundletool zu installieren.
`void`	`installer(TestInformation testInfo, Map<File, String> testAppFileNames)` Versuchen Sie, ein Paket oder Split-Paket auf dem Gerät zu installieren.
`ITestDevice.ApexInfo`	`retrieveApexInfo(File testApexFile, DeviceDescriptor deviceDescriptor)` Ruft ApexInfo ab, das packageName und versionCode aus der angegebenen APEX-Datei enthält.

Konstanten

APEX_OPTION

protected static final String APEX_OPTION

Konstanter Wert: "--apex"

APEX_SUFFIX

protected static final String APEX_SUFFIX

Konstanter Wert: ".apex"

APK_SUFFIX

protected static final String APK_SUFFIX

Konstanter Wert: ".apk"

APK_ZIP_OPTION

protected static final String APK_ZIP_OPTION

Constant Value: "--apks-zip"

CHILD_SESSION_CREATION_CMD

protected static final String CHILD_SESSION_CREATION_CMD

Konstanter Wert: "pm install-create"

PARENT_SESSION_CREATION_CMD

protected static final String PARENT_SESSION_CREATION_CMD

Konstanter Wert: "pm install-create --multi-package"

ROLLBACK_STATE_COMMITTED

public static final String ROLLBACK_STATE_COMMITTED

Konstanter Wert: "committed"

ROLLBACK_STATE_UNKNOWN

public static final String ROLLBACK_STATE_UNKNOWN

Konstanter Wert: „unknown“

SPLIT_APKS_SUFFIX

protected static final String SPLIT_APKS_SUFFIX

Konstanter Wert: ".apks"

Felder

mTrainFolderPath

protected File mTrainFolderPath

Öffentliche Konstruktoren

InstallApexModuleTargetPreparer

public InstallApexModuleTargetPreparer ()

Öffentliche Methoden

getModulesToInstall

public List<File> getModulesToInstall (TestInformation testInfo)

Ruft die Module ab, die auf dem Zug installiert werden sollen, basierend auf den auf dem Gerät vorinstallierten Modulen. Module, die nicht vorab geladen werden, werden nicht installiert.

Parameter
`testInfo`	`TestInformation`: Der `TestInformation`

Gibt Folgendes zurück:
`List<File>`	Liste der Module, die auf dem Gerät installiert werden sollen.

Löst aus
`DeviceNotAvailableException`	wenn das Gerät nicht verfügbar ist.
`TargetSetupError`	wenn erforderliche Module nicht installiert sind oder das Modul nicht installiert werden kann.

setIgnoreIfNotPreloaded

public void setIgnoreIfNotPreloaded (boolean skip)

Parameter
`skip`	`boolean`

setSkipApexTearDown

public void setSkipApexTearDown (boolean skip)

Parameter
`skip`	`boolean`

setUp

public void setUp (TestInformation testInfo)

Parameter
`testInfo`	`TestInformation`

Löst aus
`BuildError`
`DeviceNotAvailableException`
`TargetSetupError`

tearDown

public void tearDown (TestInformation testInfo, 
                Throwable e)

Parameter
`testInfo`	`TestInformation`
`e`	`Throwable`

Löst aus
`DeviceNotAvailableException`
`DeviceRuntimeException`

Geschützte Methoden

addApksToTestFiles

protected void addApksToTestFiles ()

addStagedReadyTimeoutForAdb

protected void addStagedReadyTimeoutForAdb (List<String> cmd)

Parameter
`cmd`	`List`

addTimeoutMillisForBundletool

protected void addTimeoutMillisForBundletool (List<String> extraArgs)

Parameter
`extraArgs`	`List`

checkApexActivation

protected void checkApexActivation (ITestDevice device)

Prüfen Sie, ob alle Scheitelpunkte aktiviert sind.

Parameter
`device`	`ITestDevice`: wird getestet.

Löst aus
`TargetSetupError`	wenn die Aktivierung fehlgeschlagen ist.
`DeviceNotAvailableException`

collectApexInfoFromApexModules

protected List<ITestDevice.ApexInfo> collectApexInfoFromApexModules (Map<File, String> testAppFileNames, 
                TestInformation testInfo)

Ruft Apex-Informationen aus den Apex-Modulen für die Aktivierungsprüfung ab.

Parameter
`testAppFileNames`	`Map`: Die Liste der Dateinamen der zu installierenden Module
`testInfo`	`TestInformation`: Der `TestInformation`

Gibt Folgendes zurück:
`List<ITestDevice.ApexInfo>`	Eine Liste mit den apexinfo-Informationen der APEX-Module in den Eingabedateilisten.

Löst aus
`TargetSetupError`

getApkInstalled

protected List<String> getApkInstalled ()

Gibt Folgendes zurück:
`List<String>`

getBundletoolFileName

protected String getBundletoolFileName ()

Gibt Folgendes zurück:
`String`

getBundletoolUtil

protected BundletoolUtil getBundletoolUtil ()

Gibt Folgendes zurück:
`BundletoolUtil`

getModuleKeywordFromApexPackageName

protected String getModuleKeywordFromApexPackageName (String packageName)

Ruft das Keyword (z.B. „tzdata“ für com.android.tzdata.apex) aus dem APEX-Paketnamen ab.

Parameter
`packageName`	`String`: Der Paketname der APEX-Datei.

Gibt Folgendes zurück:
`String`	Ein String. Das Keyword des Apex-Paketnamens.

getModulesFailToActivate

protected List<ITestDevice.ApexInfo> getModulesFailToActivate (Set<ITestDevice.ApexInfo> activatedApexes)

Module abrufen, die nicht aktiviert werden konnten.

Parameter
`activatedApexes`	`Set`: Die Menge der aktiven Apexes auf dem Gerät

Gibt Folgendes zurück:
`List<ITestDevice.ApexInfo>`	Eine Liste mit den Apex-Informationen der Eingabe-Apex-Module, die nicht aktiviert werden konnten.

Löst aus
`DeviceNotAvailableException`
`TargetSetupError`

getSplitsForApks

protected List<File> getSplitsForApks (TestInformation testInfo, 
                File moduleFile)

Extrahiert und gibt Splits für die angegebenen APKs zurück.

Parameter
`testInfo`	`TestInformation`: Der `TestInformation`
`moduleFile`	`File`: Die Moduldatei, aus der die Splits extrahiert werden sollen.

Gibt Folgendes zurück:
`List<File>`	ein File[] mit den Splits.

Löst aus
`TargetSetupError`	wenn „bundletool“ nicht gefunden werden kann oder die Geräte-Spezifikationsdatei nicht generiert werden kann.

initBundletoolUtil

protected void initBundletoolUtil (TestInformation testInfo)

Initialisiert das Bundletool-Dienstprogramm für diese Klasse.

Parameter
`testInfo`	`TestInformation`: Der `TestInformation` für den Aufruf.

Löst aus
`TargetSetupError`	wenn „bundletool“ nicht gefunden werden kann.

installTrain

protected void installTrain (TestInformation testInfo, 
                List<File> moduleFilenames)

Es wird versucht, einen Mainline-Zug mit Apex auf dem Gerät zu installieren.

Parameter
`testInfo`	`TestInformation`: Der `TestInformation`
`moduleFilenames`	`List`: Liste von Strings. Die Liste der Dateinamen der zu installierenden Mainline-Module.

Löst aus
`DeviceNotAvailableException`
`TargetSetupError`

installUsingBundleTool

protected void installUsingBundleTool (TestInformation testInfo, 
                List<File> testAppFileNames)

Es wird versucht, Mainline-Module mit Bundletool zu installieren.

Parameter
`testInfo`	`TestInformation`: Der `TestInformation`
`testAppFileNames`	`List`: Die Dateinamen der vorinstallierten Module, die installiert werden sollen.

Löst aus
`DeviceNotAvailableException`
`TargetSetupError`

Installateur

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

Versuchen Sie, ein Paket oder Split-Paket auf dem Gerät zu installieren.

Parameter
`testInfo`	`TestInformation`: der `TestInformation` für den Aufruf
`testAppFileNames`	`Map`: Die zu installierenden APKs und ihr Paket.

Löst aus
`DeviceNotAvailableException`
`TargetSetupError`

retrieveApexInfo

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

Ruft ApexInfo ab, das packageName und versionCode aus der angegebenen APEX-Datei enthält.

Parameter
`testApexFile`	`File`: Die Apex-Datei, aus der wir Informationen abrufen.
`deviceDescriptor`	`DeviceDescriptor`

Gibt Folgendes zurück:
`ITestDevice.ApexInfo`	eine `ApexInfo` mit dem packageName und versionCode der angegebenen Datei

Löst aus
`TargetSetupError`	wenn der aapt-Parser die Datei nicht parsen konnte.