IBuildInfo

public interface IBuildInfo

com.android.tradefed.build.IBuildInfo


Enthält Informationen über den zu testenden Build.

Zusammenfassung

Konstanten

String REMOTE_FILE_PREFIX

Präfix, das im Namen verwendet wird, um anzugeben, dass die Datei auf verzögerten Download eingestellt ist.

String REMOTE_FILE_VERSION

Remote-Datei ist nicht versioniert.

String UNKNOWN_BUILD_ID

Standardwert, wenn die Build-ID unbekannt ist.

Öffentliche Methoden

default void addAppPackageFile (File appPackageFile, String version)

Fügt die lokale APK-Datei und die zugehörige Version hinzu.

abstract void addBuildAttribute (String attributeName, String attributeValue)

Fügen Sie ein Build-Attribut hinzu.

default void addBuildAttributes ( buildAttributes) addBuildAttributes ( buildAttributes)

Build-Attribute hinzufügen

abstract void cleanUp ()

Bereinigen Sie alle temporären Build-Dateien

abstract void cleanUp ( doNotDelete) cleanUp ( doNotDelete)

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

abstract IBuildInfo clone ()

Klont das IBuildInfo Objekt.

default getAppPackageFiles ()

Ruft eine Kopie des Satzes lokaler App-APK-Dateien und ihrer Versionen ab.

abstract getBuildAttributes ()

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

abstract String getBuildBranch ()

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

abstract String getBuildFlavor ()

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

abstract String getBuildId ()

Gibt den eindeutigen Bezeichner des zu testenden Builds zurück.

abstract String getBuildTargetName ()

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

abstract String getDeviceSerial ()
abstract File getFile (String name)

Hilfsmethode zum Abrufen einer Datei mit einem bestimmten Namen.

default File getFile ( BuildInfoKey.BuildInfoFileKey key)

Hilfsmethode zum Abrufen einer Datei mit einem gegebenen BuildInfoFileKey .

abstract getFiles ()

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

abstract getProperties ()

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

default getRemoteFiles ()

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

abstract String getTestTag ()

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

default String getVersion ( BuildInfoKey.BuildInfoFileKey key)

Hilfsmethode zum Abrufen einer Dateiversion mit einem gegebenen BuildInfoFileKey .

abstract String getVersion (String name)

Hilfsmethode zum Abrufen einer Dateiversion mit einem bestimmten Namen.

default VersionedFile getVersionedFile ( BuildInfoKey.BuildInfoFileKey key)

Hilfsmethode zum Abrufen einer VersionedFile mit einem bestimmten BuildInfoFileKey .

default VersionedFile getVersionedFile (String name)

Hilfsmethode zum Abrufen einer VersionedFile mit einem bestimmten Namen.

default getVersionedFileKeys ()

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

default getVersionedFiles ( BuildInfoKey.BuildInfoFileKey key)

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

default void removeBuildAttribute (String attributeName)

Entfernt einen angegebenen attributeName aus dem Tracking.

abstract void setBuildBranch (String branch)

Legen Sie den Build-Branch fest

abstract void setBuildFlavor (String buildFlavor)

Stellen Sie den Build-Flavor ein.

abstract void setBuildId (String buildId)

Legt die eindeutige Kennung des zu testenden Builds fest.

abstract void setDeviceSerial (String serial)

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

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

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

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

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

abstract void setProperties ( BuildInfoProperties... properties)

Legen Sie die BuildInfoProperties für die IBuildInfo Instanz fest.

abstract void setTestTag (String testTag)

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

default File stageRemoteFile (String fileName, File workingDir)

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

default BuildInformation.BuildInfo toProto ()

Serialisieren Sie die BuildInfo-Instanz in ein Protobuf.

Konstanten

REMOTE_FILE_PREFIX

public static final String REMOTE_FILE_PREFIX

Präfix, das im Namen verwendet wird, um anzugeben, dass die Datei auf verzögerten Download eingestellt ist.

Konstanter Wert: "remote_file:"

REMOTE_FILE_VERSION

public static final String REMOTE_FILE_VERSION

Remote-Datei ist nicht versioniert.

Konstanter Wert: ""

UNKNOWN_BUILD_ID

public static final String UNKNOWN_BUILD_ID

Standardwert, wenn die Build-ID unbekannt ist.

Konstanter Wert: "-1"

Ö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 abstract 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 abstract void cleanUp ()

Bereinigen Sie alle temporären Build-Dateien

Aufräumen

public abstract void cleanUp ( doNotDelete)

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

Parameter
doNotDelete

Klon

public abstract IBuildInfo clone ()

Klont das IBuildInfo Objekt.

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 abstract  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 abstract 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 abstract 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 abstract 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 abstract 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 abstract String getDeviceSerial ()

Kehrt zurück
String die ITestDevice Seriennummer, auf der dieser Build ausgeführt wurde. Gibt null zurück, wenn diesem Build kein Gerät zugeordnet ist.

eine Datei bekommen

public abstract 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 abstract  getFiles ()

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

Kehrt zurück

getProperties

public abstract  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 abstract 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 abstract 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 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  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

removeBuildAttribute

public void removeBuildAttribute (String attributeName)

Entfernt einen angegebenen attributeName aus dem Tracking.

Parameter
attributeName String : das Attribut zum Stoppen der Verfolgung

setBuildBranch

public abstract void setBuildBranch (String branch)

Legen Sie den Build-Branch fest

Parameter
branch String : der Zweigname

setBuildFlavor

public abstract void setBuildFlavor (String buildFlavor)

Stellen Sie den Build-Flavor ein.

setBuildId

public abstract void setBuildId (String buildId)

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

Parameter
buildId String

setDeviceSerial

public abstract 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 abstract 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 abstract 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 abstract 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