IBuildInfo

public interface IBuildInfo
implements Serializable

com.android.tradefed.build.IBuildInfo

Enthält Informationen zum zu testenden Build.

Zusammenfassung

Konstanten

String REMOTE_FILE_PREFIX

Präfix, das im Namen verwendet wird, um anzugeben, dass der Download der Datei verzögert werden soll.

String REMOTE_FILE_VERSION

Die Remotedatei 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(Map<String, String> buildAttributes)

Build-Attribute hinzufügen

default void allowStagingRemoteFile(boolean stageRemoteFile)

Legt die Berechtigung zum Staging von Remotedateien fest.

abstract void cleanUp()

Temporäre Build-Dateien löschen

abstract void cleanUp(List<File> doNotDelete)

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

abstract IBuildInfo clone()

Clones the IBuildInfo object.

default List<VersionedFile> getAppPackageFiles()

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

abstract Map<String, String> getBuildAttributes()

Ruft eine Reihe von Name/Wert-Paaren mit zusätzlichen Attributen ab, die den Build beschreiben.

abstract String getBuildBranch()

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

abstract String getBuildFlavor()

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

abstract String getBuildId()

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

abstract String getBuildTargetName()

Gibt den vollständigen Namen des Builds zurück, der getestet wird.

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

abstract Collection<VersionedFile> getFiles()

Gibt alle in diesem BuildInfo gespeicherten VersionedFiles zurück.

abstract Set<IBuildInfo.BuildInfoProperties> getProperties()

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

default Set<File> getRemoteFiles()

Ruft die Pfade für Build-Artefakte ab, die verzögert heruntergeladen werden.

abstract String getTestTag()

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

default String getVersion(BuildInfoKey.BuildInfoFileKey key)

Hilfsmethode zum Abrufen einer Dateiversion mit einer bestimmten BuildInfoFileKey.

abstract String getVersion(String name)

Hilfsmethode zum Abrufen einer Dateiversion mit dem angegebenen Namen.

default VersionedFile getVersionedFile(BuildInfoKey.BuildInfoFileKey key)

Hilfsmethode zum Abrufen eines VersionedFile mit einem bestimmten BuildInfoFileKey.

default VersionedFile getVersionedFile(String name)

Hilfsmethode zum Abrufen eines VersionedFile mit einem bestimmten Namen.

default Set<String> getVersionedFileKeys()

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

default List<VersionedFile> getVersionedFiles(BuildInfoKey.BuildInfoFileKey key)

Hilfsmethode zum Abrufen einer Liste von VersionedFiles, die mit einem bestimmten BuildInfoFileKey verknüpft sind.

default void removeBuildAttribute(String attributeName)

Entfernt einen bestimmten „attributeName“ aus dem Tracking.

abstract void setBuildBranch(String branch)

Build-Zweig festlegen

abstract void setBuildFlavor(String buildFlavor)

Legen Sie die Build-Variante fest.

abstract void setBuildId(String buildId)

Legt die eindeutige Kennung des zu testenden Builds fest.

abstract void setDeviceSerial(String serial)

Legen Sie die ITestDevice-Seriennummer für diesen Build fest.

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

Speichert eine Datei anhand einer BuildInfoFileKey in diesen Build-Informationen.

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

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

abstract void setProperties(BuildInfoProperties... properties)

Legen Sie den 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)

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

default BuildInformation.BuildInfo toProto()

Serialisiert die BuildInfo-Instanz in einen Protokollpuffer.

Konstanten

REMOTE_FILE_PREFIX

public static final String REMOTE_FILE_PREFIX

Präfix, das im Namen verwendet wird, um anzugeben, dass der Download der Datei verzögert werden soll.

Konstanter Wert: "remote_file:"

REMOTE_FILE_VERSION

public static final String REMOTE_FILE_VERSION

Die Remotedatei ist nicht versioniert.

Constant Value: ""

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. 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 abstract void addBuildAttribute (String attributeName, 
                String attributeValue)

Fügen Sie ein Build-Attribut hinzu. Ein vorhandener „attributeName“ kann dadurch nicht überschrieben werden.

Parameter
attributeName String: der eindeutige Attributname
attributeValue String: der Attributwert

addBuildAttributes

public void addBuildAttributes (Map<String, String> buildAttributes)

Build-Attribute hinzufügen

Parameter
buildAttributes Map: Zuordnung der hinzuzufügenden Attribute

allowStagingRemoteFile

public void allowStagingRemoteFile (boolean stageRemoteFile)

Legt die Berechtigung zum Staging von Remotedateien fest.

Parameter
stageRemoteFile boolean

cleanUp

public abstract void cleanUp ()

Temporäre Build-Dateien löschen

cleanUp

public abstract void cleanUp (List<File> doNotDelete)

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

Parameter
doNotDelete List

clone

public abstract IBuildInfo clone ()

Clones the IBuildInfo object.

Gibt Folgendes zurück:
IBuildInfo

getAppPackageFiles

public List<VersionedFile> getAppPackageFiles ()

Ruft eine Kopie der lokalen APK-Datei(en) der App und ihrer Versionen ab. Die zurückgegebene Reihenfolge entspricht der Reihenfolge, in der die APKs dem IAppBuildInfo hinzugefügt wurden.

Gibt Folgendes zurück:
List<VersionedFile>

getBuildAttributes

public abstract Map<String, String> getBuildAttributes ()

Ruft eine Reihe von Name/Wert-Paaren mit zusätzlichen Attributen ab, die den Build beschreiben.

Gibt Folgendes zurück:
Map<String, String> Map mit Build-Attributen. Darf nicht null sein, kann aber leer sein.

getBuildBranch

public abstract String getBuildBranch ()

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

Gibt Folgendes zurück:
String Der Build-Branch oder null, falls nicht festgelegt/nicht zutreffend

getBuildFlavor

public abstract String getBuildFlavor ()

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

Eine gängige Implementierung für Android-Plattform-Builds gibt (Build-Produkt)-(Build-Betriebssystem)-(Build-Variante) zurück. z. B. generic-linux-userdebug

Gibt Folgendes zurück:
String Der Build-Flavor oder null, falls nicht festgelegt oder nicht zutreffend

getBuildId

public abstract String getBuildId ()

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

Gibt Folgendes zurück:
String

getBuildTargetName

public abstract String getBuildTargetName ()

Gibt den vollständigen Namen des Builds zurück, der getestet wird.

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

Gibt Folgendes zurück:
String

getDeviceSerial

public abstract String getDeviceSerial ()

Gibt Folgendes zurück:
String Die ITestDevice-Seriennummer, auf der dieser Build ausgeführt wurde. Gibt null zurück, wenn kein Gerät mit diesem Build verknüpft ist.

getFile

public abstract File getFile (String name)

Hilfsmethode zum Abrufen einer Datei mit einem bestimmten Namen.

Gibt Folgendes zurück:
File die Bilddatei oder null, falls nicht gefunden

getFile

public File getFile (BuildInfoKey.BuildInfoFileKey key)

Hilfsmethode zum Abrufen einer Datei mit einem bestimmten BuildInfoFileKey.

Parameter
key BuildInfoKey.BuildInfoFileKey: Die angeforderte BuildInfoFileKey.
Gibt Folgendes zurück:
File die Bilddatei oder null, falls nicht gefunden

getFiles

public abstract Collection<VersionedFile> getFiles ()

Gibt alle in diesem BuildInfo gespeicherten VersionedFiles zurück.

Gibt Folgendes zurück:
Collection<VersionedFile>

getProperties

public abstract Set<IBuildInfo.BuildInfoProperties> getProperties ()

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

Gibt Folgendes zurück:
Set<IBuildInfo.BuildInfoProperties>

getRemoteFiles

public Set<File> getRemoteFiles ()

Ruft die Pfade für Build-Artefakte ab, die verzögert heruntergeladen werden.

Gibt Folgendes zurück:
Set<File>

getTestTag

public abstract String getTestTag ()

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

Gibt Folgendes zurück:
String

getVersion

public String getVersion (BuildInfoKey.BuildInfoFileKey key)

Hilfsmethode zum Abrufen einer Dateiversion mit einer bestimmten BuildInfoFileKey.

Parameter
key BuildInfoKey.BuildInfoFileKey: Die angeforderte BuildInfoFileKey.
Gibt Folgendes zurück:
String die Bildversion oder null, falls nicht gefunden

getVersion

public abstract String getVersion (String name)

Hilfsmethode zum Abrufen einer Dateiversion mit dem angegebenen Namen.

Gibt Folgendes zurück:
String die Bildversion oder null, falls nicht gefunden

getVersionedFile

public VersionedFile getVersionedFile (BuildInfoKey.BuildInfoFileKey key)

Hilfsmethode zum Abrufen eines VersionedFile mit einem bestimmten BuildInfoFileKey.

Parameter
key BuildInfoKey.BuildInfoFileKey: Die angeforderte BuildInfoFileKey.
Gibt Folgendes zurück:
VersionedFile Die versionierte Datei oder null, falls nicht gefunden

getVersionedFile

public VersionedFile getVersionedFile (String name)

Hilfsmethode zum Abrufen eines VersionedFile mit einem bestimmten Namen.

Gibt Folgendes zurück:
VersionedFile Die versionierte Datei oder null, falls nicht gefunden

getVersionedFileKeys

public Set<String> getVersionedFileKeys ()

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

Gibt Folgendes zurück:
Set<String>

getVersionedFiles

public List<VersionedFile> getVersionedFiles (BuildInfoKey.BuildInfoFileKey key)

Hilfsmethode zum Abrufen einer Liste von VersionedFiles, die mit einem bestimmten BuildInfoFileKey verknüpft sind. Wenn der Schlüssel das Speichern einer Liste zulässt.

Parameter
key BuildInfoKey.BuildInfoFileKey: Die angeforderte BuildInfoFileKey.
Gibt Folgendes zurück:
List<VersionedFile> Die versionierte Datei oder null, falls nicht gefunden

removeBuildAttribute

public void removeBuildAttribute (String attributeName)

Entfernt einen bestimmten „attributeName“ aus dem Tracking.

Parameter
attributeName String: das Attribut, dessen Tracking beendet werden soll

setBuildBranch

public abstract void setBuildBranch (String branch)

Build-Zweig festlegen

Parameter
branch String: der Name des Branch

setBuildFlavor

public abstract void setBuildFlavor (String buildFlavor)

Legen Sie die Build-Variante fest.

setBuildId

public abstract void setBuildId (String buildId)

Legt die eindeutige Kennung des zu testenden Builds fest. Darf nie null sein.

Parameter
buildId String

setDeviceSerial

public abstract void setDeviceSerial (String serial)

Legen Sie die ITestDevice-Seriennummer für diesen Build fest.

Parameter
serial String: die Seriennummer des ITestDevice, mit dem dieser Build ausgeführt wurde.

setFile

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

Speichert eine Datei anhand einer BuildInfoFileKey in diesen Build-Informationen.

Parameter
key BuildInfoKey.BuildInfoFileKey: Der eindeutige Name der Datei basierend auf BuildInfoFileKey.
file File: die lokale File
version String: die Dateiversion

setFile

public abstract 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 File
version String: die Dateiversion

setProperties

public abstract void setProperties (BuildInfoProperties... properties)

Legen Sie den BuildInfoProperties für die IBuildInfo-Instanz fest. Alle zuvor festgelegten Eigenschaften werden überschrieben.

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

setTestTag

public abstract 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 von Remote-Dateien im Stammverzeichnis der Build-Informationen ist.

TODO(b/138416078): Entfernen Sie diese Schnittstelle und den Aufrufer, wenn Module, die für einen Test erforderlich sind, ordnungsgemäß in das Verzeichnis des Testmoduls selbst ausgegeben werden können.

Parameter
fileName String: Name der Datei, die sich in den Remotedateien befinden soll.
workingDir File: Ein File-Objekt des Verzeichnisses, in dem die Datei bereitgestellt werden soll.
Gibt Folgendes zurück:
File Das File-Objekt der Datei, die im lokalen workingDir bereitgestellt wird.

toProto

public BuildInformation.BuildInfo toProto ()

Serialisiert die BuildInfo-Instanz in einen Protokollpuffer.

Gibt Folgendes zurück:
BuildInformation.BuildInfo