BuildInfo
public
class
BuildInfo
extends Object
implements
IBuildInfo
java.lang.Object | |
↳ | com.android.tradefed.build.BuildInfo |
Generische Implementierung eines IBuildInfo
, das mit einem ITestDevice
verknüpft werden sollte.
Zusammenfassung
Öffentliche Konstruktoren | |
---|---|
BuildInfo()
Erstellt einen |
|
BuildInfo(String buildId, String buildTargetName)
Erstellt einen |
Ö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(
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(
Version von |
IBuildInfo
|
clone()
|
final
void
|
copyAllFileFrom(BuildInfo build)
Kopieren Sie alle |
boolean
|
equals(Object obj)
|
static
IBuildInfo
|
fromProto(BuildInformation.BuildInfo protoBuild)
Führen Sie den umgekehrten Vorgang zu |
|
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 |
|
getFiles()
Gibt alle in diesem |
|
getProperties()
Gibt eine Kopie der derzeit für die |
|
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 |
String
|
getVersion(String name)
Hilfsmethode zum Abrufen einer Dateiversion mit dem angegebenen Namen. |
VersionedFile
|
getVersionedFile(BuildInfoKey.BuildInfoFileKey key)
Hilfsmethode zum Abrufen einer |
final
VersionedFile
|
getVersionedFile(String name)
Hilfsmethode zum Abrufen einer |
|
getVersionedFileKeys()
Gibt die Schlüssel zurück, mit denen |
final
|
getVersionedFiles(BuildInfoKey.BuildInfoFileKey key)
Hilfsmethode zum Abrufen einer Liste von |
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 |
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 |
void
|
setProperties(BuildInfoProperties... properties)
Legen Sie die |
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 |
MultiMap<String, String>
|
getAttributesMultiMap()
|
|
getVersionedFileMap()
|
MultiMap<String, VersionedFile>
|
getVersionedFileMapFull()
|
Öffentliche Konstruktoren
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 |
|
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
publicgetAppPackageFiles ()
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
publicgetBuildAttributes ()
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
publicgetFiles ()
Gibt alle in diesem BuildInfo
gespeicherten VersionedFile
zurück.
Returns | |
---|---|
|
getProperties
publicgetProperties ()
Gibt eine Kopie der derzeit für die IBuildInfo
festgelegten Properties zurück.
Returns | |
---|---|
|
getRemoteFiles
publicgetRemoteFiles ()
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
publicgetVersionedFileKeys ()
Gibt die Schlüssel zurück, mit denen VersionedFile
über getFile(BuildInfoFileKey)
abgefragt werden kann.
Returns | |
---|---|
|
getVersionedFiles
public finalgetVersionedFiles (BuildInfoKey.BuildInfoFileKey key)
Hilfsmethode zum Abrufen einer Liste von VersionedFile
s, 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
protectedgetVersionedFileMap ()
Returns | |
---|---|
|
getVersionedFileMapFull
protected MultiMap<String, VersionedFile> getVersionedFileMapFull ()
Returns | |
---|---|
MultiMap<String, VersionedFile> |