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(Map<String, String> buildAttributes)

Dodawanie atrybutów kompilacji

void allowStagingRemoteFile(boolean stageRemoteFile)

Ustawia uprawnienia, aby zezwolić na przygotowywanie zdalnych plików.

void cleanUp()

Zwalniaj miejsce, usuwając tymczasowe pliki kompilacji.

void cleanUp(List<File> doNotClean)

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

IBuildInfo clone()

final void copyAllFileFrom(BuildInfo build)

Skopiuj wszystkie VersionedFile z danej kompilacji do tej.

boolean equals(Object obj)

static IBuildInfo fromProto(BuildInformation.BuildInfo protoBuild)

Wykonaj operację odwrotną do toProto(), aby przywrócić instancję.

List<VersionedFile> getAppPackageFiles()

Pobiera kopię zestawu lokalnych plików APK aplikacji i ich wersji.

Map<String, String> getBuildAttributes()

Pobierz zestaw par nazwa-wartość dodatkowych atrybutów opisujących kompilację.

String getBuildBranch()

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

String getBuildFlavor()

Opcjonalna metoda zwracania typu testowanej kompilacji.

String getBuildId()

Zwraca unikalny identyfikator kompilacji poddanej testowi.

String getBuildTargetName()

Zwraca pełną nazwę testowanej kompilacji.

String getDeviceSerial()

File getFile(String name)

Metoda pomocnicza do pobierania pliku o podanej nazwie.

File getFile(BuildInfoKey.BuildInfoFileKey key)

Metoda pomocnicza do pobierania pliku z podanym parametrem BuildInfoFileKey.

Collection<VersionedFile> getFiles()

Zwraca wszystkie VersionedFile przechowywane w tym BuildInfo.

Set<IBuildInfo.BuildInfoProperties> getProperties()

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

Set<File> getRemoteFiles()

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

String getTestTag()

Zwraca niepowtarzalną nazwę uruchamianych testów.

String getVersion(BuildInfoKey.BuildInfoFileKey key)

Metoda pomocnicza do pobierania wersji pliku z podanym parametrem BuildInfoFileKey.

String getVersion(String name)

Metoda pomocnicza do pobierania wersji pliku o podanej nazwie.

VersionedFile getVersionedFile(BuildInfoKey.BuildInfoFileKey key)

Metoda pomocnicza do pobierania obiektu VersionedFile z danym obiektem BuildInfoFileKey.

final VersionedFile getVersionedFile(String name)

Metoda pomocnicza do pobierania elementu VersionedFile o podanej nazwie.

Set<String> getVersionedFileKeys()

Zwraca zestaw kluczy dostępnych do wysyłania zapytań VersionedFile za pomocą getFile(BuildInfoFileKey).

final List<VersionedFile> getVersionedFiles(BuildInfoKey.BuildInfoFileKey key)

Metoda pomocnicza do pobierania listy obiektów VersionedFile powiązanych z danym obiektem BuildInfoFileKey.

int hashCode()

void removeBuildAttribute(String attributeName)

Usuń z śledzenia dany atrybut attributeName.

void setBuildBranch(String branch)

Ustawianie gałęzi kompilacji

void setBuildFlavor(String buildFlavor)

Ustaw wersję kompilacji.

void setBuildId(String buildId)

Ustawia unikalny identyfikator kompilacji podlegającej testowaniu.

void setDeviceSerial(String serial)

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

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

Przechowuje plik podany w BuildInfoFileKey w informacjach o tej kompilacji.

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

Przechowuje plik o podanej nazwie w informacjach o kompilacji.

void setProperties(BuildInfoProperties... properties)

Ustaw wartość BuildInfoProperties dla instancji IBuildInfo.

void setTestTag(String testTag)

Ustawia unikalną nazwę przeprowadzanych testów.

File stageRemoteFile(String fileName, File workingDir)

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

BuildInformation.BuildInfo toProto()

Serializuj instancję BuildInfo do bufora protokołu.

String toString()

Metody chronione

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 kompilacji.

boolean applyBuildProperties(VersionedFile origFileConsidered, IBuildInfo build, IBuildInfo receiver)

Zezwól na zastosowanie niektórych IBuildInfo.BuildInfoProperties i ewentualnie zastosuj inne działanie.

MultiMap<String, String> getAttributesMultiMap()
Map<String, VersionedFile> 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 celu kompilacji

Metody publiczne

addAppPackageFile

public void addAppPackageFile (File appPackageFile, 
                String version)

Dodaje lokalny plik APK i powiązaną z nim wersję. Pamiętaj, że pliki APK będą zwracane z getAppPackageFiles() w kolejności, w jakiej zostały dodane tą metodą.

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: unikalna nazwa atrybutu.
attributeValue String: wartość atrybutu

addBuildAttributes

public void addBuildAttributes (Map<String, String> buildAttributes)

Dodawanie atrybutów kompilacji

Parametry
buildAttributes Map: mapa atrybutów do dodania

allowStagingRemoteFile

public void allowStagingRemoteFile (boolean stageRemoteFile)

Ustawia uprawnienia, aby zezwolić na przygotowywanie zdalnych plików.

Parametry
stageRemoteFile boolean

cleanUp

public void cleanUp ()

Zwalniaj miejsce, usuwając tymczasowe pliki kompilacji.

cleanUp

public void cleanUp (List<File> doNotClean)

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

Parametry
doNotClean List

klon

public IBuildInfo clone ()

Zwraca
IBuildInfo

copyAllFileFrom

public final void copyAllFileFrom (BuildInfo build)

Skopiuj wszystkie VersionedFile z danej kompilacji do tej.

Parametry
build BuildInfo

równa się

public boolean equals (Object obj)

Parametry
obj Object

Zwraca
boolean

fromProto

public static IBuildInfo fromProto (BuildInformation.BuildInfo protoBuild)

Wykonaj operację odwrotną do toProto(), aby przywrócić instancję.

Parametry
protoBuild BuildInformation.BuildInfo

Zwraca
IBuildInfo

getAppPackageFiles

public List<VersionedFile> getAppPackageFiles ()

Pobiera kopię zestawu lokalnych plików APK aplikacji i ich wersji. Zwrócona kolejność odpowiada kolejności, w jakiej pliki APK zostały dodane do IAppBuildInfo.

Zwraca
List<VersionedFile>

getBuildAttributes

public Map<String, String> getBuildAttributes ()

Pobierz zestaw par nazwa-wartość dodatkowych atrybutów opisujących kompilację.

Zwraca
Map<String, String> Map atrybutów kompilacji. Nie będzie to null, ale może być puste.

getBuildBranch

public String getBuildBranch ()

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

Zwraca
String gałąź kompilacji lub null, jeśli nie jest ustawiona lub nie ma zastosowania;

getBuildFlavor

public String getBuildFlavor ()

Opcjonalna metoda zwracania typu testowanej kompilacji.

W przypadku kompilacji na platformę Androida często zwracana jest wartość w formacie (produkt kompilacji)-(system operacyjny kompilacji)-(wariant kompilacji). ie generic-linux-userdebug

Zwraca
String wersja kompilacji lub null, jeśli nie jest ustawiona lub nie ma zastosowania.

getBuildId

public String getBuildId ()

Zwraca unikalny identyfikator kompilacji poddanej testowi. Nigdy nie powinien mieć wartości null. Domyślna wartość to UNKNOWN_BUILD_ID.

Zwraca
String

getBuildTargetName

public String getBuildTargetName ()

Zwraca pełną nazwę testowanej kompilacji.

Często stosuje się implementację, w której nazwa celu kompilacji jest tworzona na podstawie kombinacji wersji kompilacji i nazwy gałęzi. [np. (nazwa gałęzi)-(wersja kompilacji)]

Zwraca
String

getDeviceSerial

public String getDeviceSerial ()

Zwraca
String

getFile

public File getFile (String name)

Metoda pomocnicza do pobierania pliku o podanej nazwie.

Zwraca
File plik obrazu lub null, jeśli nie znaleziono pliku;

getFile

public File getFile (BuildInfoKey.BuildInfoFileKey key)

Metoda pomocnicza do pobierania pliku z podanym parametrem BuildInfoFileKey.

Parametry
key BuildInfoKey.BuildInfoFileKey: BuildInfoFileKey, o którego dostęp prosisz.
Zwraca
File plik obrazu lub null, jeśli nie znaleziono pliku;

getFiles

public Collection<VersionedFile> getFiles ()

Zwraca wszystkie VersionedFile przechowywane w tym BuildInfo.

Zwraca
Collection<VersionedFile>

getProperties

public Set<IBuildInfo.BuildInfoProperties> getProperties ()

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

Zwraca
Set<IBuildInfo.BuildInfoProperties>

getRemoteFiles

public Set<File> getRemoteFiles ()

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

Zwraca
Set<File>

getTestTag

public String getTestTag ()

Zwraca niepowtarzalną nazwę uruchamianych testów.

Zwraca
String

getVersion

public String getVersion (BuildInfoKey.BuildInfoFileKey key)

Metoda pomocnicza do pobierania wersji pliku z podanym parametrem BuildInfoFileKey.

Parametry
key BuildInfoKey.BuildInfoFileKey: żądany BuildInfoFileKey.
Zwraca
String wersję graficzną lub null, jeśli nie zostanie ona znaleziona.

getVersion

public String getVersion (String name)

Metoda pomocnicza do pobierania wersji pliku o podanej nazwie.

Zwraca
String wersję graficzną lub null, jeśli nie zostanie ona znaleziona.

getVersionedFile

public VersionedFile getVersionedFile (BuildInfoKey.BuildInfoFileKey key)

Metoda pomocnicza do pobierania obiektu VersionedFile z danym obiektem BuildInfoFileKey.

Parametry
key BuildInfoKey.BuildInfoFileKey: żądany BuildInfoFileKey.
Zwraca
VersionedFile Plik z wersją lub null, jeśli nie znaleziono pliku.

getVersionedFile

public final VersionedFile getVersionedFile (String name)

Metoda pomocnicza do pobierania elementu VersionedFile o podanej nazwie.

Zwraca
VersionedFile Plik z wersją lub null, jeśli nie znaleziono pliku.

getVersionedFileKeys

public Set<String> getVersionedFileKeys ()

Zwraca zestaw kluczy dostępnych do wysyłania zapytań VersionedFile za pomocą getFile(BuildInfoFileKey).

Zwraca
Set<String>

getVersionedFiles

public final List<VersionedFile> getVersionedFiles (BuildInfoKey.BuildInfoFileKey key)

Metoda pomocnicza do pobierania listy obiektów VersionedFile powiązanych z danym obiektem BuildInfoFileKey. Jeśli klucz umożliwia przechowywanie listy.

Parametry
key BuildInfoKey.BuildInfoFileKey: żądany BuildInfoFileKey.
Zwraca
List<VersionedFile> Plik z wersją lub null, jeśli nie znaleziono pliku.

hashCode

public int hashCode ()

Zwraca
int

removeBuildAttribute

public void removeBuildAttribute (String attributeName)

Usuń z śledzenia dany atrybut attributeName.

Parametry
attributeName String: atrybut, którego śledzenie ma zostać zatrzymane.

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 kompilacji podlegającej testowaniu. Nigdy nie powinien mieć wartości null.

Parametry
buildId String

setDeviceSerial

public void setDeviceSerial (String serial)

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

Parametry
serial String: numer seryjny ITestDevice, na którym wykonano tę kompilację.

setFile

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

Przechowuje plik podany w BuildInfoFileKey w informacjach o tej kompilacji.

Parametry
key BuildInfoKey.BuildInfoFileKey: unikalna nazwa pliku na podstawie BuildInfoFileKey.
file File: lokalny File
version String: wersja pliku;

setFile

public 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 File
version String: wersja pliku;

setProperties

public void setProperties (BuildInfoProperties... properties)

Ustaw wartość BuildInfoProperties dla instancji IBuildInfo. Zastąp wszystkie właściwości ustawione wcześniej.

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

setTestTag

public void setTestTag (String testTag)

Ustawia unikalną nazwę przeprowadzanych 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 wywołującego, gdy moduły wymagane przez test będzie można prawidłowo skompilować i wyeksportować do katalogu modułu testowego.

Parametry
fileName String: Nazwa pliku, który ma się znajdować w plikach zdalnych.
workingDir File: obiekt File katalogu, w którym ma zostać umieszczony plik.
Zwraca
File obiekt File pliku przygotowanego w lokalnym katalogu roboczym.

toProto

public BuildInformation.BuildInfo toProto ()

Serializuj instancję BuildInfo do bufora protokołu.

Zwraca
BuildInformation.BuildInfo

toString

public String toString ()

Zwraca
String

Metody chronione

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 kompilacji.

Tworzy nowe dowiązania twarde do plików, dzięki czemu każda kompilacja będzie miała unikalną ścieżkę do pliku.

Parametry
build BuildInfo

Zgłasza
IOException jeśli podczas tworzenia dowiązania twardego zostanie zgłoszony wyjątek.

applyBuildProperties

protected boolean applyBuildProperties (VersionedFile origFileConsidered, 
                IBuildInfo build, 
                IBuildInfo receiver)

Zezwól na zastosowanie niektórych IBuildInfo.BuildInfoProperties i ewentualnie zastosuj inne działanie.

Parametry
origFileConsidered VersionedFile: obecnie przeglądany VersionedFile.
build IBuildInfo: oryginalna kompilacja, która jest klonowana.
receiver IBuildInfo: kompilacja, która otrzymuje informacje.
Zwraca
boolean Wartość „prawda”, jeśli zastosowaliśmy właściwości i dalsze przetwarzanie powinno zostać pominięte. W przeciwnym razie ma wartość Fałsz.

getAttributesMultiMap

protected MultiMap<String, String> getAttributesMultiMap ()

Zwraca
MultiMap<String, String>

getVersionedFileMap

protected Map<String, VersionedFile> getVersionedFileMap ()

Zwraca
Map<String, VersionedFile>

getVersionedFileMapFull

protected MultiMap<String, VersionedFile> getVersionedFileMapFull ()

Zwraca
MultiMap<String, VersionedFile>