IBuildInfo

public interface IBuildInfo

com.android.tradefed.build.IBuildInfo

Znane podklasy pośrednie AppBuildInfo, AppDeviceBuildInfo, BuildInfo, ClusterBuildInfo, DeviceBuildInfo, DeviceFolderBuildInfo, FolderBuildInfo, IAppBuildInfo, IDeviceBuildInfo, IFolderBuildInfo, OtaDeviceBuildInfo, OtatoolsBuildInfo AppBuildInfo IBuildInfo, który reprezentuje aplikację na Androida i jej pakiety testowe.  AppDeviceBuildInfo Ta klasa została wycofana. Użyj bezpośrednio funkcji IDeviceBuildInfo.  BuildInfo Ogólna implementacja IBuildInfo, która powinna być powiązana z ITestDevice.  ClusterBuildInfo Klasa IBuildInfo dla wersji przesyłanych z TFC.  DeviceBuildInfo IBuildInfo, który reprezentuje kompletną kompilację urządzenia z Androidem i (opcjonalnie) jej testy.  DeviceFolderBuildInfo IDeviceBuildInfo, który zawiera też inne artefakty kompilacji zawarte w katalogu w lokalnym systemie plików.  FolderBuildInfo konkretne wdrożenie IFolderBuildInfo.  IAppBuildInfo Ten interfejs został wycofany. Użyj bezpośrednio funkcji IBuildInfo.  IDeviceBuildInfo IBuildInfo, który reprezentuje kompletną kompilację urządzenia z Androidem i (opcjonalnie) jej testy.  IFolderBuildInfo Prosty abstrakt IBuildInfo, którego artefakty kompilacji znajdują się w katalogu lokalnego systemu plików.  OtaDeviceBuildInfo IDeviceBuildInfo używany do testowania aktualizacji OTA.  OtatoolsBuildInfo Plik IBuildInfo zawierający artefakty otatools.

---

Zawiera informacje o testowanej wersji.

Podsumowanie

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

Stałe

REMOTE_FILE_PREFIX

public static final String REMOTE_FILE_PREFIX

W nazwie pliku jest używany prefiks, który wskazuje, że plik ma być pobierany z opóźnieniem.

Wartość stała: "remote_file:"

REMOTE_FILE_VERSION

public static final String REMOTE_FILE_VERSION

Plik zdalny nie jest wersjonowany.

Wartość stała: ""

UNKNOWN_BUILD_ID

public static final String UNKNOWN_BUILD_ID

Wartość domyślna, gdy identyfikator kompilacji jest nieznany.

Wartość stała: "-1"

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 abstract 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 abstract void cleanUp ()

Usuń tymczasowe pliki kompilacji.

cleanUp

public abstract void cleanUp ( doNotDelete)

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

Parametry
doNotDelete

klon

public abstract IBuildInfo clone ()

Klonuje obiekt IBuildInfo.

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 abstract  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 abstract 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 abstract 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 abstract String getBuildId ()

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

Zwroty
String

getBuildTargetName

public abstract 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 abstract String getDeviceSerial ()

Zwroty
String	numer seryjny ITestDevice, na którym została uruchomiona ta kompilacja. Zwraca wartość null , jeśli z tą wersją nie jest powiązane żadne urządzenie.

getFile

public abstract 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 abstract  getFiles ()

Zwraca wszystkie VersionedFile przechowywane w tym BuildInfo.

Zwroty

getProperties

public abstract  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 abstract 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 abstract String getVersion (String name)

Metoda pomocnicza 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 ma;

getVersionedFile

public 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  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;

removeBuildAttribute

public void removeBuildAttribute (String attributeName)

Usuń z śledzenia podany atrybut attributeName.

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

setBuildBranch

public abstract void setBuildBranch (String branch)

Ustawianie gałęzi kompilacji

Parametry
branch	String: nazwa gałęzi;

setBuildFlavor

public abstract void setBuildFlavor (String buildFlavor)

Ustaw wersję kompilacji.

setBuildId

public abstract void setBuildId (String buildId)

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

Parametry
buildId	String

setDeviceSerial

public abstract 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 abstract 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 abstract 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 abstract 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