iBuildInfo
public
interface
IBuildInfo
com.android.tradefed.build.IBuildInfo |
Przechowuje informacje o testowanej kompilacji.
Podsumowanie
Stałe | |
---|---|
String |
REMOTE_FILE_PREFIX
Prefiks używany w nazwie, który wskazuje, że pobieranie jest opóźnione. |
String |
REMOTE_FILE_VERSION
Plik zdalny nie ma wersji. |
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(
Dodaj atrybuty kompilacji |
default
void
|
allowStagingRemoteFile(boolean stageRemoteFile)
Określa uprawnienia zezwalające na przejściowe pliki zdalne. |
abstract
void
|
cleanUp()
Usuń wszelkie tymczasowe pliki kompilacji |
abstract
void
|
cleanUp(
Wersja |
abstract
IBuildInfo
|
clone()
Kopiuje obiekt |
default
|
getAppPackageFiles()
Pobiera kopię zestawu plików APK aplikacji lokalnych i ich wersji. |
abstract
|
getBuildAttributes()
Pobierz zbiór par nazwa-wartość dodatkowych atrybutów opisujących kompilację. |
abstract
String
|
getBuildBranch()
Opcjonalna metoda zwracająca źródłową gałąź kontrolną, na której była testowana kompilacja z którego pochodzą. |
abstract
String
|
getBuildFlavor()
Metoda opcjonalna zwracająca typ testowanej kompilacji. |
abstract
String
|
getBuildId()
Zwraca unikalny identyfikator testowanej kompilacji. |
abstract
String
|
getBuildTargetName()
Zwraca pełną nazwę testowanej kompilacji. |
abstract
String
|
getDeviceSerial()
|
abstract
File
|
getFile(String name)
Metoda pomocnicza do pobierania pliku o podanej nazwie. |
default
File
|
getFile(BuildInfoKey.BuildInfoFileKey key)
Metoda pomocnicza do pobierania pliku z określonym atrybutem |
abstract
|
getFiles()
Zwraca wszystkie |
abstract
|
getProperties()
Zwraca kopię właściwości ustawionych obecnie w: |
default
|
getRemoteFiles()
Pobierz ścieżki do artefaktów kompilacji, które są pobierane z opóźnieniem. |
abstract
String
|
getTestTag()
Zwraca unikalną nazwę uruchamianych testów. |
default
String
|
getVersion(BuildInfoKey.BuildInfoFileKey key)
Metoda pomocnicza do pobierania wersji pliku z określonym atrybutem |
abstract
String
|
getVersion(String name)
Metoda pomocnicza do pobierania wersji pliku o podanej nazwie. |
default
VersionedFile
|
getVersionedFile(BuildInfoKey.BuildInfoFileKey key)
Metoda pomocnicza do pobierania żądania |
default
VersionedFile
|
getVersionedFile(String name)
Metoda pomocnicza do pobierania obiektu |
default
|
getVersionedFileKeys()
Zwraca zbiór kluczy dostępnych do wykonania zapytania |
default
|
getVersionedFiles(BuildInfoKey.BuildInfoFileKey key)
Metoda pomocnicza do pobierania listy elementów |
default
void
|
removeBuildAttribute(String attributeName)
Usunąć atrybut „attributeName” ze śledzenia. |
abstract
void
|
setBuildBranch(String branch)
Ustaw gałąź kompilacji |
abstract
void
|
setBuildFlavor(String buildFlavor)
Ustaw rodzaj kompilacji. |
abstract
void
|
setBuildId(String buildId)
Ustawia unikalny identyfikator testowanej kompilacji. |
abstract
void
|
setDeviceSerial(String serial)
Ustaw numer seryjny |
abstract
void
|
setFile(String name, File file, String version)
Przechowuje plik o podanej nazwie w tych informacjach o kompilacji. |
default
void
|
setFile(BuildInfoKey.BuildInfoFileKey key, File file, String version)
Przechowuje plik z wskaźnikiem |
abstract
void
|
setProperties(BuildInfoProperties... properties)
Ustaw |
abstract
void
|
setTestTag(String testTag)
Ustawia unikalną nazwę uruchamianych testów. |
default
File
|
stageRemoteFile(String fileName, File workingDir)
Przygotuj plik, który jest częścią plików zdalnych, w katalogu głównym informacji o kompilacji. |
default
BuildInformation.BuildInfo
|
toProto()
Zserializuj instancję BuildInfo w protobufie. |
Stałe
REMOTE_FILE_PREFIX
public static final String REMOTE_FILE_PREFIX
Prefiks używany w nazwie, który wskazuje, że pobieranie jest opóźnione.
Wartość stała: „remote_file:”
WERSJA PLIKU_ZDALNEGO
public static final String REMOTE_FILE_VERSION
Plik zdalny nie ma wersji.
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 pakiety APK będą zwracane z
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 można zastąpić istniejącej nazwy atrybutu.
Parametry | |
---|---|
attributeName |
String : unikalna nazwa atrybutu |
attributeValue |
String : wartość atrybutu |
dodajAtrybuty kompilacji
public void addBuildAttributes (buildAttributes)
Dodaj atrybuty kompilacji
Parametry | |
---|---|
buildAttributes |
: mapa atrybutów do dodania |
allowStagingRemoteFile
public void allowStagingRemoteFile (boolean stageRemoteFile)
Określa uprawnienia zezwalające na przejściowe pliki zdalne.
Parametry | |
---|---|
stageRemoteFile |
boolean |
czyszczenie
public abstract void cleanUp ()
Usuń wszelkie tymczasowe pliki kompilacji
czyszczenie
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 plików APK aplikacji lokalnych i ich wersji. Zwrócone zamówienie
odpowiada kolejności dodania pakietów apk do IAppBuildInfo
.
Zwroty | |
---|---|
|
getBuildAttributes
public abstractgetBuildAttributes ()
Pobierz zbiór par nazwa-wartość dodatkowych atrybutów opisujących kompilację.
Zwroty | |
---|---|
|
ERROR(/Map) atrybutów kompilacji. To nie jest pole null , ale może być puste. |
getBuildBranch
public abstract String getBuildBranch ()
Opcjonalna metoda zwracająca źródłową gałąź kontrolną, na której była testowana kompilacja z którego pochodzą.
Zwroty | |
---|---|
String |
gałąź kompilacji lub null , jeśli jest nieskonfigurowana/nie ma zastosowania |
PobierzKompilacjaFlavor
public abstract String getBuildFlavor ()
Metoda opcjonalna zwracająca typ testowanej kompilacji.
W przypadku kompilacji platformy Android często stosowany jest zwrot (skompiluj produkt)-(kompiluj system operacyjny)-(utwórz wariant). ie general-linux-userdebug
Zwroty | |
---|---|
String |
rodzaj kompilacji lub null , jeśli nie jest ustawiony lub nie ma zastosowania |
getBuildId
public abstract String getBuildId ()
Zwraca unikalny identyfikator testowanej kompilacji. Nigdy nie może mieć wartości null. Domyślna wartość to UNKNOWN_BUILD_ID
.
Zwroty | |
---|---|
String |
getBuildTargetName
public abstract String getBuildTargetName ()
Zwraca pełną nazwę testowanej kompilacji.
Typowym wdrożeniem jest utworzenie nazwy celu kompilacji na podstawie kombinacji rodzaj kompilacji i nazwę gałęzi. [np (nazwa oddziału)-(rodzaj kompilacji)]
Zwroty | |
---|---|
String |
getDeviceSerial
public abstract String getDeviceSerial ()
Zwroty | |
---|---|
String |
numer seryjny ITestDevice , na którym została wykonana ta kompilacja. Zwraca wartość null
, jeśli z tą kompilacją nie jest powiązane żadne urządzenie. |
getFile
public abstract File getFile (String name)
Metoda pomocnicza do pobierania pliku o podanej nazwie.
Zwroty | |
---|---|
File |
plik obrazu lub null , jeśli go nie znaleziono |
getFile
public File getFile (BuildInfoKey.BuildInfoFileKey key)
Metoda pomocnicza do pobierania pliku z określonym atrybutem BuildInfoFileKey
.
Parametry | |
---|---|
key |
BuildInfoKey.BuildInfoFileKey : żądane BuildInfoFileKey . |
Zwroty | |
---|---|
File |
plik obrazu lub null , jeśli go nie znaleziono |
getFiles,
public abstractgetFiles ()
Zwraca wszystkie VersionedFile
przechowywane w BuildInfo
.
Zwroty | |
---|---|
|
getWłaściwości
public abstractgetProperties ()
Zwraca kopię właściwości ustawionych obecnie w: IBuildInfo
.
Zwroty | |
---|---|
|
getRemoteFiles
publicgetRemoteFiles ()
Pobierz ścieżki do artefaktów kompilacji, które są pobierane z opóźnieniem.
Zwroty | |
---|---|
|
getTestTag
public abstract String getTestTag ()
Zwraca unikalną nazwę uruchamianych testów.
Zwroty | |
---|---|
String |
getVersion
public String getVersion (BuildInfoKey.BuildInfoFileKey key)
Metoda pomocnicza do pobierania wersji pliku z określonym atrybutem BuildInfoFileKey
.
Parametry | |
---|---|
key |
BuildInfoKey.BuildInfoFileKey : BuildInfoFileKey . |
Zwroty | |
---|---|
String |
wersja obrazu lub null , jeśli nie znaleziono |
getVersion
public abstract String getVersion (String name)
Metoda pomocnicza do pobierania wersji pliku o podanej nazwie.
Zwroty | |
---|---|
String |
wersja obrazu lub null , jeśli nie znaleziono |
Plik getVersioned
public VersionedFile getVersionedFile (BuildInfoKey.BuildInfoFileKey key)
Metoda pomocnicza do pobierania żądania VersionedFile
z określonym BuildInfoFileKey
.
Parametry | |
---|---|
key |
BuildInfoKey.BuildInfoFileKey : BuildInfoFileKey . |
Zwroty | |
---|---|
VersionedFile |
Plik z włączoną obsługą wersji lub null , jeśli nie znaleziono |
Plik getVersioned
public VersionedFile getVersionedFile (String name)
Metoda pomocnicza do pobierania obiektu VersionedFile
o podanej nazwie.
Zwroty | |
---|---|
VersionedFile |
Plik z włączoną obsługą wersji lub null , jeśli nie znaleziono |
Klucze getVersionedFileKeys
publicgetVersionedFileKeys ()
Zwraca zbiór kluczy dostępnych do wykonania zapytania VersionedFile
za pomocą getFile(BuildInfoFileKey)
.
Zwroty | |
---|---|
|
getVersionedFiles,
publicgetVersionedFiles (BuildInfoKey.BuildInfoFileKey key)
Metoda pomocnicza do pobierania listy elementów VersionedFile
powiązanych z danym BuildInfoFileKey
. Jeśli klucz umożliwia przechowywanie listy.
Parametry | |
---|---|
key |
BuildInfoKey.BuildInfoFileKey : BuildInfoFileKey . |
Zwroty | |
---|---|
|
Plik z włączoną obsługą wersji lub null , jeśli nie znaleziono |
removeBuildAttribute
public void removeBuildAttribute (String attributeName)
Usunąć atrybut „attributeName” ze śledzenia.
Parametry | |
---|---|
attributeName |
String : atrybut do zatrzymania śledzenia. |
setBuildBranch
public abstract void setBuildBranch (String branch)
Ustaw gałąź kompilacji
Parametry | |
---|---|
branch |
String : nazwa oddziału. |
ustawBuildFlavor
public abstract void setBuildFlavor (String buildFlavor)
Ustaw rodzaj kompilacji.
Identyfikator setBuildId
public abstract void setBuildId (String buildId)
Ustawia unikalny identyfikator testowanej kompilacji. Nigdy nie może mieć wartości null.
Parametry | |
---|---|
buildId |
String |
setDeviceSerial
public abstract void setDeviceSerial (String serial)
Ustaw numer seryjny ITestDevice
powiązany z tą kompilacją.
Parametry | |
---|---|
serial |
String : numer seryjny modelu ITestDevice , za pomocą którego została wykonana ta kompilacja. |
plik set
public abstract void setFile (String name, File file, String version)
Przechowuje plik o podanej nazwie w tych informacjach o kompilacji.
Parametry | |
---|---|
name |
String : unikalna nazwa pliku, |
file |
File : lokalny ERROR(/File) |
version |
String : wersja pliku, |
plik set
public void setFile (BuildInfoKey.BuildInfoFileKey key, File file, String version)
Przechowuje plik z wskaźnikiem BuildInfoFileKey
w tych informacjach o kompilacji.
Parametry | |
---|---|
key |
BuildInfoKey.BuildInfoFileKey : unikalna nazwa pliku na podstawie BuildInfoFileKey . |
file |
File : lokalny ERROR(/File) |
version |
String : wersja pliku, |
setWłaściwości
public abstract void setProperties (BuildInfoProperties... properties)
Ustaw BuildInfoProperties
dla instancji IBuildInfo
. Zastąp dowolne
ustawione wcześniej właściwości.
Parametry | |
---|---|
properties |
BuildInfoProperties : lista właściwości do dodania. |
setTestTag
public abstract void setTestTag (String testTag)
Ustawia unikalną nazwę uruchamianych testów.
Parametry | |
---|---|
testTag |
String |
etapieZdalnaplikat
public File stageRemoteFile (String fileName, File workingDir)
Przygotuj plik, który jest częścią plików zdalnych, w katalogu głównym informacji o kompilacji.
TODO(b/138416078): usuń ten interfejs i jego element wywołujący, gdy moduły są wymagane przez test można prawidłowo umieścić dane wyjściowe w katalogu modułu testowego.
Parametry | |
---|---|
fileName |
String : nazwa pliku, który ma znajdować się w plikach zdalnych. |
workingDir |
File : obiekt ERROR(/File) katalogu służący do testowania pliku. |
Zwroty | |
---|---|
File |
Obiekt ERROR(/File) pliku przestawiony w lokalnym narzędziu WorkDir. |
toProto
public BuildInformation.BuildInfo toProto ()
Zserializuj instancję BuildInfo w protobufie.
Zwroty | |
---|---|
BuildInformation.BuildInfo |