Informacje o budowie
public class BuildInfo
extends Object
implements IBuildInfo
Obiekt Java.lang.Object | |
↳ | com.android.tradefed.build.BuildInfo |
Ogólna implementacja IBuildInfo
, która powinna być powiązana z ITestDevice
.
Streszczenie
Konstruktorzy publiczni | |
---|---|
BuildInfo () Tworzy | |
BuildInfo (String buildId, String buildTargetName) Tworzy |
Metody publiczne | |
---|---|
void | addAppPackageFile (File appPackageFile, String version) Dodaje lokalny plik apk i powiązaną z nim wersję. |
void | addBuildAttribute (String attributeName, String attributeValue) Dodaj atrybut kompilacji. |
void | addBuildAttributes ( buildAttributes) addBuildAttributes ( buildAttributes) Dodaj atrybuty kompilacji |
void | cleanUp () Wyczyść wszystkie tymczasowe pliki kompilacji |
void | cleanUp ( doNotClean) cleanUp ( doNotClean) Wersja funkcji |
IBuildInfo | clone () |
final void | copyAllFileFrom ( BuildInfo build) Skopiuj cały |
boolean | equals (Object obj) |
static IBuildInfo | fromProto (BuildInformation.BuildInfo protoBuild) Operacja odwrotna do |
getAppPackageFiles () Pobiera kopię zestawu plików apk aplikacji lokalnych i ich wersje. | |
getBuildAttributes () Uzyskaj zestaw par nazwa-wartość dodatkowych atrybutów opisujących kompilację. | |
String | getBuildBranch () Opcjonalna metoda zwracania gałęzi kontroli źródła, z której utworzono testowaną kompilację. |
String | getBuildFlavor () Opcjonalna metoda zwracania typu testowanej kompilacji. |
String | getBuildId () Zwraca unikalny identyfikator testowanej kompilacji. |
String | getBuildTargetName () Zwróć pełną nazwę testowanej kompilacji. |
String | getDeviceSerial () |
File | getFile (String name) Metoda pomocnicza do pobrania pliku o podanej nazwie. |
File | getFile ( BuildInfoKey.BuildInfoFileKey key) Metoda pomocnicza do pobrania pliku z danym |
getFiles () Zwraca wszystkie | |
getProperties () Zwraca kopię właściwości aktualnie ustawionych w | |
getRemoteFiles () Pobierz ścieżki dla artefaktów kompilacji, których pobieranie jest opóźnione. | |
String | getTestTag () Zwróć unikalną nazwę uruchamianych testów. |
String | getVersion ( BuildInfoKey.BuildInfoFileKey key) Metoda pomocnicza do pobierania wersji pliku z danym |
String | getVersion (String name) Metoda pomocnicza do pobrania wersji pliku o podanej nazwie. |
VersionedFile | getVersionedFile ( BuildInfoKey.BuildInfoFileKey key) Metoda pomocnicza do pobierania |
final VersionedFile | getVersionedFile (String name) Metoda pomocnicza do pobierania |
getVersionedFileKeys () Zwraca zestaw kluczy dostępnych do wysyłania zapytań | |
final | getVersionedFiles ( BuildInfoKey.BuildInfoFileKey key) Metoda pomocnicza do pobierania listy |
int | hashCode () |
void | removeBuildAttribute (String attributeName) Usuń daną nazwę atrybutu ze śledzenia. |
void | setBuildBranch (String branch) Ustaw gałąź kompilacji |
void | setBuildFlavor (String buildFlavor) Ustaw smak kompilacji. |
void | setBuildId (String buildId) Ustawia unikalny identyfikator testowanej kompilacji. |
void | setDeviceSerial (String serial) Ustaw numer seryjny |
void | setFile (String name, File file, String version) Przechowuje plik o podanej nazwie w informacjach o kompilacji. |
void | setFile ( BuildInfoKey.BuildInfoFileKey key, File file, String version) Przechowuje plik z danym |
void | setProperties ( BuildInfoProperties... properties) Ustaw |
void | setTestTag (String testTag) Ustawia unikalną nazwę uruchamianych testów. |
File | stageRemoteFile (String fileName, File workingDir) Przygotuj plik będący częścią plików zdalnych w katalogu głównym informacji o kompilacji. |
BuildInformation.BuildInfo | toProto () Serializuj instancję BuildInfo do protobuf. |
String | toString ()
|
Metody chronione | |
---|---|
void | addAllBuildAttributes ( BuildInfo build) Metoda pomocnicza do kopiowania atrybutów kompilacji, gałęzi i smaku z innej kompilacji. |
void | addAllFiles ( BuildInfo build) Metoda pomocnicza do kopiowania wszystkich plików z innej kompilacji. |
boolean | applyBuildProperties ( VersionedFile origFileConsidered, IBuildInfo build, IBuildInfo receiver) Zezwól na zastosowanie niektórych |
MultiMap <String, String> | getAttributesMultiMap () |
getVersionedFileMap () | |
MultiMap <String, VersionedFile > | getVersionedFileMapFull () |
Konstruktorzy publiczni
Informacje o budowie
public BuildInfo ()
Tworzy BuildInfo
przy użyciu domyślnych wartości atrybutów.
Informacje o budowie
public BuildInfo (String buildId, String buildTargetName)
Tworzy BuildInfo
Parametry | |
---|---|
buildId | String : identyfikator kompilacji |
buildTargetName | String : nazwa docelowa kompilacji |
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 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 |
posprzątać
public void cleanUp ()
Wyczyść wszystkie tymczasowe pliki kompilacji
posprzątać
public void cleanUp (doNotClean)
Wersja funkcji cleanUp()
, w której niektóre pliki nie są usuwane.
Parametry | |
---|---|
doNotClean |
skopiuj cały plik z
public final void copyAllFileFrom (BuildInfo build)
Skopiuj cały VersionedFile
z danej kompilacji do tej.
Parametry | |
---|---|
build | BuildInfo |
równa się
public boolean equals (Object obj)
Parametry | |
---|---|
obj | Object |
Zwroty | |
---|---|
boolean |
z Proto
public static IBuildInfo fromProto (BuildInformation.BuildInfo protoBuild)
Operacja odwrotna do toProto()
, aby odzyskać instancję.
Parametry | |
---|---|
protoBuild | BuildInformation.BuildInfo |
Zwroty | |
---|---|
IBuildInfo |
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
publicgetBuildAttributes ()
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 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 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 String getBuildId ()
Zwraca unikalny identyfikator testowanej kompilacji. Nigdy nie powinna mieć wartości null. Domyślnie UNKNOWN_BUILD_ID
.
Zwroty | |
---|---|
String |
getBuildTargetName
public 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 String getDeviceSerial ()
Zwroty | |
---|---|
String |
dostać plik
public 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
publicgetFiles ()
Zwraca wszystkie VersionedFile
przechowywane w tym BuildInfo
.
Zwroty | |
---|---|
pobierz Właściwości
publicgetProperties ()
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 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 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 final 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ń VersionedFile
za pomocą getFile(BuildInfoFileKey)
.
Zwroty | |
---|---|
pobierz pliki wersji
public finalgetVersionedFiles (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 |
hashCode
public int hashCode ()
Zwroty | |
---|---|
int |
usuń atrybut kompilacji
public void removeBuildAttribute (String attributeName)
Usuń daną nazwę atrybutu ze śledzenia.
Parametry | |
---|---|
attributeName | String : atrybut zatrzymujący śledzenie |
setBuildBranch
public void setBuildBranch (String branch)
Ustaw gałąź kompilacji
Parametry | |
---|---|
branch | String : nazwa oddziału |
setBuildFlavour
public void setBuildFlavor (String buildFlavor)
Ustaw smak kompilacji.
setBuildId
public 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 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ę. |
ustawPlik
public 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 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 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 moduł wywołujący, 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 |
doString
public String toString ()
Zwroty | |
---|---|
String |
Metody chronione
dodaj wszystkie atrybuty kompilacji
protected void addAllBuildAttributes (BuildInfo build)
Metoda pomocnicza do kopiowania atrybutów kompilacji, gałęzi i smaku z innej kompilacji.
Parametry | |
---|---|
build | BuildInfo |
dodajWszystkiepliki
protected void addAllFiles (BuildInfo build)
Metoda pomocnicza do kopiowania wszystkich plików z innej kompilacji.
Tworzy nowe twarde linki do plików, dzięki czemu każda kompilacja będzie miała unikalną ścieżkę do pliku.
Parametry | |
---|---|
build | BuildInfo |
Rzuca | |
---|---|
| jeśli podczas tworzenia twardego łącza zostanie zgłoszony wyjątek. |
ApplyBuildProperties
protected boolean applyBuildProperties (VersionedFile origFileConsidered, IBuildInfo build, IBuildInfo receiver)
Zezwól na zastosowanie niektórych IBuildInfo.BuildInfoProperties
i ewentualnie wykonaj inną obsługę.
Parametry | |
---|---|
origFileConsidered | VersionedFile : Aktualnie przeglądany VersionedFile . |
build | IBuildInfo : klonowana oryginalna kompilacja |
receiver | IBuildInfo : kompilacja odbierająca informacje. |
Zwroty | |
---|---|
boolean | To prawda, jeśli zastosowaliśmy właściwości i dalszą obsługę należy pominąć. Inaczej nieprawda. |
getAttributesMultiMap
protected MultiMap<String, String> getAttributesMultiMap ()
Zwroty | |
---|---|
MultiMap <String, String> |
getVersionedFileMap
protectedgetVersionedFileMap ()
Zwroty | |
---|---|
getVersionedFileMapFull
protected MultiMap<String, VersionedFile> getVersionedFileMapFull ()
Zwroty | |
---|---|
MultiMap <String, VersionedFile > |