BuildInfo

public class BuildInfo
extends Object implements IBuildInfo

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

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>