BuildInfo

public class BuildInfo
extends Object implements IBuildInfo

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


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

Zusammenfassung

Öffentliche Bauträger

BuildInfo ()

Erstellt eine 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 ( 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 Quellcodeverwaltungszweigs, aus dem der getestete Build erstellt wurde.

String getBuildFlavor ()

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

String getBuildId ()

Gibt die eindeutige Kennung des zu testenden Builds zurück.

String getBuildTargetName ()

Gibt den vollständigen Namen für den getesteten Build 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 einem angegebenen BuildInfoFileKey .

getFiles ()

Gibt alle in dieser BuildInfo gespeicherten VersionedFile s zurück.

getProperties ()

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

getRemoteFiles ()

Rufen Sie die Pfade für Build-Artefakte ab, deren Download verzögert ist.

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 einem 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 einem bestimmten BuildInfoFileKey .

final VersionedFile getVersionedFile (String name)

Hilfsmethode zum Abrufen einer VersionedFile mit einem bestimmten Namen.

getVersionedFileKeys ()

Gibt den Satz von Schlüsseln zurück, die zum Abfragen VersionedFile über getFile(BuildInfoFileKey) verfügbar sind.

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)

Entfernen Sie einen bestimmten Attributnamen aus der Nachverfolgung.

void setBuildBranch (String branch)

Legen Sie den Build-Zweig fest

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 diesem Build zugeordnet ist.

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

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

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

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

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 bereit, die Teil der Remote-Dateien im Stammverzeichnis der Build-Informationen ist.

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, Zweigen und Varianten von anderen Builds.

void addAllFiles ( BuildInfo build)

Hilfsmethode zum Kopieren aller Dateien aus dem anderen Build.

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

Ermöglichen Sie die Anwendung einiger IBuildInfo.BuildInfoProperties und führen Sie möglicherweise eine andere Behandlung durch.

MultiMap <String, String> getAttributesMultiMap ()
getVersionedFileMap ()
MultiMap <String, VersionedFile > getVersionedFileMapFull ()

Öffentliche Bauträger

BuildInfo

public BuildInfo ()

Erstellt eine 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. 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 das Überschreiben eines vorhandenen Attributnamens nicht möglich.

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

gleicht

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) der Build-Attribute. Wird nicht null sein, kann aber leer sein.

getBuildBranch

public String getBuildBranch ()

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

Kehrt zurück
String der Build-Zweig oder null , wenn nicht gesetzt/nicht anwendbar

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-Betriebssystem)-(Build-Variante). dh generic-linux-userdebug

Kehrt zurück
String die Build-Variante oder null , falls nicht gesetzt/nicht anwendbar

getBuildId

public String getBuildId ()

Gibt die eindeutige Kennung des zu testenden Builds zurück. Sollte niemals null sein. Standardmäßig ist UNKNOWN_BUILD_ID .

Kehrt zurück
String

getBuildTargetName

public String getBuildTargetName ()

Gibt den vollständigen Namen für den getesteten Build zurück.

Eine gängige Implementierung besteht darin, den Build-Zielnamen aus einer Kombination aus Build-Variante und Branch-Namen zu erstellen. [dh (Zweigname)-(Build-Variante)]

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 dem angegebenen 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 angegebenen 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 in dieser BuildInfo gespeicherten VersionedFile s zurück.

Kehrt zurück

getProperties

public  getProperties ()

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

Kehrt zurück

getRemoteFiles

public  getRemoteFiles ()

Rufen Sie die Pfade für Build-Artefakte ab, deren Download verzögert ist.

Kehrt zurück

getTestTag

public String getTestTag ()

Gibt 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 angegebenen BuildInfoFileKey .

Parameter
key BuildInfoKey.BuildInfoFileKey : Der angeforderte BuildInfoFileKey .

Kehrt zurück
String die Bildversion oder null , wenn nicht gefunden

getVersion

public String getVersion (String name)

Hilfsmethode zum Abrufen einer Dateiversion mit dem angegebenen Namen.

Kehrt zurück
String die Bildversion oder null , wenn nicht gefunden

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 Satz von Schlüsseln zurück, die zur Abfrage VersionedFile über getFile(BuildInfoFileKey) verfügbar sind.

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 der Schlüssel das Speichern einer Liste ermöglicht.

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)

Entfernen Sie einen bestimmten Attributnamen aus der Nachverfolgung.

Parameter
attributeName String : das Attribut zum Stoppen der Verfolgung

setBuildBranch

public void setBuildBranch (String branch)

Legen Sie den Build-Zweig fest

Parameter
branch String : der Filialname

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. 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.

setFile

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

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

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)

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

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

stageRemoteFile

public File stageRemoteFile (String fileName, 
                File workingDir)

Stellen Sie eine Datei bereit, die Teil der Remote-Dateien im Stammverzeichnis der Build-Informationen ist.

TODO(b/138416078): Entfernen Sie diese Schnittstelle und ihren Aufrufer, wenn für einen Test erforderliche Module ordnungsgemäß erstellt und im Verzeichnis des Testmoduls selbst ausgegeben werden können.

Parameter
fileName String : Name der Datei, die in Remote-Dateien lokalisiert werden soll.

workingDir File : ein ERROR(/File) -Objekt des Verzeichnisses zum Bereitstellen der Datei.

Kehrt zurück
File das ERROR(/File) -Objekt der im lokalen Arbeitsverzeichnis bereitgestellten Datei.

toProto

public BuildInformation.BuildInfo toProto ()

Serialisieren Sie die BuildInfo-Instanz in einen 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, Zweigen und Varianten 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 zur Datei hat.

Parameter
build BuildInfo

Würfe
wenn beim Erstellen des Hardlinks eine Ausnahme ausgelöst wird.

applyBuildProperties

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

Ermöglichen Sie die Anwendung einiger IBuildInfo.BuildInfoProperties und führen Sie möglicherweise eine andere Behandlung durch.

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 >