Informacje o kompilacji
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 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 ( buildAttributes) addBuildAttributes ( buildAttributes) Dodaj atrybuty kompilacji |
abstract void | cleanUp () Wyczyść wszelkie tymczasowe pliki kompilacji |
abstract void | cleanUp ( doNotDelete) cleanUp ( doNotDelete) Wersja |
abstract IBuildInfo | clone () Klonuje obiekt |
default | getAppPackageFiles () Pobiera kopię zestawu plików APK aplikacji lokalnej i ich wersji. |
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 została wyprodukowana testowana kompilacja. |
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 pobierania pliku o podanej nazwie. |
default File | getFile ( BuildInfoKey.BuildInfoFileKey key) Metoda pomocnika do pobierania pliku z podanym |
abstract | getFiles () Zwraca wszystkie |
abstract | getProperties () Zwraca kopię właściwości aktualnie ustawionych w |
default | getRemoteFiles () Pobierz ścieżki do 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 pomocnika do pobierania wersji pliku z podanym |
abstract String | getVersion (String name) Metoda pomocnicza do pobierania wersji pliku o podanej nazwie. |
default VersionedFile | getVersionedFile ( BuildInfoKey.BuildInfoFileKey key) Metoda pomocnika do pobierania |
default VersionedFile | getVersionedFile (String name) Metoda pomocnika do pobierania |
default | getVersionedFileKeys () Zwraca zestaw kluczy dostępnych do zapytania |
default | getVersionedFiles ( BuildInfoKey.BuildInfoFileKey key) Metoda pomocnika 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 tej informacji o kompilacji. |
default void | setFile ( BuildInfoKey.BuildInfoFileKey key, File file, String version) Przechowuje plik, któremu podano |
abstract void | setProperties ( BuildInfoProperties... properties) Ustaw |
abstract void | setTestTag (String testTag) Ustawia unikatową 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.
Stała wartość: „zdalny_plik:”
REMOTE_FILE_VERSION
public static final String REMOTE_FILE_VERSION
Plik zdalny nie jest wersjonowany.
Stała wartość: ""
UNKNOWN_BUILD_ID
public static final String UNKNOWN_BUILD_ID
Wartość domyślna, gdy identyfikator kompilacji jest nieznany.
Stała wartość: „-1”
Metody publiczne
dodaj plik pakietu aplikacji
public void addAppPackageFile (File appPackageFile, String version)
Dodaje lokalny plik apk i powiązaną z nim wersję. Zauważ, że apki zostaną zwrócone z getAppPackageFiles()
w kolejności, w jakiej zostały dodane tą metodą.
Parametry | |
---|---|
appPackageFile | File |
version | String |
dodajBuildAttribute
public abstract void addBuildAttribute (String attributeName, String attributeValue)
Dodaj atrybut kompilacji. Nie pozwala to na zastąpienie istniejącej nazwy atrybutu.
Parametry | |
---|---|
attributeName | String : unikalna nazwa atrybutu |
attributeValue | String : wartość atrybutu |
dodaj atrybuty kompilacji
public void addBuildAttributes (buildAttributes)
Dodaj atrybuty kompilacji
Parametry | |
---|---|
buildAttributes |
posprzątać
public abstract void cleanUp ()
Wyczyść wszelkie tymczasowe pliki kompilacji
posprzątać
public abstract void cleanUp (doNotDelete)
Wersja cleanUp()
, w której niektóre pliki nie są usuwane.
Parametry | |
---|---|
doNotDelete |
getAppPackageFiles
publicgetAppPackageFiles ()
Pobiera kopię zestawu plików APK aplikacji lokalnej i ich wersji. Zwrócona kolejność odpowiada kolejności, w jakiej apki zostały dodane do IAppBuildInfo
.
Zwroty | |
---|---|
getBuildAttributes
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 została wyprodukowana testowana kompilacja.
Zwroty | |
---|---|
String | gałąź kompilacji lub null , jeśli nie jest ustawiona/nie dotyczy |
getBuildFlavour
public abstract String getBuildFlavor ()
Opcjonalna metoda zwracania typu testowanej kompilacji.
Typową implementacją kompilacji platformy Android jest zwracanie (kompilacja produktu)-(kompilacja systemu operacyjnego)-(wariant kompilacji). tj. generycznego-linux-userdebugZwroty | |
---|---|
String | smak kompilacji lub null , jeśli nieustawiono/nie dotyczy |
getBuildId
public abstract String getBuildId ()
Zwraca unikalny identyfikator testowanej kompilacji. Nigdy nie powinien być pusty. Domyślnie UNKNOWN_BUILD_ID
.
Zwroty | |
---|---|
String |
getBuildTargetName
public abstract String getBuildTargetName ()
Zwróć pełną nazwę testowanej kompilacji.
Typową implementacją jest skonstruowanie nazwy docelowej kompilacji z kombinacji smaku kompilacji i nazwy gałęzi. [tj. (nazwa gałęzi) - (smak kompilacji)]Zwroty | |
---|---|
String |
getDeviceSerial
public abstract String getDeviceSerial ()
Zwroty | |
---|---|
String | numer seryjny ITestDevice , na którym wykonano tę kompilację. Zwraca null , jeśli żadne urządzenie nie jest skojarzone z tą kompilacją. |
dostać plik
public abstract File getFile (String name)
Metoda pomocnicza do pobierania pliku o podanej nazwie.
Zwroty | |
---|---|
File | plik obrazu lub null , jeśli nie zostanie znaleziona |
dostać plik
public File getFile (BuildInfoKey.BuildInfoFileKey key)
Metoda pomocnika do pobierania pliku z podanym BuildInfoFileKey
.
Parametry | |
---|---|
key | BuildInfoKey.BuildInfoFileKey : wymagany BuildInfoFileKey . |
Zwroty | |
---|---|
File | plik obrazu lub null , jeśli nie zostanie znaleziona |
pobierz pliki
public abstractgetFiles ()
Zwraca wszystkie VersionedFile
s przechowywane w tym BuildInfo
.
Zwroty | |
---|---|
pobierzWłaściwości
public abstractgetProperties ()
Zwraca kopię właściwości aktualnie ustawionych w IBuildInfo
.
Zwroty | |
---|---|
pobierzPlikiZdalne
publicgetRemoteFiles ()
Pobierz ścieżki do 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 pomocnika do pobierania wersji pliku z podanym BuildInfoFileKey
.
Parametry | |
---|---|
key | BuildInfoKey.BuildInfoFileKey : Żądany BuildInfoFileKey . |
Zwroty | |
---|---|
String | wersja obrazu lub null , jeśli nie została znaleziona |
pobierz wersję
public abstract String getVersion (String name)
Metoda pomocnicza do pobierania wersji pliku o podanej nazwie.
Zwroty | |
---|---|
String | wersja obrazu lub null , jeśli nie została znaleziona |
getVersionedFile
public VersionedFile getVersionedFile (BuildInfoKey.BuildInfoFileKey key)
Metoda pomocnika do pobierania VersionedFile
z danym BuildInfoFileKey
.
Parametry | |
---|---|
key | BuildInfoKey.BuildInfoFileKey : Żądany BuildInfoFileKey . |
Zwroty | |
---|---|
VersionedFile | Wersjonowany plik lub null , jeśli nie został znaleziony |
getVersionedFile
public VersionedFile getVersionedFile (String name)
Metoda pomocnika 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 zapytania VersionedFile
przez getFile(BuildInfoFileKey)
.
Zwroty | |
---|---|
getVersionedFiles
publicgetVersionedFiles (BuildInfoKey.BuildInfoFileKey key)
Metoda pomocnika do pobierania listy VersionedFile
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ńBuildAttribute
public void removeBuildAttribute (String attributeName)
Usuń daną nazwę atrybutu ze śledzenia.
Parametry | |
---|---|
attributeName | String : atrybut zatrzymania śledzenia |
ustawBuildBranch
public abstract void setBuildBranch (String branch)
Ustaw gałąź kompilacji
Parametry | |
---|---|
branch | String : nazwa oddziału |
zestawBuildFlavour
public abstract void setBuildFlavor (String buildFlavor)
Ustaw smak kompilacji.
setBuildId
public abstract void setBuildId (String buildId)
Ustawia unikalny identyfikator testowanej kompilacji. Nigdy nie powinien być pusty.
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 ITestDevice , za pomocą którego wykonano tę kompilację. |
Ustaw plik
public abstract void setFile (String name, File file, String version)
Przechowuje plik o podanej nazwie w tej informacji o kompilacji.
Parametry | |
---|---|
name | String : unikalna nazwa pliku |
file | File : lokalny ERROR(/File) |
version | String : wersja pliku |
Ustaw plik
public void setFile (BuildInfoKey.BuildInfoFileKey key, File file, String version)
Przechowuje plik, któremu podano BuildInfoFileKey
w tych informacjach o kompilacji.
Parametry | |
---|---|
key | BuildInfoKey.BuildInfoFileKey : unikatowa 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. |
ustaw znacznik testowy
public abstract void setTestTag (String testTag)
Ustawia unikatową nazwę uruchamianych testów.
Parametry | |
---|---|
testTag | String |
StageRemotePlik
public File stageRemoteFile (String fileName, File workingDir)
Przygotuj plik będący częścią plików zdalnych w katalogu głównym informacji o kompilacji.
TODO(b/138416078): Usuń ten interfejs i jego program wywołujący, gdy moduły wymagane przez test mogą być poprawnie zbudowane i wysyłane do samego katalogu modułu testowego.
Parametry | |
---|---|
fileName | String : Nazwa pliku, który ma być umieszczony w plikach zdalnych. |
workingDir | File : obiekt ERROR(/File) katalogu 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 |