Build-Informationen

public class BuildInfo
extends Object implements IBuildInfo

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

Allgemeine Implementierung einer IBuildInfo, die verknüpft werden sollte mit ITestDevice.

Zusammenfassung

Öffentliche Konstruktoren

BuildInfo()

Erstellt eine BuildInfo mit Standardattributwerten.

BuildInfo(String buildId, String buildTargetName)

Erstellt: 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)

Build-Attribute hinzufügen

void allowStagingRemoteFile(boolean stageRemoteFile)

Legt die Berechtigung fest, das Staging von Remote-Dateien zuzulassen.

void cleanUp()

Temporäre Build-Dateien bereinigen

void cleanUp( doNotClean)

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

IBuildInfo clone()

final void copyAllFileFrom(BuildInfo build)

Kopiert alle VersionedFile aus einem bestimmten Build in diesen.

boolean equals(Object obj)

static IBuildInfo fromProto(BuildInformation.BuildInfo protoBuild)

Umgekehrte Operation zu toProto(), um die Instanz wiederherzustellen.

getAppPackageFiles()

Ruft eine Kopie der lokalen APK-Datei(en) und ihrer Versionen ab.

getBuildAttributes()

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

String getBuildBranch()

Optionale Methode zum Zurückgeben des Versionsverwaltungszweigs, den der getestete Build war aus denen produziert werden.

String getBuildFlavor()

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

String getBuildId()

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

String getBuildTargetName()

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

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

getFiles()

Gibt alle in dieser BuildInfo gespeicherten VersionedFile-Werte zurück.

getProperties()

Gibt eine Kopie der Attribute zurück, die aktuell für IBuildInfo festgelegt sind.

getRemoteFiles()

Rufen Sie die Pfade für Build-Artefakte ab, 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 einem angegebenen BuildInfoFileKey.

String getVersion(String name)

Hilfsmethode zum Abrufen einer Dateiversion mit vorgegebenem Namen.

VersionedFile getVersionedFile(BuildInfoKey.BuildInfoFileKey key)

Hilfsmethode zum Abrufen eines VersionedFile mit einem angegebenen BuildInfoFileKey.

final VersionedFile getVersionedFile(String name)

Hilfsmethode zum Abrufen einer VersionedFile mit einem bestimmten Namen.

getVersionedFileKeys()

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

final getVersionedFiles(BuildInfoKey.BuildInfoFileKey key)

Hilfsmethode zum Abrufen einer Liste von VersionedFiles, die einem bestimmten BuildInfoFileKey zugeordnet sind.

int hashCode()

void removeBuildAttribute(String attributeName)

Entfernt einen bestimmten Attributnamen aus dem Tracking.

void setBuildBranch(String branch)

Build-Zweig festlegen

void setBuildFlavor(String buildFlavor)

Build-Flavor festlegen.

void setBuildId(String buildId)

Legt die eindeutige Kennung des zu testenden Builds fest.

void setDeviceSerial(String serial)

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

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

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

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

Speichert eine Datei mit einem bestimmten BuildInfoFileKey in diesen Build-Informationen.

void setProperties(BuildInfoProperties... properties)

Legen Sie BuildInfoProperties für die Instanz IBuildInfo fest.

void setTestTag(String testTag)

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

File stageRemoteFile(String fileName, File workingDir)

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

BuildInformation.BuildInfo toProto()

Serialisiert die BuildInfo-Instanz in einen protobuf.

String toString()

Geschützte Methoden

void addAllBuildAttributes(BuildInfo build)

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

void addAllFiles(BuildInfo build)

Hilfsmethode zum Kopieren aller Dateien aus dem anderen Build.

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

Anwenden von IBuildInfo.BuildInfoProperties zulassen und unter Umständen anders zu behandeln.

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

Öffentliche Konstruktoren

Build-Informationen

public BuildInfo ()

Erstellt eine BuildInfo mit Standardattributwerten.

Build-Informationen

public BuildInfo (String buildId, 
                String buildTargetName)

Erstellt: BuildInfo

Parameter
buildId String: die Build-ID
buildTargetName String: 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 APK-Dateien von getAppPackageFiles() in der Reihenfolge, in der sie mit dieser Methode hinzugefügt wurden.

Parameter
appPackageFile File

version String

Attribut „addBuildAttribute“

public void addBuildAttribute (String attributeName, 
                String attributeValue)

Fügen Sie ein Build-Attribut hinzu. Das Überschreiben eines vorhandenen Attributsname ist nicht möglich.

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)

Legt die Berechtigung fest, das Staging von Remote-Dateien zuzulassen.

Parameter
stageRemoteFile boolean

CleanUp

public void cleanUp ()

Temporäre Build-Dateien bereinigen

CleanUp

public void cleanUp ( doNotClean)

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

Parameter
doNotClean

Klonen

public IBuildInfo clone ()

Returns
IBuildInfo

copyAllFileFrom

public final void copyAllFileFrom (BuildInfo build)

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

Umgekehrte Operation zu toProto(), um die Instanz wiederherzustellen.

Parameter
protoBuild BuildInformation.BuildInfo

Returns
IBuildInfo

getAppPackageFiles

public  getAppPackageFiles ()

Ruft eine Kopie der lokalen APK-Datei(en) und ihrer Versionen ab. Die zurückgegebene Bestellung stimmt mit der Reihenfolge überein, in der die APK-Dateien zu IAppBuildInfo hinzugefügt wurden.

Returns

getBuildAttributes

public  getBuildAttributes ()

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

Returns
ERROR(/Map) von Build-Attributen. Der Wert ist nicht null, er kann aber leer sein.

GetBuildBranch

public String getBuildBranch ()

Optionale Methode zum Zurückgeben des Versionsverwaltungszweigs, den der getestete Build war aus denen produziert werden.

Returns
String Build-Zweig oder null, falls nicht festgelegt/nicht zutreffend

GetBuildFlavor

public String getBuildFlavor ()

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

Eine gängige Implementierung für Android-Plattform-Builds besteht darin, (Build-Produkt)-(Build-Betriebssystem)-(Build-Variante) erstellen. z. B. generisches-linux-userdebug

Returns
String Build-Flavor oder null, falls nicht festgelegt/nicht zutreffend

getBuildId

public String getBuildId ()

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

Returns
String

getBuildTargetName

public String getBuildTargetName ()

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

Eine gängige Implementierung besteht darin, den Build-Zielnamen aus einer Kombination den Build-Flavor und den Branch-Namen. [ie (Filialname)-(Geschmack aufbauen)]

Returns
String

getDeviceSerial

public String getDeviceSerial ()

Returns
String

getFile

public File getFile (String name)

Hilfsmethode zum Abrufen einer Datei mit einem bestimmten Namen.

Returns
File Bilddatei oder null, falls sie nicht gefunden wird

getFile

public File getFile (BuildInfoKey.BuildInfoFileKey key)

Hilfsmethode zum Abrufen einer Datei mit einem angegebenen BuildInfoFileKey.

Parameter
key BuildInfoKey.BuildInfoFileKey: die angeforderte BuildInfoFileKey.
Returns
File Bilddatei oder null, falls sie nicht gefunden wird

getFiles

public  getFiles ()

Gibt alle in dieser BuildInfo gespeicherten VersionedFile-Werte zurück.

Returns

getProperties

public  getProperties ()

Gibt eine Kopie der Attribute zurück, die aktuell für IBuildInfo festgelegt sind.

Returns

getRemoteFiles

public  getRemoteFiles ()

Rufen Sie die Pfade für Build-Artefakte ab, 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 einem angegebenen BuildInfoFileKey.

Parameter
key BuildInfoKey.BuildInfoFileKey: Die angeforderte BuildInfoFileKey.
Returns
String Image-Version oder null, falls nicht gefunden

getVersion

public String getVersion (String name)

Hilfsmethode zum Abrufen einer Dateiversion mit vorgegebenem Namen.

Returns
String Image-Version oder null, falls nicht gefunden

getVersionedFile

public VersionedFile getVersionedFile (BuildInfoKey.BuildInfoFileKey key)

Hilfsmethode zum Abrufen eines VersionedFile mit einem angegebenen BuildInfoFileKey.

Parameter
key BuildInfoKey.BuildInfoFileKey: Die angeforderte BuildInfoFileKey.
Returns
VersionedFile Die versionierte Datei oder null, falls sie nicht gefunden wird

getVersionedFile

public final VersionedFile getVersionedFile (String name)

Hilfsmethode zum Abrufen einer VersionedFile mit einem bestimmten Namen.

Returns
VersionedFile Die versionierte Datei oder null, falls sie nicht gefunden wird

getVersionedFileKeys

public  getVersionedFileKeys ()

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

Returns

getVersionedFiles

public final  getVersionedFiles (BuildInfoKey.BuildInfoFileKey key)

Hilfsmethode zum Abrufen einer Liste von VersionedFiles, die einem bestimmten BuildInfoFileKey zugeordnet sind. Gibt an, ob der Schlüssel das Speichern einer Liste zulässt.

Parameter
key BuildInfoKey.BuildInfoFileKey: Die angeforderte BuildInfoFileKey.
Returns
Die versionierte Datei oder null, falls sie nicht gefunden wird

hashCode

public int hashCode ()

Returns
int

removeBuildAttribute (Entfernen von Attributen)

public void removeBuildAttribute (String attributeName)

Entfernt einen bestimmten Attributnamen aus dem Tracking.

Parameter
attributeName String: Attribut zum Beenden des Trackings

SetBuildBranch

public void setBuildBranch (String branch)

Build-Zweig festlegen

Parameter
branch String: der Zweigname

Flavor festlegen

public void setBuildFlavor (String buildFlavor)

Build-Flavor festlegen.

setBuildId

public void setBuildId (String buildId)

Legt die eindeutige Kennung des zu testenden Builds fest. Sollte nie 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 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 diesen Build-Informationen.

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 bestimmten BuildInfoFileKey in diesen Build-Informationen.

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 BuildInfoProperties für die Instanz IBuildInfo fest. Alle überschreiben vorhandenen Eigenschaften.

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

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)

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

TODO(b/138416078): Diese Schnittstelle und ihr Aufrufer entfernen, wenn Module für einen Test erforderlich sind ordnungsgemäß in das Verzeichnis des Testmoduls selbst ausgegeben werden kann.

Parameter
fileName String: Name der Datei, die sich in den Remote-Dateien befinden soll.
workingDir File: Ein ERROR(/File)-Objekt des Verzeichnisses für das Staging der Datei.
Returns
File Das ERROR(/File)-Objekt der Datei, die im lokalen „workingDir“ bereitgestellt wird.

toProto

public BuildInformation.BuildInfo toProto ()

Serialisiert 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, Branch und Flavor aus anderen Builds.

Parameter
build BuildInfo

Alle Dateien hinzufügen

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

Parameter
build BuildInfo

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

applyBuildProperties

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

Anwenden von IBuildInfo.BuildInfoProperties zulassen und unter Umständen anders zu behandeln.

Parameter
origFileConsidered VersionedFile: Der aktuell aufgerufene VersionedFile.
build IBuildInfo: der ursprüngliche Build, der geklont wird
receiver IBuildInfo: Der Build, der die Informationen empfängt.
Returns
boolean "True", wenn die Eigenschaften angewendet wurden und eine weitere Verarbeitung übersprungen werden soll. Falsch sonst.

getAttributesMultiMap

protected MultiMap<String, String> getAttributesMultiMap ()

Returns
MultiMap<String, String>

getVersionedFileMap

protected  getVersionedFileMap ()

Returns

getVersionedFileMapFull

protected MultiMap<String, VersionedFile> getVersionedFileMapFull ()

Returns
MultiMap<String, VersionedFile>