Informacje o budowie

public interface IBuildInfo

com.android.tradefed.build.IBuildInfo


Przechowuje informacje o testowanej kompilacji.

Streszczenie

Stałe

String REMOTE_FILE_PREFIX

Przedrostek używany w nazwie wskazujący, że pobieranie pliku jest opóźnione.

String REMOTE_FILE_VERSION

Plik zdalny nie ma wersji.

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) addBuildAttributes ( buildAttributes)

Dodaj atrybuty kompilacji

abstract void cleanUp ()

Wyczyść wszystkie tymczasowe pliki kompilacji

abstract void cleanUp ( doNotDelete) cleanUp ( doNotDelete)

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

abstract IBuildInfo clone ()

Klonuje obiekt IBuildInfo .

default getAppPackageFiles ()

Pobiera kopię zestawu plików apk aplikacji lokalnych i ich wersje.

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 utworzono testowaną kompilację.

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 pobrania pliku z danym BuildInfoFileKey .

abstract getFiles ()

Zwraca wszystkie VersionedFile przechowywane w tym BuildInfo .

abstract getProperties ()

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

default getRemoteFiles ()

Pobierz ścieżki dla artefaktów kompilacji, których pobieranie jest opóźnione.

abstract String getTestTag ()

Zwróć unikalną nazwę uruchamianych testów.

default String getVersion ( BuildInfoKey.BuildInfoFileKey key)

Metoda pomocnicza do pobierania wersji pliku z danym BuildInfoFileKey .

abstract String getVersion (String name)

Metoda pomocnicza do pobrania wersji pliku o podanej 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 podanej nazwie.

default getVersionedFileKeys ()

Zwraca zestaw kluczy dostępnych do wysyłania zapytań VersionedFile za pomocą getFile(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 powiązany z tą kompilacją.

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

Przechowuje plik o podanej nazwie w informacjach o kompilacji.

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

Przechowuje plik z danym BuildInfoFileKey w tych informacjach o kompilacji.

abstract void setProperties ( BuildInfoProperties... properties)

Ustaw BuildInfoProperties dla instancji IBuildInfo .

abstract void setTestTag (String testTag)

Ustawia unikalną nazwę uruchamianych testów.

default File stageRemoteFile (String fileName, File workingDir)

Przygotuj plik będący częścią plików zdalnych w katalogu głównym informacji o kompilacji.

default BuildInformation.BuildInfo toProto ()

Serializuj instancję BuildInfo do protobuf.

Stałe

REMOTE_FILE_PREFIX

public static final String REMOTE_FILE_PREFIX

Przedrostek używany w nazwie wskazujący, że pobieranie pliku jest opóźnione.

Wartość stała: „zdalny_plik:”

REMOTE_FILE_VERSION

public static final String REMOTE_FILE_VERSION

Plik zdalny nie ma wersji.

Stała wartość: ""

NIEZNANY_BUILD_ID

public static final String UNKNOWN_BUILD_ID

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

Wartość stała: „-1”

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

posprzątać

public abstract void cleanUp ()

Wyczyść wszystkie tymczasowe pliki kompilacji

posprzątać

public abstract void cleanUp ( doNotDelete)

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

Parametry
doNotDelete

klon

public abstract IBuildInfo clone ()

Klonuje obiekt IBuildInfo .

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 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 utworzono testowaną kompilację.

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

pobierzBuildFlavor

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

Zwraca unikalny identyfikator testowanej kompilacji. Nigdy nie powinna mieć wartości null. 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 na podstawie kombinacji stylu kompilacji i nazwy gałęzi. [tj. (nazwa oddziału) - (budowa smaku)]

Zwroty
String

pobierz numer urządzenia

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 powiązane ż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 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 abstract  getFiles ()

Zwraca wszystkie VersionedFile przechowywane w tym BuildInfo .

Zwroty

pobierz Właściwości

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

Parametry
key BuildInfoKey.BuildInfoFileKey : Żądany BuildInfoFileKey .

Zwroty
String wersję obrazu lub null , jeśli nie została znaleziona

pobierz wersję

public abstract 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 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ń VersionedFile za pomocą getFile(BuildInfoFileKey) .

Zwroty

pobierz pliki wersji

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 : Żądany BuildInfoFileKey .

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

usuń atrybut kompilacji

public void removeBuildAttribute (String attributeName)

Usuń daną nazwę atrybutu ze śledzenia.

Parametry
attributeName String : atrybut zatrzymujący śledzenie

setBuildBranch

public abstract void setBuildBranch (String branch)

Ustaw gałąź kompilacji

Parametry
branch String : nazwa oddziału

setBuildFlavour

public abstract void setBuildFlavor (String buildFlavor)

Ustaw smak kompilacji.

setBuildId

public abstract 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 abstract void setDeviceSerial (String serial)

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

Parametry
serial String : numer seryjny ITestDevice , za pomocą którego wykonano tę kompilację.

ustawPlik

public abstract 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 abstract 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 abstract 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 moduł wywołujący, 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