Informacje o budowie

public class BuildInfo
extends Object implements IBuildInfo

Obiekt Java.lang.Object
↳	com.android.tradefed.build.BuildInfo

Znane bezpośrednie podklasy AppBuildInfo , DeviceBuildInfo , FolderBuildInfo , OtatoolsBuildInfo Informacje o kompilacji aplikacji IBuildInfo reprezentujący aplikację dla systemu Android i jej pakiety testowe. Informacje o budowie urządzenia IBuildInfo reprezentujący kompletną kompilację urządzenia z systemem Android i (opcjonalnie) jej testy. Informacje o kompilacji folderu Konkretna implementacja IFolderBuildInfo . Informacje o kompilacji Otatools IBuildInfo zawierający artefakty otatools.

Znane podklasy pośrednie AppDeviceBuildInfo , ClusterBuildInfo , DeviceFolderBuildInfo , OtaDeviceBuildInfo Informacje o aplikacjiDeviceBuildInfo Ta klasa jest przestarzała. Użyj bezpośrednio IDeviceBuildInfo . Informacje o budowie klastra Klasa IBuildInfo dla kompilacji przesyłanych z TFC. Informacje o folderze urządzenia i kompilacji IDeviceBuildInfo , który zawiera również inne artefakty kompilacji zawarte w katalogu w lokalnym systemie plików. OtaDeviceBuildInfo IDeviceBuildInfo używany do testowania aktualizacji bezprzewodowej.

---

Ogólna implementacja IBuildInfo , która powinna być powiązana z ITestDevice .

Streszczenie

Konstruktorzy publiczni
BuildInfo () Tworzy BuildInfo przy użyciu domyślnych wartości atrybutów.
BuildInfo (String buildId, String buildTargetName) Tworzy BuildInfo

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	allowStagingRemoteFile (boolean stageRemoteFile) Ustawia uprawnienia umożliwiające przechowywanie zdalnych plików.
void	cleanUp () Wyczyść wszystkie tymczasowe pliki kompilacji
void	cleanUp ( doNotClean) cleanUp ( doNotClean) Wersja funkcji cleanUp() , w której niektóre pliki nie są usuwane.
IBuildInfo	clone ()
final void	copyAllFileFrom ( BuildInfo build) Skopiuj cały plik VersionedFile z danej kompilacji do tej.
boolean	equals (Object obj)
static IBuildInfo	fromProto (BuildInformation.BuildInfo protoBuild) Operacja odwrotna do toProto() aby odzyskać instancję.
	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 BuildInfoFileKey .
	getFiles () Zwraca wszystkie VersionedFile przechowywane w tym BuildInfo .
	getProperties () Zwraca kopię właściwości aktualnie ustawionych w IBuildInfo .
	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 BuildInfoFileKey .
String	getVersion (String name) Metoda pomocnicza do pobrania wersji pliku o podanej nazwie.
VersionedFile	getVersionedFile ( BuildInfoKey.BuildInfoFileKey key) Metoda pomocnicza do pobierania VersionedFile z danym BuildInfoFileKey .
final VersionedFile	getVersionedFile (String name) Metoda pomocnicza do pobierania VersionedFile o podanej nazwie.
	getVersionedFileKeys () Zwraca zestaw kluczy dostępnych do wysyłania zapytań do VersionedFile za pomocą getFile(BuildInfoFileKey) .
final	getVersionedFiles ( BuildInfoKey.BuildInfoFileKey key) Metoda pomocnicza do pobierania listy VersionedFile s skojarzonych z danym BuildInfoFileKey .
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 ITestDevice powiązany z tą kompilacją.
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 BuildInfoFileKey w tych informacjach o kompilacji.
void	setProperties ( BuildInfoProperties... properties) Ustaw BuildInfoProperties dla instancji IBuildInfo .
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 IBuildInfo.BuildInfoProperties i ewentualnie wykonaj inną obsługę.
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	: Mapa atrybutów do dodania

Zezwalaj na plik zdalnyStagingRemote

public void allowStagingRemoteFile (boolean stageRemoteFile)

Ustawia uprawnienia umożliwiające przechowywanie zdalnych plików.

Parametry
stageRemoteFile	boolean

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

klon

public IBuildInfo clone ()

Zwroty
IBuildInfo

skopiuj cały plik z

public final void copyAllFileFrom (BuildInfo build)

Skopiuj cały plik 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

public  getAppPackageFiles ()

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  getBuildAttributes ()

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-userdebug

Zwroty
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

public  getFiles ()

Zwraca wszystkie VersionedFile przechowywane w tym BuildInfo .

Zwroty

pobierz Właściwości

public  getProperties ()

Zwraca kopię właściwości aktualnie ustawionych w IBuildInfo .

Zwroty

pobierz pliki zdalne

public  getRemoteFiles ()

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

public  getVersionedFileKeys ()

Zwraca zestaw kluczy dostępnych do wysyłania zapytań do VersionedFile za pomocą getFile(BuildInfoFileKey) .

Zwroty

pobierz pliki wersji

public final  getVersionedFiles (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 urządzenia 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 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

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

protected  getVersionedFileMap ()

Zwroty

getVersionedFileMapFull

protected MultiMap<String, VersionedFile> getVersionedFileMapFull ()

Zwroty
MultiMap <String, VersionedFile >