Ab 2026 werden wir den Quellcode im 2. und 4. Quartal in AOSP veröffentlichen, um unser trunk-stable-Entwicklungsmodell zu unterstützen und die Plattformstabilität für das Ökosystem zu gewährleisten. Für die Entwicklung und das Beitragen zu AOSP empfehlen wir die Verwendung von android-latest-release anstelle von aosp-main. Der Manifestzweig android-latest-release verweist immer auf das neueste Release, das an AOSP übertragen wurde. Weitere Informationen finden Sie unter Änderungen an AOSP.

TestAppInstallSetup

public class TestAppInstallSetup
extends BaseTargetPreparer implements IAbiReceiver, IDiscoverDependencies, IIncrementalSetup

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

Bekannte direkte Unterklassen

CompanionTestAppInstallSetup, SuiteApkInstaller

CompanionTestAppInstallSetup	Eine `ITargetPreparer`, die eine oder mehrere Apps aus einem `IDeviceBuildInfo.getTestsDir()`-Ordner auf einem zugewiesenen Begleitgerät installiert.
SuiteApkInstaller	Installiert die angegebenen APKs für die Suite-Konfiguration: entweder aus der Variablen $ANDROID_TARGET_OUT_TESTCASES oder aus ROOT_DIR in den Build-Informationen.

Bekannte indirekte Unterklassen

InstallApexModuleTargetPreparer, ModuleOemTargetPreparer

InstallApexModuleTargetPreparer
ModuleOemTargetPreparer

Eine ITargetPreparer, mit der eine oder mehrere Apps aus einem IDeviceBuildInfo.getTestsDir()-Ordner auf dem Gerät installiert werden.

Dieser Preparer sucht in alternativen Verzeichnissen, wenn die ZIP-Datei mit den Tests nicht vorhanden ist oder das erforderliche APK nicht enthält. Die Suche erfolgt in der Reihenfolge vom letzten zum ersten angegebenen alternativen Verzeichnis.

Zusammenfassung

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

Öffentliche Konstruktoren
`TestAppInstallSetup()`

Öffentliche Methoden
`void`	`addInstallArg(String arg)` Fügt ein APK-Installationsargument hinzu, das verwendet werden soll.
`void`	`addSplitApkFileNames(String fileNames)` Fügt eine Reihe von durch „,“ getrennten Dateinamen in einem String hinzu, die als Split-APKs installiert werden sollen.
`void`	`addTestFile(File file)` Fügt der Liste der zu installierenden APKs eine Datei oder ein Verzeichnis hinzu.
`void`	`addTestFileName(String fileName)` Fügt der Liste der zu installierenden APKs einen Dateinamen hinzu.
`IAbi`	`getAbi()`
`ITestDevice`	`getDevice()` Gibt das Gerät zurück, auf das sich der Vorbereiter beziehen sollte.
`TestInformation`	`getTestInfo()`
	`getTestsFileName()` Gibt eine Kopie der Liste der angegebenen Test-APK-Namen zurück.
`boolean`	`isCleanUpEnabled()` Gibt „True“ zurück, wenn APKs beim Beenden des Vorgangs bereinigt werden.
`final boolean`	`isInstantMode()` Gibt zurück, ob die Installation im Sofortmodus aktiviert wurde.
	`reportDependencies()`
`void`	`setAaptVersion(AaptParser.AaptVersion aaptVersion)` Legt die Version von AAPT für das Parsen von APKs fest.
`void`	`setAbi(IAbi abi)`
`void`	`setAltDir(File altDir)` Legen Sie ein alternatives Verzeichnis fest.
`void`	`setAltDirBehavior(AltDirBehavior altDirBehavior)` Legen Sie ein alternatives Verzeichnisverhalten fest.
`void`	`setCleanApk(boolean shouldClean)` Legt fest, ob die installierte APK-Datei bei tearDown bereinigt werden soll.
`void`	`setForceQueryable(boolean forceQueryable)` Der Standardwert von „force queryable“ ist „true“.
`void`	`setIncrementalSetupEnabled(boolean shouldEnable)` Legen Sie fest, ob die inkrementelle Einrichtung für TradeFed-Präparatoren aktiviert werden soll.
`final void`	`setInstantMode(boolean mode)` Legt fest, ob beim Installieren des APK die Option „--instant“ verwendet werden soll.
`void`	`setShouldGrantPermission(boolean shouldGrant)` Wenn eine userId angegeben wird, kann grantPermission für die APK-Installation festgelegt werden.
`void`	`setUp(ITestDevice device, IBuildInfo buildInfo)` Diese Methode ist veraltet. Temporärer abwärtskompatibler Callback.
`void`	`setUp(TestInformation testInfo)`
`void`	`setUserId(int userId)` Wenn das APK für einen bestimmten Nutzer installiert werden soll, wird die ID des Nutzers festgelegt, für den die Installation erfolgen soll.
`void`	`tearDown(TestInformation testInfo, Throwable e)`

Geschützte Methoden
`File`	`getLocalPathForFilename(TestInformation testInfo, String apkFileName)` Den tatsächlichen APK-Pfad anhand von Informationen zum Testartefakt in den Build-Informationen auflösen.
`void`	`installer(TestInformation testInfo, appFilesAndPackages)` Versuchen Sie, ein Paket oder Split-Paket auf dem Gerät zu installieren.
`String`	`parsePackageName(File testAppFile)` Rufen Sie den Paketnamen der Test-App ab.
	`resolveApkFiles(TestInformation testInfo, apkFiles)` Helfer zum Auflösen einiger APKs in ihre Datei und ihr Paket.
`void`	`setTestInformation(TestInformation testInfo)`
`void`	`uninstallPackage(ITestDevice device, String packageName)` Versuchen Sie, das Paket vom Gerät zu entfernen.

Felder

mBlockFilterPercentage

protected double mBlockFilterPercentage

mIncrementalInstallTimeout

protected int mIncrementalInstallTimeout

mIncrementalInstallation

protected boolean mIncrementalInstallation

Öffentliche Konstruktoren

TestAppInstallSetup

public TestAppInstallSetup ()

Öffentliche Methoden

addInstallArg

public void addInstallArg (String arg)

Fügt ein APK-Installationsargument hinzu, das verwendet werden soll.

Parameter
`arg`	`String`

addSplitApkFileNames

public void addSplitApkFileNames (String fileNames)

Fügt eine Reihe von durch „,“ getrennten Dateinamen in einem String hinzu, die als Split-APKs installiert werden sollen.

Parameter
`fileNames`	`String`: Eine durch Kommas getrennte Liste von Dateinamen.

addTestFile

public void addTestFile (File file)

Fügt der Liste der zu installierenden APKs eine Datei oder ein Verzeichnis hinzu.

Parameter
`file`	`File`

addTestFileName

public void addTestFileName (String fileName)

Fügt der Liste der zu installierenden APKs einen Dateinamen hinzu.

Parameter
`fileName`	`String`

getAbi

public IAbi getAbi ()

Returns
`IAbi`

getDevice

public ITestDevice getDevice ()

Gibt das Gerät zurück, auf das sich der Vorbereiter beziehen sollte.

Returns
`ITestDevice`

Ausgabe
	com.android.tradefed.targetprep.TargetSetupError
`TargetSetupError`

getTestInfo

public TestInformation getTestInfo ()

Returns
`TestInformation`

getTestsFileName

public  getTestsFileName ()

Gibt eine Kopie der Liste der angegebenen Test-APK-Namen zurück.

Returns

isCleanUpEnabled

public boolean isCleanUpEnabled ()

Gibt „True“ zurück, wenn APKs beim Beenden des Vorgangs bereinigt werden.

Returns
`boolean`

isInstantMode

public final boolean isInstantMode ()

Gibt zurück, ob die Installation im Sofortmodus aktiviert wurde.

Returns
`boolean`

reportDependencies

public  reportDependencies ()

Returns

setAaptVersion

public void setAaptVersion (AaptParser.AaptVersion aaptVersion)

Legt die Version von AAPT für das Parsen von APKs fest.

Parameter
`aaptVersion`	`AaptParser.AaptVersion`

setAbi

public void setAbi (IAbi abi)

Parameter
`abi`	`IAbi`

setAltDir

public void setAltDir (File altDir)

Legen Sie ein alternatives Verzeichnis fest.

Parameter
`altDir`	`File`

setAltDirBehavior

public void setAltDirBehavior (AltDirBehavior altDirBehavior)

Legen Sie ein alternatives Verzeichnisverhalten fest.

Parameter
`altDirBehavior`	`AltDirBehavior`

setCleanApk

public void setCleanApk (boolean shouldClean)

Legt fest, ob die installierte APK-Datei bei tearDown bereinigt werden soll.

Parameter
`shouldClean`	`boolean`

setForceQueryable

public void setForceQueryable (boolean forceQueryable)

Der Standardwert von „force queryable“ ist „true“. Aktualisieren Sie den Wert auf „false“, wenn die zu installierende APK nicht abfragbar sein soll.

Parameter
`forceQueryable`	`boolean`

setIncrementalSetupEnabled

public void setIncrementalSetupEnabled (boolean shouldEnable)

Legen Sie fest, ob die inkrementelle Einrichtung für TradeFed-Präparatoren aktiviert werden soll.

Parameter
`shouldEnable`	`boolean`

setInstantMode

public final void setInstantMode (boolean mode)

Legt fest, ob beim Installieren des APK die Option „--instant“ verwendet werden soll. Hat keine Auswirkungen, wenn „force-install-mode“ festgelegt ist.

Parameter
`mode`	`boolean`

setShouldGrantPermission

public void setShouldGrantPermission (boolean shouldGrant)

Wenn eine userId angegeben wird, kann grantPermission für die APK-Installation festgelegt werden.

Parameter
`shouldGrant`	`boolean`

setUp

public void setUp (ITestDevice device, 
                IBuildInfo buildInfo)

Diese Methode wurde eingestellt.
Temporärer abwärtskompatibler Callback.

Parameter
`device`	`ITestDevice`
`buildInfo`	`IBuildInfo`

Ausgabe
`BuildError`
`DeviceNotAvailableException`
`TargetSetupError`

setUp

public void setUp (TestInformation testInfo)

Parameter
`testInfo`	`TestInformation`

Ausgabe
`BuildError`
`DeviceNotAvailableException`
`TargetSetupError`

setUserId

public void setUserId (int userId)

Wenn das APK für einen bestimmten Nutzer installiert werden soll, wird die ID des Nutzers festgelegt, für den die Installation erfolgen soll.

Parameter
`userId`	`int`

tearDown

public void tearDown (TestInformation testInfo, 
                Throwable e)

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

Ausgabe
`DeviceNotAvailableException`

Geschützte Methoden

getLocalPathForFilename

protected File getLocalPathForFilename (TestInformation testInfo, 
                String apkFileName)

Den tatsächlichen APK-Pfad anhand von Informationen zum Testartefakt in den Build-Informationen auflösen.

Parameter
`testInfo`	`TestInformation`: Die `TestInformation` für den Aufruf.
`apkFileName`	`String`: Dateiname der zu installierenden APK

Returns
`File`	`ERROR(/File)` für die physische APK-Datei auf dem Host oder `null`, wenn die Datei nicht vorhanden ist.

Ausgabe
`TargetSetupError`

Installationsprogramm

protected void installer (TestInformation testInfo, 
                 appFilesAndPackages)

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

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

Ausgabe
`DeviceNotAvailableException`
`TargetSetupError`

parsePackageName

protected String parsePackageName (File testAppFile)

Rufen Sie den Paketnamen der Test-App ab.

Parameter
`testAppFile`	`File`

Returns
`String`

Ausgabe
`TargetSetupError`

resolveApkFiles

protected  resolveApkFiles (TestInformation testInfo, 
                 apkFiles)

Helfer zum Auflösen einiger APKs in ihre Datei und ihr Paket.

Parameter
`testInfo`	`TestInformation`
`apkFiles`

Returns

Ausgabe
`DeviceNotAvailableException`
`TargetSetupError`

setTestInformation

protected void setTestInformation (TestInformation testInfo)

Parameter
`testInfo`	`TestInformation`

uninstallPackage

protected void uninstallPackage (ITestDevice device, 
                String packageName)

Versuchen Sie, das Paket vom Gerät zu entfernen.

Parameter
`device`	`ITestDevice`
`packageName`	`String`

Ausgabe
`DeviceNotAvailableException`