Informacje o budowie
public interface IBuildInfo
com.android.tradefed.build.IBuildInfo |
Przechowuje informacje o testowanej kompilacji.
Streszczenie
Stałe | |
---|---|
String | REMOTE_FILE_PREFIX Przedrostek używany w nazwie wskazujący, że pobieranie pliku 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 ( buildAttributes) addBuildAttributes ( buildAttributes) Dodaj atrybuty kompilacji |
default void | allowStagingRemoteFile (boolean stageRemoteFile) Ustawia uprawnienia umożliwiające przechowywanie zdalnych plików. |
abstract void | cleanUp () Wyczyść wszystkie tymczasowe pliki kompilacji |
abstract void | cleanUp ( doNotDelete) cleanUp ( doNotDelete) Wersja funkcji |
abstract IBuildInfo | clone () Klonuje obiekt |
default | getAppPackageFiles () Pobiera kopię zestawu plików apk aplikacji lokalnych i ich wersje. |
abstract | getBuildAttributes () Uzyskaj zestaw par nazwa-wartość dodatkowych atrybutów opisujących kompilację. |
abstract String | getBuildBranch () Opcjonalna metoda zwracania gałęzi kontroli źródła, z której utworzono testowaną kompilację. |
abstract String | getBuildFlavor () Opcjonalna metoda zwracania typu testowanej kompilacji. |
abstract String | getBuildId () Zwraca unikalny identyfikator testowanej kompilacji. |
abstract String | getBuildTargetName () Zwróć pełną nazwę testowanej kompilacji. |
abstract String | getDeviceSerial () |
abstract File | getFile (String name) Metoda pomocnicza do pobrania pliku o podanej nazwie. |
default File | getFile ( BuildInfoKey.BuildInfoFileKey key) Metoda pomocnicza do pobrania pliku z danym |
abstract | getFiles () Zwraca wszystkie |
abstract | getProperties () Zwraca kopię właściwości aktualnie ustawionych w |
default | getRemoteFiles () Pobierz ścieżki dla artefaktów kompilacji, których pobieranie jest opóźnione. |
abstract String | getTestTag () Zwróć unikalną nazwę uruchamianych testów. |
default String | getVersion ( BuildInfoKey.BuildInfoFileKey key) Metoda pomocnicza do pobierania wersji pliku z danym |
abstract String | getVersion (String name) Metoda pomocnicza do pobrania wersji pliku o podanej 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 dostępnych do wysyłania zapytań do |
default | getVersionedFiles ( BuildInfoKey.BuildInfoFileKey key) Metoda pomocnicza do pobierania listy |
default void | removeBuildAttribute (String attributeName) Usuń daną nazwę atrybutu ze śledzenia. |
abstract void | setBuildBranch (String branch) Ustaw gałąź kompilacji |
abstract void | setBuildFlavor (String buildFlavor) Ustaw smak 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 informacjach o kompilacji. |
default void | setFile ( BuildInfoKey.BuildInfoFileKey key, File file, String version) Przechowuje plik z danym |
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 będący częścią plików zdalnych w katalogu głównym informacji o kompilacji. |
default BuildInformation.BuildInfo | toProto () Serializuj instancję BuildInfo do protobuf. |
Stałe
REMOTE_FILE_PREFIX
public static final String REMOTE_FILE_PREFIX
Przedrostek używany w nazwie wskazujący, że pobieranie pliku jest opóźnione.
Wartość stała: „zdalny_plik:”
REMOTE_FILE_VERSION
public static final String REMOTE_FILE_VERSION
Plik zdalny nie ma wersji.
Stała wartość: ""
NIEZNANY_BUILD_ID
public static final String UNKNOWN_BUILD_ID
Wartość domyślna, gdy identyfikator kompilacji jest nieznany.
Wartość stała: „-1”
Metody publiczne
dodaj plik pakietu aplikacji
public void addAppPackageFile (File appPackageFile, String version)
Dodaje lokalny plik apk i powiązaną z nim wersję. Pamiętaj, że apki zostaną zwrócone przez getAppPackageFiles()
w kolejności, w jakiej zostały dodane tą metodą.
Parametry | |
---|---|
appPackageFile | File |
version | String |
dodaj atrybut kompilacji
public abstract void addBuildAttribute (String attributeName, String attributeValue)
Dodaj atrybut kompilacji. Nie pozwala to na zastąpienie istniejącego atrybutuName.
Parametry | |
---|---|
attributeName | String : unikalna nazwa atrybutu |
attributeValue | String : wartość atrybutu |
dodajAtrybuty kompilacji
public void addBuildAttributes (buildAttributes)
Dodaj atrybuty kompilacji
Parametry | |
---|---|
buildAttributes |
Zezwalaj na plik zdalnyStagingRemote
public void allowStagingRemoteFile (boolean stageRemoteFile)
Ustawia uprawnienia umożliwiające przechowywanie zdalnych plików.
Parametry | |
---|---|
stageRemoteFile | boolean |
posprzątać
public abstract void cleanUp ()
Wyczyść wszystkie tymczasowe pliki kompilacji
posprzątać
public abstract void cleanUp (doNotDelete)
Wersja funkcji cleanUp()
, w której niektóre pliki nie są usuwane.
Parametry | |
---|---|
doNotDelete |
getAppPackageFiles
publicgetAppPackageFiles ()
Pobiera kopię zestawu plików apk aplikacji lokalnych i ich wersje. Zwrócona kolejność jest zgodna z kolejnością, w jakiej apki zostały dodane do IAppBuildInfo
.
Zwroty | |
---|---|
pobierzAtrybuty kompilacji
public abstractgetBuildAttributes ()
Uzyskaj zestaw par nazwa-wartość dodatkowych atrybutów opisujących kompilację.
Zwroty | |
---|---|
ERROR(/Map) atrybutów kompilacji. Nie będzie null , ale może być pusty. |
getBuildBranch
public abstract String getBuildBranch ()
Opcjonalna metoda zwracania gałęzi kontroli źródła, z której utworzono testowaną kompilację.
Zwroty | |
---|---|
String | gałąź kompilacji lub null , jeśli jest nieustawiona/nie dotyczy |
pobierzBuildFlavor
public abstract String getBuildFlavor ()
Opcjonalna metoda zwracania typu testowanej kompilacji.
Typową implementacją kompilacji platformy Android jest zwrócenie (kompilacja produktu) - (kompilacja systemu operacyjnego) - (wariant kompilacji). tj. ogólny-linux-userdebugZwroty | |
---|---|
String | smak kompilacji lub null , jeśli nieustawiony/nie dotyczy |
getBuildId
public abstract String getBuildId ()
Zwraca unikalny identyfikator testowanej kompilacji. Nigdy nie powinna mieć wartości null. Domyślnie UNKNOWN_BUILD_ID
.
Zwroty | |
---|---|
String |
getBuildTargetName
public abstract String getBuildTargetName ()
Zwróć pełną nazwę testowanej kompilacji.
Typową implementacją jest konstruowanie nazwy docelowej kompilacji na podstawie kombinacji stylu kompilacji i nazwy gałęzi. [tj. (nazwa oddziału) - (budowa smaku)]Zwroty | |
---|---|
String |
pobierz numer urządzenia
public abstract String getDeviceSerial ()
Zwroty | |
---|---|
String | numer seryjny ITestDevice , na którym została wykonana ta kompilacja. Zwraca null , jeśli z tą kompilacją nie jest powiązane żadne urządzenie. |
dostać plik
public abstract File getFile (String name)
Metoda pomocnicza do pobrania pliku o podanej nazwie.
Zwroty | |
---|---|
File | plik obrazu lub null , jeśli nie zostanie znaleziony |
dostać plik
public File getFile (BuildInfoKey.BuildInfoFileKey key)
Metoda pomocnicza do pobrania pliku z danym BuildInfoFileKey
.
Parametry | |
---|---|
key | BuildInfoKey.BuildInfoFileKey : żądany BuildInfoFileKey . |
Zwroty | |
---|---|
File | plik obrazu lub null , jeśli nie zostanie znaleziony |
pobierz pliki
public abstractgetFiles ()
Zwraca wszystkie VersionedFile
przechowywane w tym BuildInfo
.
Zwroty | |
---|---|
pobierz Właściwości
public abstractgetProperties ()
Zwraca kopię właściwości aktualnie ustawionych w IBuildInfo
.
Zwroty | |
---|---|
pobierz pliki zdalne
publicgetRemoteFiles ()
Pobierz ścieżki dla artefaktów kompilacji, których pobieranie jest opóźnione.
Zwroty | |
---|---|
pobierzTestTag
public abstract String getTestTag ()
Zwróć unikalną nazwę uruchamianych testów.
Zwroty | |
---|---|
String |
pobierz wersję
public String getVersion (BuildInfoKey.BuildInfoFileKey key)
Metoda pomocnicza do pobierania wersji pliku z danym BuildInfoFileKey
.
Parametry | |
---|---|
key | BuildInfoKey.BuildInfoFileKey : Żądany BuildInfoFileKey . |
Zwroty | |
---|---|
String | wersję obrazu lub null , jeśli nie została znaleziona |
pobierz wersję
public abstract String getVersion (String name)
Metoda pomocnicza do pobrania wersji pliku o podanej nazwie.
Zwroty | |
---|---|
String | wersję obrazu lub null , jeśli nie została znaleziona |
pobierz plik wersji
public VersionedFile getVersionedFile (BuildInfoKey.BuildInfoFileKey key)
Metoda pomocnicza do pobierania VersionedFile
z danym BuildInfoFileKey
.
Parametry | |
---|---|
key | BuildInfoKey.BuildInfoFileKey : Żądany BuildInfoFileKey . |
Zwroty | |
---|---|
VersionedFile | Wersjonowany plik lub null , jeśli nie został znaleziony |
pobierz plik wersji
public VersionedFile getVersionedFile (String name)
Metoda pomocnicza do pobierania VersionedFile
o podanej nazwie.
Zwroty | |
---|---|
VersionedFile | Wersjonowany plik lub null , jeśli nie został znaleziony |
getVersionedFileKeys
publicgetVersionedFileKeys ()
Zwraca zestaw kluczy dostępnych do wysyłania zapytań do VersionedFile
za pomocą getFile(BuildInfoFileKey)
.
Zwroty | |
---|---|
pobierz pliki wersji
publicgetVersionedFiles (BuildInfoKey.BuildInfoFileKey key)
Metoda pomocnicza do pobierania listy VersionedFile
s skojarzonych z danym BuildInfoFileKey
. Jeśli klucz pozwala na przechowywanie listy.
Parametry | |
---|---|
key | BuildInfoKey.BuildInfoFileKey : Żądany BuildInfoFileKey . |
Zwroty | |
---|---|
Wersjonowany plik lub null , jeśli nie został znaleziony |
usuń atrybut kompilacji
public void removeBuildAttribute (String attributeName)
Usuń daną nazwę atrybutu ze śledzenia.
Parametry | |
---|---|
attributeName | String : atrybut zatrzymujący śledzenie |
setBuildBranch
public abstract void setBuildBranch (String branch)
Ustaw gałąź kompilacji
Parametry | |
---|---|
branch | String : nazwa oddziału |
setBuildFlavour
public abstract void setBuildFlavor (String buildFlavor)
Ustaw smak kompilacji.
setBuildId
public abstract void setBuildId (String buildId)
Ustawia unikalny identyfikator testowanej kompilacji. Nigdy nie powinna mieć wartości null.
Parametry | |
---|---|
buildId | String |
ustaw numer seryjny urządzenia
public abstract void setDeviceSerial (String serial)
Ustaw numer seryjny ITestDevice
powiązany z tą kompilacją.
Parametry | |
---|---|
serial | String : numer seryjny urządzenia ITestDevice , za pomocą którego wykonano tę kompilację. |
ustawPlik
public abstract void setFile (String name, File file, String version)
Przechowuje plik o podanej nazwie w informacjach o kompilacji.
Parametry | |
---|---|
name | String : unikalna nazwa pliku |
file | File : lokalny ERROR(/File) |
version | String : wersja pliku |
ustawPlik
public void setFile (BuildInfoKey.BuildInfoFileKey key, File file, String version)
Przechowuje plik z danym BuildInfoFileKey
w tych informacjach o kompilacji.
Parametry | |
---|---|
key | BuildInfoKey.BuildInfoFileKey : unikalna nazwa pliku oparta na BuildInfoFileKey . |
file | File : lokalny ERROR(/File) |
version | String : wersja pliku |
ustawWłaściwości
public abstract void setProperties (BuildInfoProperties... properties)
Ustaw BuildInfoProperties
dla instancji IBuildInfo
. Zastąp wszystkie istniejące właściwości ustawione wcześniej.
Parametry | |
---|---|
properties | BuildInfoProperties : Lista właściwości do dodania. |
ustawTestTag
public abstract void setTestTag (String testTag)
Ustawia unikalną nazwę uruchamianych testów.
Parametry | |
---|---|
testTag | String |
plik stageRemote
public File stageRemoteFile (String fileName, File workingDir)
Przygotuj plik będący częścią plików zdalnych w katalogu głównym informacji o kompilacji.
DO ZROBIENIA (b/138416078): Usuń ten interfejs i jego funkcję wywołującą, gdy moduły wymagane przez test mogą zostać poprawnie zbudowane i wyprowadzone do samego katalogu modułu testowego.
Parametry | |
---|---|
fileName | String : Nazwa pliku, który ma się znajdować w plikach zdalnych. |
workingDir | File : obiekt ERROR(/File) katalogu służący do przygotowania pliku. |
Zwroty | |
---|---|
File | obiekt ERROR(/File) pliku umieszczonego w lokalnym katalogu roboczym. |
doProto
public BuildInformation.BuildInfo toProto ()
Serializuj instancję BuildInfo do protobuf.
Zwroty | |
---|---|
BuildInformation.BuildInfo |