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 Informacje o aplikacji IBuildInfo reprezentujący aplikację systemu Android i jej pakiety testowe. AppDeviceBuildInfo Ta klasa jest przestarzała. Użyj bezpośrednio IDeviceBuildInfo . Informacje o budowie Ogólna implementacja IBuildInfo , która powinna być skojarzona z ITestDevice . Informacje o budowie klastra Klasa IBuildInfo dla kompilacji przesyłanych potokowo z TFC. Informacje o budowie urządzenia IBuildInfo , który reprezentuje pełną kompilację urządzenia z systemem Android i (opcjonalnie) jego testy. DeviceFolderBuildInfo IDeviceBuildInfo , który zawiera również inne artefakty kompilacji zawarte w katalogu w lokalnym systemie plików. Informacje o folderze kompilacji Konkretna implementacja IFolderBuildInfo . IAppBuildInfo Ten interfejs jest przestarzały. Użyj IBuildInfo bezpośrednio. IDeviceBuildInfo IBuildInfo , który reprezentuje pełną kompilację urządzenia z systemem Android i (opcjonalnie) jego testy. IFolderBuildInfo Prosty abstrakcyjny IBuildInfo którego artefakty kompilacji zawierają w lokalnym katalogu systemu plików. OtaDeviceBuildInfo IDeviceBuildInfo używany do testowania aktualizacji bezprzewodowych. OtatoolsBuildInfo IBuildInfo , który zawiera artefakty otatools.

---

Przechowuje informacje o testowanej kompilacji.

Streszczenie

Klasy zagnieżdżone
enum	IBuildInfo.BuildInfoProperties Niektóre właściwości, które IBuildInfo mogą mieć, aby dostosować niektóre z nich.

Stałe
String	REMOTE_FILE_PREFIX Prefiks używany w nazwie wskazujący, że plik jest 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 jego skojarzoną 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 cleanUp() , w której niektóre pliki nie są usuwane.
abstract IBuildInfo	clone () IBuildInfo obiekt IBuildInfo.
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 utworzona 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 pobrania pliku o podanej nazwie.
default File	getFile ( BuildInfoKey.BuildInfoFileKey key) Metoda pomocnicza do pobierania pliku z podanym BuildInfoFileKey .
abstract	getFiles () Zwraca wszystkie pliki VersionedFile przechowywane w tym BuildInfo .
abstract	getProperties () Zwraca kopię właściwości aktualnie ustawionych w IBuildInfo .
default	getRemoteFiles () Pobierz ścieżki do artefaktów kompilacji, które są pobierane z opóźnieniem.
abstract String	getTestTag () Zwróć unikalną nazwę uruchamianych testów.
default String	getVersion ( BuildInfoKey.BuildInfoFileKey key) Metoda pomocnicza do pobierania wersji pliku z podanym BuildInfoFileKey .
abstract String	getVersion (String name) Metoda pomocnicza do pobrania wersji pliku o podanej nazwie.
default VersionedFile	getVersionedFile ( BuildInfoKey.BuildInfoFileKey key) Metoda pomocnika do pobierania VersionedFile z danym BuildInfoFileKey .
default VersionedFile	getVersionedFile (String name) Metoda pomocnicza do pobierania VersionedFile o podanej nazwie.
default	getVersionedFileKeys () Zwraca zestaw kluczy dostępnych do zapytania VersionedFile za pośrednictwem getFile(BuildInfoKey.BuildInfoFileKey) .
default	getVersionedFiles ( BuildInfoKey.BuildInfoFileKey key) Metoda pomocnicza do pobierania listy VersionedFile s skojarzonych z danym BuildInfoFileKey .
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 ITestDevice skojarzony z tą kompilacją.
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 BuildInfoFileKey w tych informacjach o kompilacji.
abstract void	setProperties ( BuildInfoProperties... properties) Ustaw BuildInfoProperties dla wystąpienia IBuildInfo .
abstract void	setTestTag (String testTag) Ustawia unikalną nazwę uruchamianych testów.
default File	stageRemoteFile (String fileName, File workingDir) Przygotuj plik, który jest częścią plików zdalnych w katalogu głównym informacji o kompilacji.
default BuildInformation.BuildInfo	toProto () Serializuj wystąpienie BuildInfo w protobuf.

Stałe

REMOTE_FILE_PREFIX

public static final String REMOTE_FILE_PREFIX

Prefiks używany w nazwie wskazujący, że plik jest pobierany z opóźnieniem.

Wartość stała: "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

addAppPackageFile

public void addAppPackageFile (File appPackageFile, 
                String version)

Dodaje lokalny plik APK i jego skojarzoną wersję. Zauważ, że apk zostaną zwrócone przez getAppPackageFiles() w kolejności, w jakiej zostały dodane przez tę metodę.

Parametry
appPackageFile	File
version	String

addBuildAttribute

public abstract void addBuildAttribute (String attributeName, 
                String attributeValue)

Dodaj atrybut kompilacji. To nie pozwala na zastąpienie istniejącego atrybutu.

Parametry
attributeName	String : unikalna nazwa atrybutu
attributeValue	String : wartość atrybutu

addBuildAtrybuty

public void addBuildAttributes ( buildAttributes)

Dodaj atrybuty kompilacji

Parametry
buildAttributes	: Mapa atrybutów do dodania

sprzątać

public abstract void cleanUp ()

Wyczyść wszelkie tymczasowe pliki kompilacji

sprzątać

public abstract void cleanUp ( doNotDelete)

Wersja cleanUp() , w której niektóre pliki nie są usuwane.

Parametry
doNotDelete

klon

public abstract IBuildInfo clone ()

IBuildInfo obiekt IBuildInfo.

Zwroty
IBuildInfo

getAppPackageFiles

public  getAppPackageFiles ()

Pobiera kopię zestawu plików apk aplikacji lokalnej i ich wersji. Zwrócona kolejność jest zgodna z kolejnością, w jakiej apki zostały dodane do IAppBuildInfo .

Zwroty

getBuildAttributes

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

Opcjonalna metoda zwracania gałęzi kontroli źródła, z której została utworzona testowana kompilacja.

Zwroty
String	gałąź kompilacji lub null , jeśli nieustawiona/nie dotyczy

getBuildFlavour

public abstract String getBuildFlavor ()

Opcjonalna metoda zwracania typu testowanej kompilacji.

Typową implementacją dla kompilacji platformy Android jest zwracanie (kompilacja produktu)-(kompilacja systemu operacyjnego)-(wariant kompilacji). tj. generic-linux-userdebug

Zwroty
String	smak kompilacji lub null , jeśli nie jest ustawiony/nie dotyczy

getBuildId

public abstract String getBuildId ()

Zwraca unikalny identyfikator testowanej kompilacji. Nigdy nie powinno być zerowe. Domyślnie UNKNOWN_BUILD_ID .

Zwroty
String

getBuildTargetName

public abstract String getBuildTargetName ()

Zwróć pełną nazwę testowanej kompilacji.

Typową implementacją jest konstruowanie nazwy docelowej kompilacji z kombinacji smaku kompilacji i nazwy gałęzi. [tj. (nazwa oddziału)-(smak budowy)]

Zwroty
String

getDeviceSerial

public abstract String getDeviceSerial ()

Zwroty
String	numer seryjny ITestDevice , na którym została wykonana ta kompilacja. Zwraca null , jeśli z tą kompilacją nie jest skojarzone żadne urządzenie.

dostać plik

public abstract File getFile (String name)

Metoda pomocnicza do pobrania pliku o podanej nazwie.

Zwroty
File	plik obrazu lub null , jeśli nie został znaleziony

dostać plik

public File getFile (BuildInfoKey.BuildInfoFileKey key)

Metoda pomocnicza do pobierania pliku z podanym BuildInfoFileKey .

Parametry
key	BuildInfoKey.BuildInfoFileKey : BuildInfoFileKey .

Zwroty
File	plik obrazu lub null , jeśli nie został znaleziony

pobierzPliki

public abstract  getFiles ()

Zwraca wszystkie pliki VersionedFile przechowywane w tym BuildInfo .

Zwroty

getProperties

public abstract  getProperties ()

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

Zwroty

pobierzRemoteFiles

public  getRemoteFiles ()

Pobierz ścieżki do artefaktów kompilacji, które są pobierane z opóźnieniem.

Zwroty

pobierzTestTag

public abstract 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 podanym BuildInfoFileKey .

Parametry
key	BuildInfoKey.BuildInfoFileKey : zażądano BuildInfoFileKey .

Zwroty
String	wersja obrazu lub null , jeśli nie znaleziono

pobierz wersję

public abstract String getVersion (String name)

Metoda pomocnicza do pobrania wersji pliku o podanej nazwie.

Zwroty
String	wersja obrazu lub null , jeśli nie znaleziono

getVersionedFile

public VersionedFile getVersionedFile (BuildInfoKey.BuildInfoFileKey key)

Metoda pomocnika do pobierania VersionedFile z danym BuildInfoFileKey .

Parametry
key	BuildInfoKey.BuildInfoFileKey : zażądano BuildInfoFileKey .

Zwroty
VersionedFile	Plik wersjonowany lub null , jeśli nie został znaleziony

getVersionedFile

public VersionedFile getVersionedFile (String name)

Metoda pomocnicza do pobierania VersionedFile o podanej nazwie.

Zwroty
VersionedFile	Plik wersjonowany lub null , jeśli nie został znaleziony

getVersionedFileKeys

public  getVersionedFileKeys ()

Zwraca zestaw kluczy dostępnych do zapytania VersionedFile za pośrednictwem getFile(BuildInfoKey.BuildInfoFileKey) .

Zwroty

getVersionedFiles

public  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 : zażądano BuildInfoFileKey .

Zwroty
	Plik wersjonowany lub null , jeśli nie został znaleziony

removeBuildAttribute

public void removeBuildAttribute (String attributeName)

Usuń daną nazwę atrybutu ze śledzenia.

Parametry
attributeName	String : atrybut do zatrzymania śledzenia

setBuildBanch

public abstract void setBuildBranch (String branch)

Ustaw gałąź kompilacji

Parametry
branch	String : nazwa oddziału

setBuildFlavor

public abstract void setBuildFlavor (String buildFlavor)

Ustaw smak kompilacji.

setIdBudowy

public abstract void setBuildId (String buildId)

Ustawia unikalny identyfikator testowanej kompilacji. Nigdy nie powinno być zerowe.

Parametry
buildId	String

setDeviceSerial

public abstract void setDeviceSerial (String serial)

Ustaw numer seryjny ITestDevice skojarzony z tą kompilacją.

Parametry
serial	String : numer seryjny urządzenia ITestDevice , z którym wykonano tę kompilację.

setFile

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

setFile

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 : unikalna nazwa pliku oparta na BuildInfoFileKey .
file	File : lokalny ERROR(/File)
version	String : wersja pliku

setProperties

public abstract void setProperties (BuildInfoProperties... properties)

Ustaw BuildInfoProperties dla wystąpienia IBuildInfo . Zastąp wszystkie istniejące właściwości ustawione wcześniej.

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

setTestTag

public abstract void setTestTag (String testTag)

Ustawia unikalną nazwę uruchamianych testów.

Parametry
testTag	String

stageRemoteFile

public File stageRemoteFile (String fileName, 
                File workingDir)

Przygotuj plik, który jest częścią plików zdalnych w katalogu głównym informacji o kompilacji.

TODO(b/138416078): Usuń ten interfejs i jego obiekt wywołujący, gdy moduły wymagane przez test mogą być poprawnie skompilowane dane wyjściowe do samego katalogu modułu testowego.

Parametry
fileName	String : Nazwa pliku, który ma znajdować się w plikach zdalnych.
workingDir	File : obiekt ERROR(/File) katalogu, w którym znajduje się plik.

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

do Proto

public BuildInformation.BuildInfo toProto ()

Serializuj wystąpienie BuildInfo w protobuf.

Zwroty
BuildInformation.BuildInfo