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 (String buildId, String buildTargetName) Erstellt eine |
Ö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 | allowStagingRemoteFile (boolean stageRemoteFile) Legt die Berechtigung fest, das Staging von Remotedateien zuzulassen. |
void | cleanUp () Bereinigen Sie alle temporären Build-Dateien |
void | cleanUp ( doNotClean) cleanUp ( doNotClean) Version von |
IBuildInfo | clone () |
final void | copyAllFileFrom ( BuildInfo build) Kopieren Sie die gesamte |
boolean | equals (Object obj) |
static IBuildInfo | fromProto (BuildInformation.BuildInfo protoBuild) Inverse Operation zu |
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 |
getFiles () Gibt alle in dieser | |
getProperties () Gibt eine Kopie der derzeit für | |
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 |
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 den Satz von Schlüsseln zurück, die zum Abfragen | |
final | getVersionedFiles ( BuildInfoKey.BuildInfoFileKey key) Hilfsmethode zum Abrufen einer Liste von |
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 |
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 |
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 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 |
MultiMap <String, String> | getAttributesMultiMap () |
getVersionedFileMap () | |
MultiMap <String, VersionedFile > | getVersionedFileMapFull () |
Öffentliche Bauträger
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 |
AllowStagingRemoteFile
public void allowStagingRemoteFile (boolean stageRemoteFile)
Legt die Berechtigung fest, das Staging von Remotedateien zuzulassen.
Parameter | |
---|---|
stageRemoteFile | boolean |
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 |
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)
Umkehroperation zu toProto()
, um die Instanz zurückzubekommen.
Parameter | |
---|---|
protoBuild | BuildInformation.BuildInfo |
Kehrt zurück | |
---|---|
IBuildInfo |
getAppPackageFiles
publicgetAppPackageFiles ()
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
publicgetBuildAttributes ()
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-userdebugKehrt 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
publicgetFiles ()
Gibt alle in dieser BuildInfo
gespeicherten VersionedFile
s zurück.
Kehrt zurück | |
---|---|
getProperties
publicgetProperties ()
Gibt eine Kopie der derzeit für IBuildInfo
festgelegten Eigenschaften zurück.
Kehrt zurück | |
---|---|
getRemoteFiles
publicgetRemoteFiles ()
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
publicgetVersionedFileKeys ()
Gibt den Satz von Schlüsseln zurück, die zum Abfragen VersionedFile
über getFile(BuildInfoFileKey)
verfügbar sind.
Kehrt zurück | |
---|---|
getVersionedFiles
public finalgetVersionedFiles (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 diesen Build-Informationen.
Parameter | |
---|---|
name | String : der eindeutige Name der Datei |
file | File : der 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 : der 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
protectedgetVersionedFileMap ()
Kehrt zurück | |
---|---|
getVersionedFileMapFull
protected MultiMap<String, VersionedFile> getVersionedFileMapFull ()
Kehrt zurück | |
---|---|
MultiMap <String, VersionedFile > |