BuildInfo

public class BuildInfo
extends Object implements IBuildInfo

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

Bekannte direkte Unterklassen AppBuildInfo, DeviceBuildInfo, FolderBuildInfo, OtatoolsBuildInfo AppBuildInfo Ein IBuildInfo, das eine Android-App 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. IDeviceBuildInfo direkt verwenden.  ClusterBuildInfo Eine IBuildInfo-Klasse für Builds, die aus TFC weitergeleitet werden.  DeviceFolderBuildInfo Ein IDeviceBuildInfo, das auch andere Build-Artefakte enthält, die sich in einem Verzeichnis im lokalen Dateisystem befinden.  OtaDeviceBuildInfo Eine IDeviceBuildInfo, die für OTA-Update-Tests verwendet wird.

---

Allgemeine Implementierung eines IBuildInfo, der mit einem ITestDevice verknüpft werden sollte.

Zusammenfassung

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

Öffentliche Methoden
void	addAppPackageFile(File appPackageFile, String version) Fügt die lokale APK-Datei und die zugehörige Version hinzu.
void	addBuildAttribute(String attributeName, String attributeValue) Fügen Sie ein Build-Attribut hinzu.
void	addBuildAttributes(Map<String, String> buildAttributes) Build-Attribute hinzufügen
void	allowStagingRemoteFile(boolean stageRemoteFile) Legt die Berechtigung zum Staging von Remotedateien fest.
void	cleanUp() Temporäre Build-Dateien löschen
void	cleanUp(List<File> doNotClean) Version von cleanUp(), in der einige Dateien nicht gelöscht werden.
IBuildInfo	clone()
final void	copyAllFileFrom(BuildInfo build) Kopiere alle VersionedFile aus einem bestimmten Build in diesen.
boolean	equals(Object obj)
static IBuildInfo	fromProto(BuildInformation.BuildInfo protoBuild) Umgekehrter Vorgang zu toProto(), um die Instanz wiederherzustellen.
List<VersionedFile>	getAppPackageFiles() Ruft eine Kopie der lokalen APK-Datei(en) der App und ihrer Versionen ab.
Map<String, String>	getBuildAttributes() Ruft eine Reihe von Name/Wert-Paaren mit zusätzlichen Attributen ab, die den Build beschreiben.
String	getBuildBranch() Optionale Methode zum Zurückgeben des Quellcodeverwaltungszweigs, aus dem der zu testende Build erstellt wurde.
String	getBuildFlavor() Optionale Methode zum Zurückgeben des Typs des Builds, der getestet wird.
String	getBuildId() Gibt die eindeutige Kennung des zu testenden Builds zurück.
String	getBuildTargetName() Gibt den vollständigen Namen des Builds zurück, der getestet wird.
String	getDeviceSerial()
File	getFile(String name) Hilfsmethode zum Abrufen einer Datei mit einem bestimmten Namen.
File	getFile(BuildInfoKey.BuildInfoFileKey key) Hilfsmethode zum Abrufen einer Datei mit einem bestimmten BuildInfoFileKey.
Collection<VersionedFile>	getFiles() Gibt alle in diesem BuildInfo gespeicherten VersionedFiles zurück.
Set<IBuildInfo.BuildInfoProperties>	getProperties() Gibt eine Kopie der derzeit für die IBuildInfo festgelegten Eigenschaften zurück.
Set<File>	getRemoteFiles() Ruft die Pfade für Build-Artefakte ab, die verzögert heruntergeladen werden.
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 bestimmten BuildInfoFileKey.
String	getVersion(String name) Hilfsmethode zum Abrufen einer Dateiversion mit dem angegebenen Namen.
VersionedFile	getVersionedFile(BuildInfoKey.BuildInfoFileKey key) Hilfsmethode zum Abrufen eines VersionedFile mit einem bestimmten BuildInfoFileKey.
final VersionedFile	getVersionedFile(String name) Hilfsmethode zum Abrufen eines VersionedFile mit einem bestimmten Namen.
Set<String>	getVersionedFileKeys() Gibt die Menge der Schlüssel zurück, die für die Abfrage von VersionedFile über getFile(BuildInfoFileKey) verfügbar sind.
final List<VersionedFile>	getVersionedFiles(BuildInfoKey.BuildInfoFileKey key) Hilfsmethode zum Abrufen einer Liste von VersionedFiles, die mit einem bestimmten BuildInfoFileKey verknüpft sind.
int	hashCode()
void	removeBuildAttribute(String attributeName) Entfernt einen bestimmten „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 für diesen Build fest.
void	setFile(BuildInfoKey.BuildInfoFileKey key, File file, String version) Speichert eine Datei anhand einer BuildInfoFileKey in diesen Build-Informationen.
void	setFile(String name, File file, String version) Speichert eine Datei mit dem angegebenen Namen in diesen Build-Informationen.
void	setProperties(BuildInfoProperties... properties) Legen Sie den 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 bereit, die Teil von Remote-Dateien im Stammverzeichnis der Build-Informationen ist.
BuildInformation.BuildInfo	toProto() Serialisiert die BuildInfo-Instanz in einen Protokollpuffer.
String	toString()

Geschützte Methoden
void	addAllBuildAttributes(BuildInfo build) Helper-Methode zum Kopieren von Build-Attributen, Branch und Variante 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) Einige der IBuildInfo.BuildInfoProperties können angewendet werden und es ist möglicherweise eine andere Vorgehensweise erforderlich.
MultiMap<String, String>	getAttributesMultiMap()
Map<String, VersionedFile>	getVersionedFileMap()
MultiMap<String, VersionedFile>	getVersionedFileMapFull()

Öffentliche Konstruktoren

BuildInfo

public BuildInfo ()

Erstellt einen BuildInfo mit Standardattributwerten.

BuildInfo

public BuildInfo (String buildId, 
                String buildTargetName)

Erstellt eine BuildInfo.

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

Öffentliche Methoden

addAppPackageFile

public void addAppPackageFile (File appPackageFile, 
                String version)

Fügt die lokale APK-Datei und die zugehörige Version hinzu. 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. Ein vorhandener „attributeName“ kann dadurch nicht überschrieben werden.

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

addBuildAttributes

public void addBuildAttributes (Map<String, String> buildAttributes)

Build-Attribute hinzufügen

Parameter
buildAttributes	Map: Zuordnung der hinzuzufügenden Attribute

allowStagingRemoteFile

public void allowStagingRemoteFile (boolean stageRemoteFile)

Legt die Berechtigung zum Staging von Remotedateien fest.

Parameter
stageRemoteFile	boolean

cleanUp

public void cleanUp ()

Temporäre Build-Dateien löschen

cleanUp

public void cleanUp (List<File> doNotClean)

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

Parameter
doNotClean	List

clone

public IBuildInfo clone ()

Gibt Folgendes zurück:
IBuildInfo

copyAllFileFrom

public final void copyAllFileFrom (BuildInfo build)

Kopiere alle VersionedFile aus einem bestimmten Build in diesen.

Parameter
build	BuildInfo

ist gleich

public boolean equals (Object obj)

Parameter
obj	Object

Gibt Folgendes zurück:
boolean

fromProto

public static IBuildInfo fromProto (BuildInformation.BuildInfo protoBuild)

Umgekehrter Vorgang zu toProto(), um die Instanz wiederherzustellen.

Parameter
protoBuild	BuildInformation.BuildInfo

Gibt Folgendes zurück:
IBuildInfo

getAppPackageFiles

public List<VersionedFile> getAppPackageFiles ()

Ruft eine Kopie der lokalen APK-Datei(en) der App und ihrer Versionen ab. Die zurückgegebene Reihenfolge entspricht der Reihenfolge, in der die APKs dem IAppBuildInfo hinzugefügt wurden.

Gibt Folgendes zurück:
List<VersionedFile>

getBuildAttributes

public Map<String, String> getBuildAttributes ()

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

Gibt Folgendes zurück:
Map<String, String>	Map mit Build-Attributen. Darf nicht null sein, kann aber leer sein.

getBuildBranch

public String getBuildBranch ()

Optionale Methode zum Zurückgeben des Quellcodeverwaltungszweigs, aus dem der zu testende Build erstellt wurde.

Gibt Folgendes zurück:
String	Der Build-Branch oder null, falls nicht festgelegt/nicht zutreffend

getBuildFlavor

public String getBuildFlavor ()

Optionale Methode zum Zurückgeben des Typs des Builds, der getestet wird.

Eine gängige Implementierung für Android-Plattform-Builds gibt (Build-Produkt)-(Build-Betriebssystem)-(Build-Variante) zurück. z. B. generic-linux-userdebug

Gibt Folgendes zurück:
String	Der Build-Flavor oder null, falls nicht festgelegt oder nicht zutreffend

getBuildId

public String getBuildId ()

Gibt die eindeutige Kennung des zu testenden Builds zurück. Darf nie null sein. Die Standardeinstellung ist UNKNOWN_BUILD_ID.

Gibt Folgendes zurück:
String

getBuildTargetName

public String getBuildTargetName ()

Gibt den vollständigen Namen des Builds zurück, der getestet wird.

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)]

Gibt Folgendes zurück:
String

getDeviceSerial

public String getDeviceSerial ()

Gibt Folgendes zurück:
String

getFile

public File getFile (String name)

Hilfsmethode zum Abrufen einer Datei mit einem bestimmten Namen.

Gibt Folgendes zurück:
File	die Bilddatei oder null, falls nicht gefunden

getFile

public File getFile (BuildInfoKey.BuildInfoFileKey key)

Hilfsmethode zum Abrufen einer Datei mit einem bestimmten BuildInfoFileKey.

Parameter
key	BuildInfoKey.BuildInfoFileKey: Die angeforderte BuildInfoFileKey.

Gibt Folgendes zurück:
File	die Bilddatei oder null, falls nicht gefunden

getFiles

public Collection<VersionedFile> getFiles ()

Gibt alle in diesem BuildInfo gespeicherten VersionedFiles zurück.

Gibt Folgendes zurück:
Collection<VersionedFile>

getProperties

public Set<IBuildInfo.BuildInfoProperties> getProperties ()

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

Gibt Folgendes zurück:
Set<IBuildInfo.BuildInfoProperties>

getRemoteFiles

public Set<File> getRemoteFiles ()

Ruft die Pfade für Build-Artefakte ab, die verzögert heruntergeladen werden.

Gibt Folgendes zurück:
Set<File>

getTestTag

public String getTestTag ()

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

Gibt Folgendes zurück:
String

getVersion

public String getVersion (BuildInfoKey.BuildInfoFileKey key)

Hilfsmethode zum Abrufen einer Dateiversion mit einer bestimmten BuildInfoFileKey.

Parameter
key	BuildInfoKey.BuildInfoFileKey: Die angeforderte BuildInfoFileKey.

Gibt Folgendes zurück:
String	die Bildversion oder null, falls nicht gefunden

getVersion

public String getVersion (String name)

Hilfsmethode zum Abrufen einer Dateiversion mit dem angegebenen Namen.

Gibt Folgendes zurück:
String	die Bildversion oder null, falls nicht gefunden

getVersionedFile

public VersionedFile getVersionedFile (BuildInfoKey.BuildInfoFileKey key)

Hilfsmethode zum Abrufen eines VersionedFile mit einem bestimmten BuildInfoFileKey.

Parameter
key	BuildInfoKey.BuildInfoFileKey: Die angeforderte BuildInfoFileKey.

Gibt Folgendes zurück:
VersionedFile	Die versionierte Datei oder null, falls nicht gefunden

getVersionedFile

public final VersionedFile getVersionedFile (String name)

Hilfsmethode zum Abrufen eines VersionedFile mit einem bestimmten Namen.

Gibt Folgendes zurück:
VersionedFile	Die versionierte Datei oder null, falls nicht gefunden

getVersionedFileKeys

public Set<String> getVersionedFileKeys ()

Gibt die Menge der Schlüssel zurück, die für die Abfrage von VersionedFile über getFile(BuildInfoFileKey) verfügbar sind.

Gibt Folgendes zurück:
Set<String>

getVersionedFiles

public final List<VersionedFile> getVersionedFiles (BuildInfoKey.BuildInfoFileKey key)

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

Parameter
key	BuildInfoKey.BuildInfoFileKey: Die angeforderte BuildInfoFileKey.

Gibt Folgendes zurück:
List<VersionedFile>	Die versionierte Datei oder null, falls nicht gefunden

hashCode

public int hashCode ()

Gibt Folgendes zurück:
int

removeBuildAttribute

public void removeBuildAttribute (String attributeName)

Entfernt einen bestimmten „attributeName“ aus dem Tracking.

Parameter
attributeName	String: das Attribut, dessen Tracking beendet werden soll

setBuildBranch

public void setBuildBranch (String branch)

Build-Zweig festlegen

Parameter
branch	String: der Name des Branch

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 nie null sein.

Parameter
buildId	String

setDeviceSerial

public void setDeviceSerial (String serial)

Legen Sie die ITestDevice-Seriennummer für diesen Build fest.

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

setFile

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

Speichert eine Datei anhand einer BuildInfoFileKey in diesen Build-Informationen.

Parameter
key	BuildInfoKey.BuildInfoFileKey: Der eindeutige Name der Datei basierend auf BuildInfoFileKey.
file	File: die lokale File
version	String: die Dateiversion

setFile

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

Speichert eine Datei mit dem angegebenen Namen in diesen Build-Informationen.

Parameter
name	String: der eindeutige Name der Datei
file	File: die lokale File
version	String: die Dateiversion

setProperties

public void setProperties (BuildInfoProperties... properties)

Legen Sie den BuildInfoProperties für die IBuildInfo-Instanz fest. Alle zuvor festgelegten 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 bereit, die Teil von Remote-Dateien im Stammverzeichnis der Build-Informationen ist.

TODO(b/138416078): Entfernen Sie diese Schnittstelle und den Aufrufer, wenn Module, die für einen Test erforderlich sind, ordnungsgemäß in das Verzeichnis des Testmoduls selbst ausgegeben werden können.

Parameter
fileName	String: Name der Datei, die sich in den Remotedateien befinden soll.
workingDir	File: Ein File-Objekt des Verzeichnisses, in dem die Datei bereitgestellt werden soll.

Gibt Folgendes zurück:
File	Das File-Objekt der Datei, die im lokalen workingDir bereitgestellt wird.

toProto

public BuildInformation.BuildInfo toProto ()

Serialisiert die BuildInfo-Instanz in einen Protokollpuffer.

Gibt Folgendes zurück:
BuildInformation.BuildInfo

toString

public String toString ()

Gibt Folgendes zurück:
String

Geschützte Methoden

addAllBuildAttributes

protected void addAllBuildAttributes (BuildInfo build)

Helper-Methode zum Kopieren von Build-Attributen, Branch und Variante aus einem anderen Build.

Parameter
build	BuildInfo

addAllFiles

protected void addAllFiles (BuildInfo build)

Hilfsmethode zum Kopieren aller Dateien aus dem anderen Build.

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

Parameter
build	BuildInfo

Löst aus
IOException	wenn beim Erstellen des Hardlinks eine Ausnahme ausgelöst wird.

applyBuildProperties

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

Einige der IBuildInfo.BuildInfoProperties können angewendet werden und es ist möglicherweise eine andere Vorgehensweise erforderlich.

Parameter
origFileConsidered	VersionedFile: Die aktuell betrachtete VersionedFile.
build	IBuildInfo: der ursprüngliche Build, der geklont wird
receiver	IBuildInfo: Der Build, der die Informationen erhält.

Gibt Folgendes zurück:
boolean	„true“, wenn die Eigenschaften angewendet wurden und die weitere Verarbeitung übersprungen werden sollte. Andernfalls „false“.

getAttributesMultiMap

protected MultiMap<String, String> getAttributesMultiMap ()

Gibt Folgendes zurück:
MultiMap<String, String>

getVersionedFileMap

protected Map<String, VersionedFile> getVersionedFileMap ()

Gibt Folgendes zurück:
Map<String, VersionedFile>

getVersionedFileMapFull

protected MultiMap<String, VersionedFile> getVersionedFileMapFull ()

Gibt Folgendes zurück:
MultiMap<String, VersionedFile>