IBuildInfo

public interface IBuildInfo

com.android.tradefed.build.IBuildInfo


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