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ätebuild und (optional) seine Tests darstellt. FolderBuildInfo Konkrete Implementierung einer IFolderBuildInfo . OtatoolsBuildInfo Eine IBuildInfo , die Otatools-Artefakte enthält.

Bekannte indirekte Unterklassen AppDeviceBuildInfo , ClusterBuildInfo , DeviceFolderBuildInfo , OtaDeviceBuildInfo AppDeviceBuildInfo Diese Klasse ist veraltet. Verwenden Sie IDeviceBuildInfo direkt. ClusterBuildInfo Eine IBuildInfo Klasse für Builds, die von TFC geleitet werden. DeviceFolderBuildInfo Eine IDeviceBuildInfo , die auch andere Buildartefakte enthält, die in einem Verzeichnis im lokalen Dateisystem enthalten sind. OtaDeviceBuildInfo Eine IDeviceBuildInfo , die zum Testen von Over-the-Air-Updates verwendet wird.

---

Generische Implementierung einer IBuildInfo , die einem ITestDevice zugeordnet werden sollte.

Zusammenfassung

Öffentliche Konstrukteure
BuildInfo () Erstellt eine BuildInfo unter Verwendung von 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 ( buildAttributes) addBuildAttributes ( buildAttributes) Build-Attribute hinzufügen
void	cleanUp () Bereinigen Sie alle temporären Build-Dateien
void	cleanUp ( doNotClean) cleanUp ( doNotClean) Version von cleanUp() , bei der einige Dateien nicht gelöscht werden.
IBuildInfo	clone ()
final void	copyAllFileFrom ( BuildInfo build) Kopieren Sie die gesamte VersionedFile von einem bestimmten Build in diesen.
boolean	equals (Object obj)
static IBuildInfo	fromProto (BuildInformation.BuildInfo protoBuild) Inverse Operation zu toProto() , um die Instanz zurückzubekommen.
	getAppPackageFiles () Ruft eine Kopie des Satzes lokaler App-APK-Dateien und ihrer Versionen ab.
	getBuildAttributes () Rufen Sie eine Reihe von Name-Wert-Paaren zusätzlicher Attribute ab, die den Build beschreiben.
String	getBuildBranch () Optionale Methode zum Zurückgeben des Zweigs der Quellcodeverwaltung, aus dem der getestete Build erstellt wurde.
String	getBuildFlavor () Optionale Methode zum Zurückgeben des Typs des getesteten Builds.
String	getBuildId () Gibt den eindeutigen Bezeichner des zu testenden Builds zurück.
String	getBuildTargetName () Vollständigen Namen für den getesteten Build zurückgeben.
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 gegebenen BuildInfoFileKey .
	getFiles () Gibt alle VersionedFile s zurück, die in dieser BuildInfo gespeichert sind.
	getProperties () Gibt eine Kopie der aktuell für IBuildInfo festgelegten Eigenschaften zurück.
	getRemoteFiles () Rufen Sie die Pfade für Buildartefakte ab, die verzögert heruntergeladen werden.
String	getTestTag () Geben Sie einen eindeutigen Namen für die ausgeführten Tests zurück.
String	getVersion ( BuildInfoKey.BuildInfoFileKey key) Hilfsmethode zum Abrufen einer Dateiversion mit einem gegebenen BuildInfoFileKey .
String	getVersion (String name) Hilfsmethode zum Abrufen einer Dateiversion mit einem bestimmten Namen.
VersionedFile	getVersionedFile ( BuildInfoKey.BuildInfoFileKey key) Hilfsmethode zum Abrufen einer VersionedFile mit einem bestimmten BuildInfoFileKey .
final VersionedFile	getVersionedFile (String name) Hilfsmethode zum Abrufen einer VersionedFile mit einem bestimmten Namen.
	getVersionedFileKeys () Gibt den Schlüsselsatz zurück, der für die Abfrage VersionedFile über getFile(BuildInfoFileKey) verfügbar ist.
final	getVersionedFiles ( BuildInfoKey.BuildInfoFileKey key) Hilfsmethode zum Abrufen einer Liste von VersionedFile s , die einem bestimmten BuildInfoFileKey zugeordnet sind.
int	hashCode ()
void	removeBuildAttribute (String attributeName) Entfernt einen angegebenen attributeName aus dem Tracking.
void	setBuildBranch (String branch) Legen Sie den Build-Branch fest
void	setBuildFlavor (String buildFlavor) Stellen Sie den Build-Flavor ein.
void	setBuildId (String buildId) Legt die eindeutige Kennung des zu testenden Builds fest.
void	setDeviceSerial (String serial) Legen Sie die ITestDevice Seriennummer fest, die diesem Build zugeordnet ist.
void	setFile (String name, File file, String version) Speichert eine Datei mit dem angegebenen Namen in dieser Build-Info.
void	setFile ( BuildInfoKey.BuildInfoFileKey key, File file, String version) Speichert eine Datei mit einem BuildInfoFileKey in dieser Build-Info.
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) Staging einer Datei, die Teil von Remote-Dateien im Stammverzeichnis der Build-Informationen ist.
BuildInformation.BuildInfo	toProto () Serialisieren Sie die BuildInfo-Instanz in ein Protobuf.
String	toString ()

Geschützte Methoden
void	addAllBuildAttributes ( BuildInfo build) Hilfsmethode zum Kopieren von Build-Attributen, Branch und Flavor von anderen Builds.
void	addAllFiles ( BuildInfo build) Hilfsmethode zum Kopieren aller Dateien aus dem anderen Build.
boolean	applyBuildProperties ( VersionedFile origFileConsidered, IBuildInfo build, IBuildInfo receiver) Erlauben Sie, einige der IBuildInfo.BuildInfoProperties anzuwenden und möglicherweise eine andere Handhabung vorzunehmen.
MultiMap <String, String>	getAttributesMultiMap ()
	getVersionedFileMap ()
MultiMap <String, VersionedFile >	getVersionedFileMapFull ()

Öffentliche Konstrukteure

BuildInfo

public BuildInfo ()

Erstellt eine BuildInfo unter Verwendung von 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. Beachten Sie, dass apks von getAppPackageFiles() in der Reihenfolge zurückgegeben werden, in der sie von 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 ist es nicht möglich, einen vorhandenen attributeName zu überschreiben.

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

addBuildAttributes

public void addBuildAttributes ( buildAttributes)

Build-Attribute hinzufügen

Parameter
buildAttributes	: Karte der hinzuzufügenden Attribute

Aufräumen

public void cleanUp ()

Bereinigen Sie alle temporären Build-Dateien

Aufräumen

public void cleanUp ( doNotClean)

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

Parameter
doNotClean

Klon

public IBuildInfo clone ()

Kehrt zurück
IBuildInfo

copyAllFileFrom

public final void copyAllFileFrom (BuildInfo build)

Kopieren Sie die gesamte VersionedFile von einem bestimmten Build in diesen.

Parameter
build	BuildInfo

gleich

public boolean equals (Object obj)

Parameter
obj	Object

Kehrt zurück
boolean

vonProto

public static IBuildInfo fromProto (BuildInformation.BuildInfo protoBuild)

Inverse Operation zu toProto() , um die Instanz zurückzubekommen.

Parameter
protoBuild	BuildInformation.BuildInfo

Kehrt zurück
IBuildInfo

getAppPackageFiles

public  getAppPackageFiles ()

Ruft eine Kopie des Satzes lokaler App-APK-Dateien und ihrer Versionen ab. Die zurückgegebene Reihenfolge stimmt mit der Reihenfolge überein, in der die APKs zu IAppBuildInfo hinzugefügt wurden.

Kehrt zurück

getBuildAttributes

public  getBuildAttributes ()

Rufen Sie eine Reihe von Name-Wert-Paaren zusätzlicher Attribute ab, die den Build beschreiben.

Kehrt zurück
	ein ERROR(/Map) von Build-Attributen. Wird nicht null sein, kann aber leer sein.

getBuildBranch

public String getBuildBranch ()

Optionale Methode zum Zurückgeben des Zweigs der Quellcodeverwaltung, aus dem der getestete Build erstellt wurde.

Kehrt zurück
String	der Build-Zweig oder null , wenn nicht festgelegt/nicht zutreffend

getBuildFlavor

public String getBuildFlavor ()

Optionale Methode zum Zurückgeben des Typs des getesteten Builds.

Eine gängige Implementierung für Android-Plattform-Builds ist die Rückgabe von (Build-Produkt)-(Build-OS)-(Build-Variante). dh generisch-linux-userdebug

Kehrt zurück
String	die Build-Variante oder null , falls nicht festgelegt/nicht zutreffend

getBuildId

public String getBuildId ()

Gibt den eindeutigen Bezeichner des zu testenden Builds zurück. Sollte niemals null sein. Standardmäßig UNKNOWN_BUILD_ID .

Kehrt zurück
String

getBuildZielname

public String getBuildTargetName ()

Vollständigen Namen für den getesteten Build zurückgeben.

Eine übliche Implementierung besteht darin, den Build-Target-Namen aus einer Kombination aus Build-Flavor und Branch-Namen zu erstellen. [d. h. (Zweigname)-(Build-Flavor)]

Kehrt zurück
String

getDeviceSerial

public String getDeviceSerial ()

Kehrt zurück
String

eine Datei bekommen

public File getFile (String name)

Hilfsmethode zum Abrufen einer Datei mit einem bestimmten Namen.

Kehrt zurück
File	die Bilddatei oder null , wenn sie nicht gefunden wird

eine Datei bekommen

public File getFile (BuildInfoKey.BuildInfoFileKey key)

Hilfsmethode zum Abrufen einer Datei mit einem gegebenen BuildInfoFileKey .

Parameter
key	BuildInfoKey.BuildInfoFileKey : der angeforderte BuildInfoFileKey .

Kehrt zurück
File	die Bilddatei oder null , wenn sie nicht gefunden wird

getFiles

public  getFiles ()

Gibt alle VersionedFile s zurück, die in dieser BuildInfo gespeichert sind.

Kehrt zurück

getProperties

public  getProperties ()

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

Kehrt zurück

getRemoteFiles

public  getRemoteFiles ()

Rufen Sie die Pfade für Buildartefakte ab, die verzögert heruntergeladen werden.

Kehrt zurück

getTestTag

public String getTestTag ()

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

Kehrt zurück
String

getVersion

public String getVersion (BuildInfoKey.BuildInfoFileKey key)

Hilfsmethode zum Abrufen einer Dateiversion mit einem gegebenen BuildInfoFileKey .

Parameter
key	BuildInfoKey.BuildInfoFileKey : Der angeforderte BuildInfoFileKey .

Kehrt zurück
String	die Image-Version oder null , wenn sie nicht gefunden wird

getVersion

public String getVersion (String name)

Hilfsmethode zum Abrufen einer Dateiversion mit einem bestimmten Namen.

Kehrt zurück
String	die Image-Version oder null , wenn sie nicht gefunden wird

getVersionedFile

public VersionedFile getVersionedFile (BuildInfoKey.BuildInfoFileKey key)

Hilfsmethode zum Abrufen einer VersionedFile mit einem bestimmten BuildInfoFileKey .

Parameter
key	BuildInfoKey.BuildInfoFileKey : Der angeforderte BuildInfoFileKey .

Kehrt zurück
VersionedFile	Die versionierte Datei oder null , wenn sie nicht gefunden wird

getVersionedFile

public final VersionedFile getVersionedFile (String name)

Hilfsmethode zum Abrufen einer VersionedFile mit einem bestimmten Namen.

Kehrt zurück
VersionedFile	Die versionierte Datei oder null , wenn sie nicht gefunden wird

getVersionedFileKeys

public  getVersionedFileKeys ()

Gibt den Schlüsselsatz zurück, der für die Abfrage VersionedFile über getFile(BuildInfoFileKey) verfügbar ist.

Kehrt zurück

getVersionedFiles

public final  getVersionedFiles (BuildInfoKey.BuildInfoFileKey key)

Hilfsmethode zum Abrufen einer Liste von VersionedFile s , die einem bestimmten BuildInfoFileKey zugeordnet sind. Wenn die Taste erlaubt, eine Liste zu speichern.

Parameter
key	BuildInfoKey.BuildInfoFileKey : Der angeforderte BuildInfoFileKey .

Kehrt zurück
	Die versionierte Datei oder null , wenn sie nicht gefunden wird

Hash-Code

public int hashCode ()

Kehrt zurück
int

removeBuildAttribute

public void removeBuildAttribute (String attributeName)

Entfernt einen angegebenen attributeName aus dem Tracking.

Parameter
attributeName	String : das Attribut zum Stoppen der Verfolgung

setBuildBranch

public void setBuildBranch (String branch)

Legen Sie den Build-Branch fest

Parameter
branch	String : der Zweigname

setBuildFlavor

public void setBuildFlavor (String buildFlavor)

Stellen Sie den Build-Flavor ein.

setBuildId

public void setBuildId (String buildId)

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

Parameter
buildId	String

setDeviceSerial

public void setDeviceSerial (String serial)

Legen Sie die ITestDevice Seriennummer fest, die diesem Build zugeordnet ist.

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

setDatei

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

Speichert eine Datei mit dem angegebenen Namen in dieser Build-Info.

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

setDatei

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

Speichert eine Datei mit einem BuildInfoFileKey in dieser Build-Info.

Parameter
key	BuildInfoKey.BuildInfoFileKey : der eindeutige Name der Datei basierend auf BuildInfoFileKey .
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. Überschreiben Sie alle zuvor festgelegten Eigenschaften.

Parameter
properties	BuildInfoProperties : Die Liste der hinzuzufügenden Eigenschaften.

setTestTag

public void setTestTag (String testTag)

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

Parameter
testTag	String

stageRemoteDatei

public File stageRemoteFile (String fileName, 
                File workingDir)

Staging einer Datei, die Teil von Remote-Dateien im Stammverzeichnis der Build-Informationen ist.

TODO(b/138416078): Entfernen Sie diese Schnittstelle und ihren Aufrufer, wenn Module, die von einem Test benötigt werden, ordnungsgemäß in das Verzeichnis des Testmoduls selbst ausgegeben werden können.

Parameter
fileName	String : Name der Datei, die in Remote-Dateien zu finden ist.
workingDir	File : ein ERROR(/File) -Objekt des Verzeichnisses, um die Datei bereitzustellen.

Kehrt zurück
File	das ERROR(/File) -Objekt der Datei, die im lokalen Arbeitsverzeichnis bereitgestellt wird.

zuProto

public BuildInformation.BuildInfo toProto ()

Serialisieren Sie die BuildInfo-Instanz in ein Protobuf.

Kehrt zurück
BuildInformation.BuildInfo

toString

public String toString ()

Kehrt zurück
String

Geschützte Methoden

addAllBuildAttributes

protected void addAllBuildAttributes (BuildInfo build)

Hilfsmethode zum Kopieren von Build-Attributen, Branch und Flavor von anderen Builds.

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 zu der Datei hat.

Parameter
build	BuildInfo

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

applyBuildProperties

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

Erlauben Sie, einige der IBuildInfo.BuildInfoProperties anzuwenden und möglicherweise eine andere Handhabung vorzunehmen.

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

Kehrt zurück
boolean	True, wenn wir die Eigenschaften angewendet haben und die weitere Behandlung übersprungen werden sollte. Sonst falsch.

getAttributesMultiMap

protected MultiMap<String, String> getAttributesMultiMap ()

Kehrt zurück
MultiMap <String, String>

getVersionedFileMap

protected  getVersionedFileMap ()

Kehrt zurück

getVersionedFileMapFull

protected MultiMap<String, VersionedFile> getVersionedFileMapFull ()

Kehrt zurück
MultiMap <String, VersionedFile >