IBuildInfo
public
interface
IBuildInfo
com.android.tradefed.build.IBuildInfo |
Zawiera informacje o testowanej wersji.
Podsumowanie
Stałe | |
---|---|
String |
REMOTE_FILE_PREFIX
W nazwie pliku jest używany prefiks, który wskazuje, że plik ma być pobierany z opóźnieniem. |
String |
REMOTE_FILE_VERSION
Plik zdalny nie jest wersjonowany. |
String |
UNKNOWN_BUILD_ID
Wartość domyślna, gdy identyfikator kompilacji jest nieznany. |
Metody publiczne | |
---|---|
default
void
|
addAppPackageFile(File appPackageFile, String version)
Dodaje lokalny plik APK i powiązaną z nim wersję. |
abstract
void
|
addBuildAttribute(String attributeName, String attributeValue)
Dodaj atrybut kompilacji. |
default
void
|
addBuildAttributes(
Dodawanie atrybutów kompilacji |
default
void
|
allowStagingRemoteFile(boolean stageRemoteFile)
Ustawia uprawnienia, aby zezwolić na etapowanie plików zdalnych. |
abstract
void
|
cleanUp()
Usuń tymczasowe pliki kompilacji. |
abstract
void
|
cleanUp(
Wersja |
abstract
IBuildInfo
|
clone()
Klonuje obiekt |
default
|
getAppPackageFiles()
Pobiera kopię zestawu lokalnych plików APK aplikacji i ich wersji. |
abstract
|
getBuildAttributes()
Pobierz zestaw par nazwa-wartość dodatkowych atrybutów opisujących wersję. |
abstract
String
|
getBuildBranch()
Opcjonalna metoda zwracania gałęzi kontroli źródłowej, z której pochodzi testowana kompilacja. |
abstract
String
|
getBuildFlavor()
Opcjonalna metoda zwracania typu testowanej kompilacji. |
abstract
String
|
getBuildId()
Zwraca unikalny identyfikator wersji testowanej. |
abstract
String
|
getBuildTargetName()
Zwraca pełną nazwę testowanej wersji. |
abstract
String
|
getDeviceSerial()
|
abstract
File
|
getFile(String name)
Metoda pomocnicza do pobierania pliku o danej nazwie. |
default
File
|
getFile(BuildInfoKey.BuildInfoFileKey key)
Metoda pomocnicza do pobierania pliku o podanym identyfikatorze |
abstract
|
getFiles()
Zwraca wszystkie |
abstract
|
getProperties()
Zwraca kopię właściwości ustawionych w obiekcie |
default
|
getRemoteFiles()
Pobierz ścieżki do artefaktów kompilacji, które są opóźnione w pobieraniu. |
abstract
String
|
getTestTag()
Zwraca niepowtarzalną nazwę testów, które są wykonywane. |
default
String
|
getVersion(BuildInfoKey.BuildInfoFileKey key)
Metoda pomocnicza do pobierania wersji pliku z danym |
abstract
String
|
getVersion(String name)
Metoda pomocnicza do pobierania wersji pliku o określonej nazwie. |
default
VersionedFile
|
getVersionedFile(BuildInfoKey.BuildInfoFileKey key)
Metoda pomocnicza do pobierania |
default
VersionedFile
|
getVersionedFile(String name)
Metoda pomocnicza do pobierania |
default
|
getVersionedFileKeys()
Zwraca zestaw kluczy, których można używać do wysyłania zapytań do usługi |
default
|
getVersionedFiles(BuildInfoKey.BuildInfoFileKey key)
Metoda pomocnicza do pobierania listy |
default
void
|
removeBuildAttribute(String attributeName)
Usuń z śledzenia podany atrybut attributeName. |
abstract
void
|
setBuildBranch(String branch)
Ustawianie gałęzi kompilacji |
abstract
void
|
setBuildFlavor(String buildFlavor)
Ustaw wersję kompilacji. |
abstract
void
|
setBuildId(String buildId)
Ustawia unikalny identyfikator wersji testowanej. |
abstract
void
|
setDeviceSerial(String serial)
Ustaw numer seryjny |
abstract
void
|
setFile(String name, File file, String version)
Przechowuje plik o podanej nazwie w informacjach o tej kompilacji. |
default
void
|
setFile(BuildInfoKey.BuildInfoFileKey key, File file, String version)
Przechowuje plik o wartości |
abstract
void
|
setProperties(BuildInfoProperties... properties)
Ustaw wartość |
abstract
void
|
setTestTag(String testTag)
Ustawia niepowtarzalną nazwę testów, które są wykonywane. |
default
File
|
stageRemoteFile(String fileName, File workingDir)
Prześlij plik, który jest częścią plików zdalnych, do katalogu głównego informacji o kompilacji. |
default
BuildInformation.BuildInfo
|
toProto()
Serializuj instancję BuildInfo do formatu protobuf. |
Stałe
REMOTE_FILE_PREFIX
public static final String REMOTE_FILE_PREFIX
W nazwie pliku jest używany prefiks, który wskazuje, że plik ma być pobierany z opóźnieniem.
Wartość stała: "remote_file:"
REMOTE_FILE_VERSION
public static final String REMOTE_FILE_VERSION
Plik zdalny nie jest wersjonowany.
Wartość stała: ""
UNKNOWN_BUILD_ID
public static final String UNKNOWN_BUILD_ID
Wartość domyślna, gdy identyfikator kompilacji jest nieznany.
Wartość stała: "-1"
Metody publiczne
addAppPackageFile
public void addAppPackageFile (File appPackageFile, String version)
Dodaje lokalny plik APK i powiązaną z nim wersję. Pamiętaj, że apki będą zwracane z poziomu getAppPackageFiles()
w kolejności, w jakiej zostały dodane za pomocą tej metody.
Parametry | |
---|---|
appPackageFile |
File |
version |
String |
addBuildAttribute
public abstract void addBuildAttribute (String attributeName, String attributeValue)
Dodaj atrybut kompilacji. Nie pozwala to zastąpić istniejącego atrybutu attributeName.
Parametry | |
---|---|
attributeName |
String : niepowtarzalną nazwę atrybutu, |
attributeValue |
String : wartość atrybutu |
addBuildAttributes
public void addBuildAttributes (buildAttributes)
Dodawanie atrybutów kompilacji
Parametry | |
---|---|
buildAttributes |
: mapowanie atrybutów do dodania |
allowStagingRemoteFile
public void allowStagingRemoteFile (boolean stageRemoteFile)
Ustawia uprawnienia, aby zezwolić na etapowanie plików zdalnych.
Parametry | |
---|---|
stageRemoteFile |
boolean |
cleanUp
public abstract void cleanUp ()
Usuń tymczasowe pliki kompilacji.
cleanUp
public abstract void cleanUp (doNotDelete)
Wersja cleanUp()
, w której niektóre pliki nie zostały usunięte.
Parametry | |
---|---|
doNotDelete |
|
getAppPackageFiles
publicgetAppPackageFiles ()
Pobiera kopię zestawu lokalnych plików APK aplikacji i ich wersji. Zwrócona kolejność odpowiada kolejności dodawania plików APK do IAppBuildInfo
.
Zwroty | |
---|---|
|
getBuildAttributes
public abstractgetBuildAttributes ()
Pobierz zestaw par nazwa-wartość dodatkowych atrybutów opisujących wersję.
Zwroty | |
---|---|
|
ERROR(/Map) atrybutów kompilacji. Nie może być null , ale może być puste. |
getBuildBranch
public abstract String getBuildBranch ()
Opcjonalna metoda zwracania gałęzi kontroli źródłowej, z której pochodzi testowana kompilacja.
Zwroty | |
---|---|
String |
gałąź kompilacji lub null , jeśli nie została skonfigurowana lub nie dotyczy |
getBuildFlavor
public abstract String getBuildFlavor ()
Opcjonalna metoda zwracania typu testowanej kompilacji.
Typowym rozwiązaniem w przypadku kompilacji na platformę Android jest zwracanie parametrów (produkt)-(system operacyjny)-(wariant kompilacji). ie generic-linux-userdebug
Zwroty | |
---|---|
String |
wersję kompilacji lub null , jeśli nie została ustawiona lub nie ma zastosowania; |
getBuildId
public abstract String getBuildId ()
Zwraca unikalny identyfikator wersji testowanej. Nigdy nie powinien być pusty. Domyślna wartość to UNKNOWN_BUILD_ID
.
Zwroty | |
---|---|
String |
getBuildTargetName
public abstract String getBuildTargetName ()
Zwraca pełną nazwę testowanej wersji.
Typowym rozwiązaniem jest tworzenie nazwy docelowej kompilacji przez połączenie wersji kompilacji i nazwy gałęzi. [np. (nazwa gałęzi)-(wersja kompilacji)]
Zwroty | |
---|---|
String |
getDeviceSerial
public abstract String getDeviceSerial ()
Zwroty | |
---|---|
String |
numer seryjny ITestDevice , na którym została uruchomiona ta kompilacja. Zwraca wartość null
, jeśli z tą wersją nie jest powiązane żadne urządzenie. |
getFile
public abstract File getFile (String name)
Metoda pomocnicza do pobierania pliku o danej nazwie.
Zwroty | |
---|---|
File |
plik obrazu lub null , jeśli go nie znaleziono |
getFile
public File getFile (BuildInfoKey.BuildInfoFileKey key)
Metoda pomocnicza do pobierania pliku o podanym identyfikatorze BuildInfoFileKey
.
Parametry | |
---|---|
key |
BuildInfoKey.BuildInfoFileKey : BuildInfoFileKey , o który prosisz. |
Zwroty | |
---|---|
File |
plik obrazu lub null , jeśli go nie znaleziono |
getFiles
public abstractgetFiles ()
Zwraca wszystkie VersionedFile
przechowywane w tym BuildInfo
.
Zwroty | |
---|---|
|
getProperties
public abstractgetProperties ()
Zwraca kopię właściwości ustawionych w obiekcie IBuildInfo
.
Zwroty | |
---|---|
|
getRemoteFiles
publicgetRemoteFiles ()
Pobierz ścieżki do artefaktów kompilacji, które są opóźnione w pobieraniu.
Zwroty | |
---|---|
|
getTestTag
public abstract String getTestTag ()
Zwraca niepowtarzalną nazwę testów, które są wykonywane.
Zwroty | |
---|---|
String |
getVersion
public String getVersion (BuildInfoKey.BuildInfoFileKey key)
Metoda pomocnicza do pobierania wersji pliku z danym BuildInfoFileKey
.
Parametry | |
---|---|
key |
BuildInfoKey.BuildInfoFileKey : BuildInfoFileKey żądane. |
Zwroty | |
---|---|
String |
wersję obrazu lub null , jeśli nie można go znaleźć; |
getVersion
public abstract String getVersion (String name)
Metoda pomocnicza do pobierania wersji pliku o określonej nazwie.
Zwroty | |
---|---|
String |
wersję obrazu lub null , jeśli nie można go znaleźć; |
getVersionedFile
public VersionedFile getVersionedFile (BuildInfoKey.BuildInfoFileKey key)
Metoda pomocnicza do pobierania VersionedFile
z danym BuildInfoFileKey
.
Parametry | |
---|---|
key |
BuildInfoKey.BuildInfoFileKey : BuildInfoFileKey żądane. |
Zwroty | |
---|---|
VersionedFile |
plik z wersjami lub null , jeśli go nie ma; |
getVersionedFile
public VersionedFile getVersionedFile (String name)
Metoda pomocnicza do pobierania VersionedFile
o danej nazwie.
Zwroty | |
---|---|
VersionedFile |
plik z wersjami lub null , jeśli go nie ma; |
getVersionedFileKeys
publicgetVersionedFileKeys ()
Zwraca zestaw kluczy, których można używać do wysyłania zapytań do usługi VersionedFile
za pomocą interfejsu getFile(BuildInfoFileKey)
.
Zwroty | |
---|---|
|
getVersionedFiles
publicgetVersionedFiles (BuildInfoKey.BuildInfoFileKey key)
Metoda pomocnicza do pobierania listy VersionedFile
powiązanych z danym BuildInfoFileKey
. czy klucz umożliwia przechowywanie listy.
Parametry | |
---|---|
key |
BuildInfoKey.BuildInfoFileKey : BuildInfoFileKey żądane. |
Zwroty | |
---|---|
|
plik z wersjami lub null , jeśli go nie ma; |
removeBuildAttribute
public void removeBuildAttribute (String attributeName)
Usuń z śledzenia podany atrybut attributeName.
Parametry | |
---|---|
attributeName |
String : atrybut, który ma przestać być śledzony |
setBuildBranch
public abstract void setBuildBranch (String branch)
Ustawianie gałęzi kompilacji
Parametry | |
---|---|
branch |
String : nazwa gałęzi; |
setBuildFlavor
public abstract void setBuildFlavor (String buildFlavor)
Ustaw wersję kompilacji.
setBuildId
public abstract void setBuildId (String buildId)
Ustawia unikalny identyfikator wersji testowanej. Nigdy nie powinien być pusty.
Parametry | |
---|---|
buildId |
String |
setDeviceSerial
public abstract void setDeviceSerial (String serial)
Ustaw numer seryjny ITestDevice
powiązany z tą wersją.
Parametry | |
---|---|
serial |
String : numer seryjny ITestDevice , z którym została wykonana ta kompilacja. |
setFile
public abstract void setFile (String name, File file, String version)
Przechowuje plik o podanej nazwie w informacjach o tej kompilacji.
Parametry | |
---|---|
name |
String : unikalna nazwa pliku. |
file |
File : lokalny ERROR(/File) |
version |
String : wersja pliku |
setFile
public void setFile (BuildInfoKey.BuildInfoFileKey key, File file, String version)
Przechowuje plik o wartości BuildInfoFileKey
w informacjach o tej kompilacji.
Parametry | |
---|---|
key |
BuildInfoKey.BuildInfoFileKey : unikalna nazwa pliku utworzona na podstawie parametru BuildInfoFileKey . |
file |
File : lokalny ERROR(/File) |
version |
String : wersja pliku |
setProperties
public abstract void setProperties (BuildInfoProperties... properties)
Ustaw wartość BuildInfoProperties
dla instancji IBuildInfo
. Zastąpić wszystkie wcześniej ustawione właściwości.
Parametry | |
---|---|
properties |
BuildInfoProperties : lista właściwości do dodania. |
setTestTag
public abstract void setTestTag (String testTag)
Ustawia niepowtarzalną nazwę testów, które są wykonywane.
Parametry | |
---|---|
testTag |
String |
stageRemoteFile
public File stageRemoteFile (String fileName, File workingDir)
Prześlij plik, który jest częścią plików zdalnych, do katalogu głównego informacji o kompilacji.
TODO(b/138416078): usuń ten interfejs i jego wywołanie, gdy moduły wymagane przez test mogą być poprawnie wygenerowane w samej lokalizacji modułu testowego.
Parametry | |
---|---|
fileName |
String : nazwa pliku, który ma znajdować się w plikach zdalnych. |
workingDir |
File : obiekt ERROR(/File) katalogu do umieszczenia pliku. |
Zwroty | |
---|---|
File |
obiekt ERROR(/File) pliku przygotowanego w lokalnym katalogu roboczym. |
toProto
public BuildInformation.BuildInfo toProto ()
Serializuj instancję BuildInfo do formatu protobuf.
Zwroty | |
---|---|
BuildInformation.BuildInfo |