BuildInfo

public class BuildInfo
extends Object implements IBuildInfo

java.lang.Object
↳	com.android.tradefed.build.BuildInfo

Znane bezpośrednie podklasy AppBuildInfo, DeviceBuildInfo, FolderBuildInfo, OtatoolsBuildInfo AppBuildInfo IBuildInfo, który reprezentuje aplikację na Androida i jej pakiety testowe.  DeviceBuildInfo IBuildInfo, który reprezentuje kompletną kompilację urządzenia z Androidem i (opcjonalnie) jej testy.  FolderBuildInfo konkretne wdrożenie IFolderBuildInfo.  OtatoolsBuildInfo Plik IBuildInfo zawierający artefakty otatools.

Znane podklasy pośrednie AppDeviceBuildInfo, ClusterBuildInfo, DeviceFolderBuildInfo, OtaDeviceBuildInfo AppDeviceBuildInfo Ta klasa została wycofana. Użyj bezpośrednio funkcji IDeviceBuildInfo.  ClusterBuildInfo Klasa IBuildInfo dla wersji przesyłanych z TFC.  DeviceFolderBuildInfo IDeviceBuildInfo, który zawiera też inne artefakty kompilacji zawarte w katalogu w lokalnym systemie plików.  OtaDeviceBuildInfo IDeviceBuildInfo używany do testowania aktualizacji OTA.

---

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

Podsumowanie

Konstruktory publiczne
BuildInfo() Tworzy BuildInfo, używając 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) Dodawanie atrybutów kompilacji
void	allowStagingRemoteFile(boolean stageRemoteFile) Ustawia uprawnienia, aby zezwolić na etapowanie plików zdalnych.
void	cleanUp() Usuń tymczasowe pliki kompilacji.
void	cleanUp( doNotClean) Wersja cleanUp(), w której niektóre pliki nie zostały usunięte.
IBuildInfo	clone()
final void	copyAllFileFrom(BuildInfo build) Skopiuj wszystkie VersionedFile z danej kompilacji do tej kompilacji.
boolean	equals(Object obj)
static IBuildInfo	fromProto(BuildInformation.BuildInfo protoBuild) Odwrotna operacja do toProto(), aby przywrócić instancję.
	getAppPackageFiles() Pobiera kopię zestawu lokalnych plików APK aplikacji i ich wersji.
	getBuildAttributes() Pobierz zestaw par nazwa-wartość dodatkowych atrybutów opisujących wersję.
String	getBuildBranch() Opcjonalna metoda zwracania gałęzi kontroli źródłowej, z której pochodzi testowana kompilacja.
String	getBuildFlavor() Opcjonalna metoda zwracania typu testowanej kompilacji.
String	getBuildId() Zwraca unikalny identyfikator wersji testowanej.
String	getBuildTargetName() Zwraca pełną nazwę testowanej wersji.
String	getDeviceSerial()
File	getFile(String name) Metoda pomocnicza do pobierania pliku o danej nazwie.
File	getFile(BuildInfoKey.BuildInfoFileKey key) Metoda pomocnicza do pobierania pliku o podanym identyfikatorze BuildInfoFileKey.
	getFiles() Zwraca wszystkie VersionedFile przechowywane w tym BuildInfo.
	getProperties() Zwraca kopię właściwości ustawionych w obiekcie IBuildInfo.
	getRemoteFiles() Pobierz ścieżki do artefaktów kompilacji, które są opóźnione w pobieraniu.
String	getTestTag() Zwraca niepowtarzalną nazwę testów, które są wykonywane.
String	getVersion(BuildInfoKey.BuildInfoFileKey key) Metoda pomocnicza do pobierania wersji pliku z danym BuildInfoFileKey.
String	getVersion(String name) Metoda pomocnicza do pobierania wersji pliku o określonej 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 danej nazwie.
	getVersionedFileKeys() Zwraca zestaw kluczy, których można używać do wysyłania zapytań do usługi VersionedFile za pomocą interfejsu getFile(BuildInfoFileKey).
final	getVersionedFiles(BuildInfoKey.BuildInfoFileKey key) Metoda pomocnicza do pobierania listy VersionedFile powiązanych z danym BuildInfoFileKey.
int	hashCode()
void	removeBuildAttribute(String attributeName) Usuń z śledzenia podany atrybut attributeName.
void	setBuildBranch(String branch) Ustawianie gałęzi kompilacji
void	setBuildFlavor(String buildFlavor) Ustaw wersję kompilacji.
void	setBuildId(String buildId) Ustawia unikalny identyfikator wersji testowanej.
void	setDeviceSerial(String serial) Ustaw numer seryjny ITestDevice powiązany z tą wersją.
void	setFile(String name, File file, String version) Przechowuje plik o określonej nazwie w informacjach o tej kompilacji.
void	setFile(BuildInfoKey.BuildInfoFileKey key, File file, String version) Przechowuje plik o wartości BuildInfoFileKey w informacjach o tej kompilacji.
void	setProperties(BuildInfoProperties... properties) Ustaw wartość BuildInfoProperties dla instancji IBuildInfo.
void	setTestTag(String testTag) Ustawia niepowtarzalną nazwę testów, które są wykonywane.
File	stageRemoteFile(String fileName, File workingDir) Prześlij plik, który jest częścią plików zdalnych, do katalogu głównego informacji o kompilacji.
BuildInformation.BuildInfo	toProto() Serializuj instancję BuildInfo do formatu protobuf.
String	toString()

Chronione metody
void	addAllBuildAttributes(BuildInfo build) Metoda pomocnicza do kopiowania atrybutów kompilacji, gałęzi i wersji z innej kompilacji.
void	addAllFiles(BuildInfo build) Metoda pomocnicza do kopiowania wszystkich plików z innej wersji.
boolean	applyBuildProperties(VersionedFile origFileConsidered, IBuildInfo build, IBuildInfo receiver) Zezwalanie na zastosowanie niektórych IBuildInfo.BuildInfoProperties i możliwe przeprowadzenie innej procedury.
MultiMap<String, String>	getAttributesMultiMap()
	getVersionedFileMap()
MultiMap<String, VersionedFile>	getVersionedFileMapFull()

Konstruktory publiczne

BuildInfo

public BuildInfo ()

Tworzy BuildInfo, używając domyślnych wartości atrybutów.

BuildInfo

public BuildInfo (String buildId, 
                String buildTargetName)

Tworzy BuildInfo

Parametry
buildId	String: identyfikator kompilacji
buildTargetName	String: nazwa docelowego pakietu kompilacji,

Metody publiczne

addAppPackageFile

public void addAppPackageFile (File appPackageFile, 
                String version)

Dodaje lokalny plik APK i powiązaną z nim wersję. Pamiętaj, że apki będą zwracane z poziomu getAppPackageFiles() w kolejności, w jakiej zostały dodane za pomocą tej metody.

Parametry
appPackageFile	File
version	String

addBuildAttribute

public void addBuildAttribute (String attributeName, 
                String attributeValue)

Dodaj atrybut kompilacji. Nie pozwala to zastąpić istniejącego atrybutu attributeName.

Parametry
attributeName	String: niepowtarzalną nazwę atrybutu,
attributeValue	String: wartość atrybutu

addBuildAttributes

public void addBuildAttributes ( buildAttributes)

Dodawanie atrybutów kompilacji

Parametry
buildAttributes	: mapowanie atrybutów do dodania

allowStagingRemoteFile

public void allowStagingRemoteFile (boolean stageRemoteFile)

Ustawia uprawnienia, aby zezwolić na etapowanie plików zdalnych.

Parametry
stageRemoteFile	boolean

cleanUp

public void cleanUp ()

Usuń tymczasowe pliki kompilacji.

cleanUp

public void cleanUp ( doNotClean)

Wersja cleanUp(), w której niektóre pliki nie zostały usunięte.

Parametry
doNotClean

klon

public IBuildInfo clone ()

Zwroty
IBuildInfo

copyAllFileFrom

public final void copyAllFileFrom (BuildInfo build)

Skopiuj wszystkie VersionedFile z danej kompilacji do tej kompilacji.

Parametry
build	BuildInfo

równa się

public boolean equals (Object obj)

Parametry
obj	Object

Zwroty
boolean

fromProto

public static IBuildInfo fromProto (BuildInformation.BuildInfo protoBuild)

Odwrotna operacja do toProto(), aby przywrócić instancję.

Parametry
protoBuild	BuildInformation.BuildInfo

Zwroty
IBuildInfo

getAppPackageFiles

public  getAppPackageFiles ()

Pobiera kopię zestawu lokalnych plików APK aplikacji i ich wersji. Zwrócona kolejność odpowiada kolejności dodawania plików APK do IAppBuildInfo.

Zwroty

getBuildAttributes

public  getBuildAttributes ()

Pobierz zestaw par nazwa-wartość dodatkowych atrybutów opisujących wersję.

Zwroty
	ERROR(/Map) atrybutów kompilacji. Nie może być null, ale może być puste.

getBuildBranch

public String getBuildBranch ()

Opcjonalna metoda zwracania gałęzi kontroli źródłowej, z której pochodzi testowana kompilacja.

Zwroty
String	gałąź kompilacji lub null, jeśli nie została skonfigurowana lub nie dotyczy

getBuildFlavor

public String getBuildFlavor ()

Opcjonalna metoda zwracania typu testowanej kompilacji.

Typowym rozwiązaniem w przypadku kompilacji na platformę Android jest zwracanie parametrów (produkt)-(system operacyjny)-(wariant kompilacji). ie generic-linux-userdebug

Zwroty
String	wersję kompilacji lub null, jeśli nie została ustawiona lub nie ma zastosowania;

getBuildId

public String getBuildId ()

Zwraca unikalny identyfikator wersji testowanej. Nigdy nie powinien być pusty. Domyślna wartość to UNKNOWN_BUILD_ID.

Zwroty
String

getBuildTargetName

public String getBuildTargetName ()

Zwraca pełną nazwę testowanej wersji.

Typowym rozwiązaniem jest tworzenie nazwy docelowej kompilacji przez połączenie wersji kompilacji i nazwy gałęzi. [np. (nazwa gałęzi)-(wersja kompilacji)]

Zwroty
String

getDeviceSerial

public String getDeviceSerial ()

Zwroty
String

getFile

public File getFile (String name)

Metoda pomocnicza do pobierania pliku o danej nazwie.

Zwroty
File	plik obrazu lub null, jeśli go nie znaleziono

getFile

public File getFile (BuildInfoKey.BuildInfoFileKey key)

Metoda pomocnicza do pobierania pliku o podanym identyfikatorze BuildInfoFileKey.

Parametry
key	BuildInfoKey.BuildInfoFileKey: BuildInfoFileKey, o który prosisz.

Zwroty
File	plik obrazu lub null, jeśli go nie znaleziono

getFiles

public  getFiles ()

Zwraca wszystkie VersionedFile przechowywane w tym BuildInfo.

Zwroty

getProperties

public  getProperties ()

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

Zwroty

getRemoteFiles

public  getRemoteFiles ()

Pobierz ścieżki do artefaktów kompilacji, które są opóźnione w pobieraniu.

Zwroty

getTestTag

public String getTestTag ()

Zwraca niepowtarzalną nazwę testów, które są wykonywane.

Zwroty
String

getVersion

public String getVersion (BuildInfoKey.BuildInfoFileKey key)

Metoda pomocnicza do pobierania wersji pliku z danym BuildInfoFileKey.

Parametry
key	BuildInfoKey.BuildInfoFileKey: BuildInfoFileKey żądane.

Zwroty
String	wersję obrazu lub null, jeśli nie można go znaleźć;

getVersion

public String getVersion (String name)

Metoda pomocnicza służąca do pobierania wersji pliku o określonej nazwie.

Zwroty
String	wersję obrazu lub null, jeśli nie można go znaleźć;

getVersionedFile

public VersionedFile getVersionedFile (BuildInfoKey.BuildInfoFileKey key)

Metoda pomocnicza do pobierania VersionedFile z danym BuildInfoFileKey.

Parametry
key	BuildInfoKey.BuildInfoFileKey: BuildInfoFileKey żądane.

Zwroty
VersionedFile	Plik z wersjami lub null, jeśli go nie znaleziono

getVersionedFile

public final VersionedFile getVersionedFile (String name)

Metoda pomocnicza do pobierania VersionedFile o danej nazwie.

Zwroty
VersionedFile	plik z wersjami lub null, jeśli go nie ma;

getVersionedFileKeys

public  getVersionedFileKeys ()

Zwraca zestaw kluczy, których można używać do wysyłania zapytań do usługi VersionedFile za pomocą interfejsu getFile(BuildInfoFileKey).

Zwroty

getVersionedFiles

public final  getVersionedFiles (BuildInfoKey.BuildInfoFileKey key)

Metoda pomocnicza do pobierania listy VersionedFile powiązanych z danym BuildInfoFileKey. czy klucz umożliwia przechowywanie listy.

Parametry
key	BuildInfoKey.BuildInfoFileKey: BuildInfoFileKey żądane.

Zwroty
	plik z wersjami lub null, jeśli go nie ma;

hashCode

public int hashCode ()

Zwroty
int

removeBuildAttribute

public void removeBuildAttribute (String attributeName)

Usuń z śledzenia podany atrybut attributeName.

Parametry
attributeName	String: atrybut, który ma przestać być śledzony

setBuildBranch

public void setBuildBranch (String branch)

Ustawianie gałęzi kompilacji

Parametry
branch	String: nazwa gałęzi;

setBuildFlavor

public void setBuildFlavor (String buildFlavor)

Ustaw wersję kompilacji.

setBuildId

public void setBuildId (String buildId)

Ustawia unikalny identyfikator wersji testowanej. Nigdy nie powinien być pusty.

Parametry
buildId	String

setDeviceSerial

public void setDeviceSerial (String serial)

Ustaw numer seryjny ITestDevice powiązany z tą wersją.

Parametry
serial	String: numer seryjny ITestDevice, z którym została wykonana ta kompilacja.

setFile

public void setFile (String name, 
                File file, 
                String version)

Przechowuje plik o podanej nazwie w informacjach o tej kompilacji.

Parametry
name	String: unikalna nazwa pliku.
file	File: lokalny ERROR(/File)
version	String: wersja pliku

setFile

public void setFile (BuildInfoKey.BuildInfoFileKey key, 
                File file, 
                String version)

Przechowuje plik o wartości BuildInfoFileKey w informacjach o tej kompilacji.

Parametry
key	BuildInfoKey.BuildInfoFileKey: unikalna nazwa pliku utworzona na podstawie parametru BuildInfoFileKey.
file	File: lokalny ERROR(/File)
version	String: wersja pliku

setProperties

public void setProperties (BuildInfoProperties... properties)

Ustaw wartość BuildInfoProperties dla instancji IBuildInfo. Zastąpić wszystkie wcześniej ustawione właściwości.

Parametry
properties	BuildInfoProperties: lista właściwości do dodania.

setTestTag

public void setTestTag (String testTag)

Ustawia niepowtarzalną nazwę testów, które są wykonywane.

Parametry
testTag	String

stageRemoteFile

public File stageRemoteFile (String fileName, 
                File workingDir)

Prześlij plik, który jest częścią plików zdalnych, do katalogu głównego informacji o kompilacji.

TODO(b/138416078): usuń ten interfejs i jego wywołanie, gdy moduły wymagane przez test mogą być poprawnie wygenerowane w samej lokalizacji modułu testowego.

Parametry
fileName	String: nazwa pliku, który ma znajdować się w plikach zdalnych.
workingDir	File: obiekt ERROR(/File) katalogu do umieszczenia pliku.

Zwroty
File	obiekt ERROR(/File) pliku przygotowanego w lokalnym katalogu roboczym.

toProto

public BuildInformation.BuildInfo toProto ()

Serializuj instancję BuildInfo do formatu protobuf.

Zwroty
BuildInformation.BuildInfo

toString

public String toString ()

Zwroty
String

Chronione metody

addAllBuildAttributes

protected void addAllBuildAttributes (BuildInfo build)

Metoda pomocnicza do kopiowania atrybutów kompilacji, gałęzi i wersji z innej kompilacji.

Parametry
build	BuildInfo

addAllFiles

protected void addAllFiles (BuildInfo build)

Metoda pomocnicza do kopiowania wszystkich plików z innej wersji.

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

Rzuty
	jeśli podczas tworzenia stałego łącza wystąpi wyjątek.

applyBuildProperties

protected boolean applyBuildProperties (VersionedFile origFileConsidered, 
                IBuildInfo build, 
                IBuildInfo receiver)

Zezwalanie na zastosowanie niektórych IBuildInfo.BuildInfoProperties i możliwe przeprowadzenie innej procedury.

Parametry
origFileConsidered	VersionedFile: obecnie wyświetlany VersionedFile.
build	IBuildInfo: oryginalna wersja, która jest klonowana
receiver	IBuildInfo: kompilacja otrzymująca informacje.

Zwroty
boolean	Wartość „prawda”, jeśli właściwości zostały zastosowane i dalsze przetwarzanie powinno zostać pominięte. W przeciwnym razie zwraca wartość Fałsz.

getAttributesMultiMap

protected MultiMap<String, String> getAttributesMultiMap ()

Zwroty
MultiMap<String, String>

getVersionedFileMap

protected  getVersionedFileMap ()

Zwroty

getVersionedFileMapFull

protected MultiMap<String, VersionedFile> getVersionedFileMapFull ()

Zwroty
MultiMap<String, VersionedFile>