Ab dem 27. März 2025 empfehlen wir, android-latest-release anstelle von aosp-main zu verwenden, um AOSP zu erstellen und Beiträge dazu zu leisten. Weitere Informationen finden Sie unter Änderungen am AOSP.

Diese Seite wurde von der Cloud Translation API übersetzt.

BuildInfo

public class BuildInfo
extends Object implements IBuildInfo

java.lang.Object
↳	com.android.tradefed.build.BuildInfo

Bekannte direkte Unterklassen

AppBuildInfo, DeviceBuildInfo, FolderBuildInfo, OtatoolsBuildInfo

AppBuildInfo	Eine `IBuildInfo`, die eine Android-Anwendung und ihre Testpakete darstellt.
DeviceBuildInfo	Eine `IBuildInfo`, die einen vollständigen Android-Geräte-Build und (optional) die zugehörigen Tests darstellt.
FolderBuildInfo	Konkrete Implementierung einer `IFolderBuildInfo`.
OtatoolsBuildInfo	Ein `IBuildInfo`, das otatools-Artefakte enthält.

Bekannte indirekte Unterklassen

AppDeviceBuildInfo, ClusterBuildInfo, DeviceFolderBuildInfo, OtaDeviceBuildInfo

AppDeviceBuildInfo	Diese Klasse wurde eingestellt. Verwenden Sie `IDeviceBuildInfo` direkt.
ClusterBuildInfo	Eine `IBuildInfo`-Klasse für Builds, die von TFC gesendet werden.
DeviceFolderBuildInfo	Eine `IDeviceBuildInfo`, die auch andere Build-Artefakte in einem Verzeichnis im lokalen Dateisystem enthält.
OtaDeviceBuildInfo	Eine `IDeviceBuildInfo`, die für Over-the-air-Aktualisierungstests verwendet wird.

Generische Implementierung eines IBuildInfo, das mit einem ITestDevice verknüpft werden sollte.

Zusammenfassung

Öffentliche Konstruktoren
`BuildInfo()` Erstellt einen `BuildInfo` mit Standardattributwerten.
`BuildInfo(String buildId, String buildTargetName)` Erstellt einen `BuildInfo`

Öffentliche Methoden
`void`	`addAppPackageFile(File appPackageFile, String version)` Die lokale APK-Datei und die zugehörige Version werden hinzugefügt.
`void`	`addBuildAttribute(String attributeName, String attributeValue)` Fügen Sie ein Build-Attribut hinzu.
`void`	`addBuildAttributes( buildAttributes)` Build-Attribute hinzufügen
`void`	`allowStagingRemoteFile(boolean stageRemoteFile)` Hiermit wird die Berechtigung festgelegt, um das Staging remoter Dateien zuzulassen.
`void`	`cleanUp()` Temporäre Build-Dateien bereinigen
`void`	`cleanUp( doNotClean)` Version von `cleanUp()`, bei der einige Dateien nicht gelöscht werden.
`IBuildInfo`	`clone()`
`final void`	`copyAllFileFrom(BuildInfo build)` Kopieren Sie alle `VersionedFile` aus einem bestimmten Build in diesen.
`boolean`	`equals(Object obj)`
`static IBuildInfo`	`fromProto(BuildInformation.BuildInfo protoBuild)` Führen Sie den umgekehrten Vorgang zu `toProto()` aus, um die Instanz wiederherzustellen.
	`getAppPackageFiles()` Hiermit wird eine Kopie der lokalen App-APK-Dateien und ihrer Versionen abgerufen.
	`getBuildAttributes()` Eine Reihe von Name/Wert-Paaren mit zusätzlichen Attributen, die den Build beschreiben.
`String`	`getBuildBranch()` Optionale Methode, um den Quellkontrollzweig zurückzugeben, aus dem der getestete Build erstellt wurde.
`String`	`getBuildFlavor()` Optionale Methode, um den Typ des getesteten Builds zurückzugeben.
`String`	`getBuildId()` Die eindeutige Kennung des zu testenden Builds.
`String`	`getBuildTargetName()` Gibt den vollständigen Namen des getesteten Builds zurück.
`String`	`getDeviceSerial()`
`File`	`getFile(String name)` Hilfsmethode zum Abrufen einer Datei mit dem angegebenen Namen.
`File`	`getFile(BuildInfoKey.BuildInfoFileKey key)` Hilfsmethode zum Abrufen einer Datei mit einer angegebenen `BuildInfoFileKey`.
	`getFiles()` Gibt alle in diesem `BuildInfo` gespeicherten `VersionedFile` zurück.
	`getProperties()` Gibt eine Kopie der derzeit für die `IBuildInfo` festgelegten Properties zurück.
	`getRemoteFiles()` Pfade für Build-Artefakte abrufen, deren Download verzögert wird
`String`	`getTestTag()` Gibt einen eindeutigen Namen für die ausgeführten Tests zurück.
`String`	`getVersion(BuildInfoKey.BuildInfoFileKey key)` Hilfsmethode zum Abrufen einer Dateiversion mit einer angegebenen `BuildInfoFileKey`.
`String`	`getVersion(String name)` Hilfsmethode zum Abrufen einer Dateiversion mit dem angegebenen Namen.
`VersionedFile`	`getVersionedFile(BuildInfoKey.BuildInfoFileKey key)` Hilfsmethode zum Abrufen einer `VersionedFile` mit einer bestimmten `BuildInfoFileKey`.
`final VersionedFile`	`getVersionedFile(String name)` Hilfsmethode zum Abrufen einer `VersionedFile` mit einem bestimmten Namen.
	`getVersionedFileKeys()` Gibt die Schlüssel zurück, mit denen `VersionedFile` über `getFile(BuildInfoFileKey)` abgefragt werden kann.
`final`	`getVersionedFiles(BuildInfoKey.BuildInfoFileKey key)` Hilfsmethode zum Abrufen einer Liste von `VersionedFile`s, die mit einer bestimmten `BuildInfoFileKey` verknüpft sind.
`int`	`hashCode()`
`void`	`removeBuildAttribute(String attributeName)` Entfernt ein bestimmtes attributeName aus dem Tracking.
`void`	`setBuildBranch(String branch)` Build-Zweig festlegen
`void`	`setBuildFlavor(String buildFlavor)` Legen Sie die Build-Variante fest.
`void`	`setBuildId(String buildId)` Legt die eindeutige Kennung des zu testenden Builds fest.
`void`	`setDeviceSerial(String serial)` Legen Sie die `ITestDevice`-Seriennummer fest, die mit diesem Build verknüpft ist.
`void`	`setFile(String name, File file, String version)` Hier wird eine Datei mit dem angegebenen Namen gespeichert.
`void`	`setFile(BuildInfoKey.BuildInfoFileKey key, File file, String version)` Hier wird eine Datei mit einer `BuildInfoFileKey` gespeichert.
`void`	`setProperties(BuildInfoProperties... properties)` Legen Sie die `BuildInfoProperties` für die `IBuildInfo`-Instanz fest.
`void`	`setTestTag(String testTag)` Legt den eindeutigen Namen für die ausgeführten Tests fest.
`File`	`stageRemoteFile(String fileName, File workingDir)` Stellen Sie eine Datei, die zu den Remotedateien gehört, im Stammverzeichnis der Build-Informationen bereit.
`BuildInformation.BuildInfo`	`toProto()` Serialisieren Sie die BuildInfo-Instanz in einen Protobuf.
`String`	`toString()`

Geschützte Methoden
`void`	`addAllBuildAttributes(BuildInfo build)` Hilfsmethode zum Kopieren von Build-Attributen, Branches und Flavors aus einem anderen Build.
`void`	`addAllFiles(BuildInfo build)` Hilfsmethode zum Kopieren aller Dateien aus dem anderen Build.
`boolean`	`applyBuildProperties(VersionedFile origFileConsidered, IBuildInfo build, IBuildInfo receiver)` Es soll möglich sein, einige der `IBuildInfo.BuildInfoProperties` anzuwenden und gegebenenfalls eine andere Vorgehensweise zu wählen.
`MultiMap<String, String>`	`getAttributesMultiMap()`
	`getVersionedFileMap()`
`MultiMap<String, VersionedFile>`	`getVersionedFileMapFull()`

Öffentliche Konstruktoren

BuildInfo

public BuildInfo ()

Erstellt einen BuildInfo mit Standardattributwerten.

BuildInfo

public BuildInfo (String buildId, 
                String buildTargetName)

Erstellt einen BuildInfo

Parameter
`buildId`	`String`: die Build-ID
`buildTargetName`	`String`: der Name des Build-Ziels

Öffentliche Methoden

addAppPackageFile

public void addAppPackageFile (File appPackageFile, 
                String version)

Die lokale APK-Datei und die zugehörige Version werden hinzugefügt. Hinweis: APKs werden von getAppPackageFiles() in der Reihenfolge zurückgegeben, in der sie mit dieser Methode hinzugefügt wurden.

Parameter
`appPackageFile`	`File`
`version`	`String`

addBuildAttribute

public void addBuildAttribute (String attributeName, 
                String attributeValue)

Fügen Sie ein Build-Attribut hinzu. Dadurch kann ein vorhandenes Attribut nicht überschrieben werden.

Parameter
`attributeName`	`String`: der eindeutige Attributname
`attributeValue`	`String`: der Attributwert

addBuildAttributes

public void addBuildAttributes ( buildAttributes)

Build-Attribute hinzufügen

Parameter
`buildAttributes`	: Zuordnung der hinzuzufügenden Attribute

allowStagingRemoteFile

public void allowStagingRemoteFile (boolean stageRemoteFile)

Hiermit wird die Berechtigung festgelegt, um das Staging remoter Dateien zuzulassen.

Parameter
`stageRemoteFile`	`boolean`

cleanUp

public void cleanUp ()

Temporäre Build-Dateien bereinigen

cleanUp

public void cleanUp ( doNotClean)

Version von cleanUp(), bei der einige Dateien nicht gelöscht werden.

Parameter
`doNotClean`

clone

public IBuildInfo clone ()

Returns
`IBuildInfo`

copyAllFileFrom

public final void copyAllFileFrom (BuildInfo build)

Kopieren Sie alle VersionedFile aus einem bestimmten Build in diesen.

Parameter
`build`	`BuildInfo`

ist gleich

public boolean equals (Object obj)

Parameter
`obj`	`Object`

Returns
`boolean`

fromProto

public static IBuildInfo fromProto (BuildInformation.BuildInfo protoBuild)

Führen Sie den umgekehrten Vorgang zu toProto() aus, um die Instanz wiederherzustellen.

Parameter
`protoBuild`	`BuildInformation.BuildInfo`

Returns
`IBuildInfo`

getAppPackageFiles

public  getAppPackageFiles ()

Hiermit wird eine Kopie der lokalen App-APK-Dateien und ihrer Versionen abgerufen. Die zurückgegebene Reihenfolge stimmt mit der Reihenfolge überein, in der die APKs der IAppBuildInfo hinzugefügt wurden.

Returns

getBuildAttributes

public  getBuildAttributes ()

Eine Reihe von Name/Wert-Paaren mit zusätzlichen Attributen, die den Build beschreiben.

Returns
	eine `ERROR(/Map)` von Build-Attributen. Muss nicht `null` sein, kann aber leer sein.

getBuildBranch

public String getBuildBranch ()

Optionale Methode, um den Quellkontrollzweig zurückzugeben, aus dem der getestete Build erstellt wurde.

Returns
`String`	den Build-Branch oder `null`, wenn nicht festgelegt/nicht zutreffend

getBuildFlavor

public String getBuildFlavor ()

Optionale Methode, um den Typ des getesteten Builds zurückzugeben.

Eine gängige Implementierung für Builds der Android-Plattform ist die Rückgabe von (Build-Produkt)-(Build-Betriebssystem)-(Build-Variante). ie generic-linux-userdebug

Returns
`String`	die Build-Variante oder `null`, wenn nicht festgelegt/nicht zutreffend

getBuildId

public String getBuildId ()

Die eindeutige Kennung des zu testenden Builds. Darf niemals null sein. Die Standardeinstellung ist UNKNOWN_BUILD_ID.

Returns
`String`

getBuildTargetName

public String getBuildTargetName ()

Gibt den vollständigen Namen des getesteten Builds zurück.

Eine gängige Implementierung besteht darin, den Namen des Build-Ziels aus einer Kombination aus Build-Variante und Branch-Namen zu erstellen. [z. B. (Branch-Name)-(Build-Variante)]

Returns
`String`

getDeviceSerial

public String getDeviceSerial ()

Returns
`String`

getFile

public File getFile (String name)

Hilfsmethode zum Abrufen einer Datei mit dem angegebenen Namen.

Returns
`File`	die Bilddatei oder `null`, falls nicht gefunden

getFile

public File getFile (BuildInfoKey.BuildInfoFileKey key)

Hilfsmethode zum Abrufen einer Datei mit einer angegebenen BuildInfoFileKey.

Parameter
`key`	`BuildInfoKey.BuildInfoFileKey`: die angeforderte `BuildInfoFileKey`.

Returns
`File`	die Bilddatei oder `null`, falls nicht gefunden

getFiles

public  getFiles ()

Gibt alle in diesem BuildInfo gespeicherten VersionedFile zurück.

Returns

getProperties

public  getProperties ()

Gibt eine Kopie der derzeit für die IBuildInfo festgelegten Properties zurück.

Returns

getRemoteFiles

public  getRemoteFiles ()

Pfade für Build-Artefakte abrufen, deren Download verzögert wird

Returns

getTestTag

public String getTestTag ()

Gibt einen eindeutigen Namen für die ausgeführten Tests zurück.

Returns
`String`

getVersion

public String getVersion (BuildInfoKey.BuildInfoFileKey key)

Hilfsmethode zum Abrufen einer Dateiversion mit einer angegebenen BuildInfoFileKey.

Parameter
`key`	`BuildInfoKey.BuildInfoFileKey`: Die angeforderte `BuildInfoFileKey`.

Returns
`String`	die Bildversion oder `null`, falls nicht gefunden

getVersion

public String getVersion (String name)

Hilfsmethode zum Abrufen einer Dateiversion mit dem angegebenen Namen.

Returns
`String`	die Bildversion oder `null`, falls nicht gefunden

getVersionedFile

public VersionedFile getVersionedFile (BuildInfoKey.BuildInfoFileKey key)

Hilfsmethode zum Abrufen einer VersionedFile mit einer bestimmten BuildInfoFileKey.

Parameter
`key`	`BuildInfoKey.BuildInfoFileKey`: Die angeforderte `BuildInfoFileKey`.

Returns
`VersionedFile`	Die versionierte Datei oder `null`, falls nicht gefunden

getVersionedFile

public final VersionedFile getVersionedFile (String name)

Hilfsmethode zum Abrufen einer VersionedFile mit einem bestimmten Namen.

Returns
`VersionedFile`	Die versionierte Datei oder `null`, falls nicht gefunden

getVersionedFileKeys

public  getVersionedFileKeys ()

Gibt die Schlüssel zurück, mit denen VersionedFile über getFile(BuildInfoFileKey) abgefragt werden kann.

Returns

getVersionedFiles

public final  getVersionedFiles (BuildInfoKey.BuildInfoFileKey key)

Hilfsmethode zum Abrufen einer Liste von VersionedFiles, die mit einer bestimmten BuildInfoFileKey verknüpft sind. Ob der Schlüssel das Speichern einer Liste zulässt.

Parameter
`key`	`BuildInfoKey.BuildInfoFileKey`: Die angeforderte `BuildInfoFileKey`.

Returns
	Die versionierte Datei oder `null`, falls nicht gefunden

hashCode

public int hashCode ()

Returns
`int`

removeBuildAttribute

public void removeBuildAttribute (String attributeName)

Entfernt ein bestimmtes attributeName aus dem Tracking.

Parameter
`attributeName`	`String`: das Attribut, für das das Tracking beendet werden soll

setBuildBranch

public void setBuildBranch (String branch)

Build-Zweig festlegen

Parameter
`branch`	`String`: den Namen des Branches

setBuildFlavor

public void setBuildFlavor (String buildFlavor)

Legen Sie die Build-Variante fest.

setBuildId

public void setBuildId (String buildId)

Legt die eindeutige Kennung des zu testenden Builds fest. Darf niemals null sein.

Parameter
`buildId`	`String`

setDeviceSerial

public void setDeviceSerial (String serial)

Legen Sie die mit diesem Build verknüpfte ITestDevice-Seriennummer fest.

Parameter
`serial`	`String`: die Seriennummer der `ITestDevice`, mit der dieser Build ausgeführt wurde.

setFile

public void setFile (String name, 
                File file, 
                String version)

Hier wird eine Datei mit dem angegebenen Namen gespeichert.

Parameter
`name`	`String`: der eindeutige Name der Datei
`file`	`File`: die lokale `ERROR(/File)`
`version`	`String`: die Dateiversion

setFile

public void setFile (BuildInfoKey.BuildInfoFileKey key, 
                File file, 
                String version)

Hier wird eine Datei mit einer BuildInfoFileKey gespeichert.

Parameter
`key`	`BuildInfoKey.BuildInfoFileKey`: der eindeutige Name der Datei, der auf `BuildInfoFileKey` basiert.
`file`	`File`: die lokale `ERROR(/File)`
`version`	`String`: die Dateiversion

setProperties

public void setProperties (BuildInfoProperties... properties)

Legen Sie die BuildInfoProperties für die IBuildInfo-Instanz fest. Vorhandene Eigenschaften werden überschrieben.

Parameter
`properties`	`BuildInfoProperties`: Die Liste der hinzuzufügenden Properties.

setTestTag

public void setTestTag (String testTag)

Legt den eindeutigen Namen für die ausgeführten Tests fest.

Parameter
`testTag`	`String`

stageRemoteFile

public File stageRemoteFile (String fileName, 
                File workingDir)

Stellen Sie eine Datei, die zu den Remotedateien gehört, im Stammverzeichnis der Build-Informationen bereit.

TODO(b/138416078): Diese Schnittstelle und ihren Aufrufer entfernen, wenn Module, die für einen Test erforderlich sind, richtig erstellt und in das Verzeichnis des Testmoduls selbst ausgegeben werden können.

Parameter
`fileName`	`String`: Name der Datei, die in Remotedateien gefunden werden soll.
`workingDir`	`File`: ein `ERROR(/File)`-Objekt des Verzeichnisses, in dem die Datei bereitgestellt werden soll.

Returns
`File`	das `ERROR(/File)`-Objekt der Datei, die im lokalen Arbeitsverzeichnis bereitgestellt wurde.

toProto

public BuildInformation.BuildInfo toProto ()

Serialisieren Sie die BuildInfo-Instanz in einen Protobuf.

Returns
`BuildInformation.BuildInfo`

toString

public String toString ()

Returns
`String`

Geschützte Methoden

addAllBuildAttributes

protected void addAllBuildAttributes (BuildInfo build)

Hilfsmethode zum Kopieren von Build-Attributen, Branches und Flavors aus einem anderen Build.

Parameter
`build`	`BuildInfo`

addAllFiles

protected void addAllFiles (BuildInfo build)

Hilfsmethode zum Kopieren aller Dateien aus dem anderen Build.

Es werden neue Hardlinks zu den Dateien erstellt, sodass jeder Build einen eindeutigen Dateipfad zur Datei hat.

Parameter
`build`	`BuildInfo`

Ausgabe
	wenn beim Erstellen des Hardlinks eine Ausnahme ausgelöst wird.

applyBuildProperties

protected boolean applyBuildProperties (VersionedFile origFileConsidered, 
                IBuildInfo build, 
                IBuildInfo receiver)

Es soll möglich sein, einige der IBuildInfo.BuildInfoProperties anzuwenden und gegebenenfalls eine andere Vorgehensweise zu wählen.

Parameter
`origFileConsidered`	`VersionedFile`: Die aktuell angezeigte `VersionedFile`.
`build`	`IBuildInfo`: der ursprüngliche Build, der geklont wird
`receiver`	`IBuildInfo`: Der Build, der die Informationen empfängt.

Returns
`boolean`	„Wahr“, wenn wir die Properties angewendet haben und die weitere Verarbeitung übersprungen werden soll. Andernfalls „false“.

getAttributesMultiMap

protected MultiMap<String, String> getAttributesMultiMap ()

Returns
`MultiMap<String, String>`

getVersionedFileMap

protected  getVersionedFileMap ()

Returns

getVersionedFileMapFull

protected MultiMap<String, VersionedFile> getVersionedFileMapFull ()

Returns
`MultiMap<String, VersionedFile>`