Informacje o kompilacji

public class BuildInfo
extends Object implements IBuildInfo

java.lang.Obiekt
com.android.tradefed.build.BuildInfo


Ogólna implementacja IBuildInfo , która powinna być skojarzona z ITestDevice .

Streszczenie

Konstruktory publiczne

BuildInfo ()

Tworzy BuildInfo przy użyciu domyślnych wartości atrybutów.

BuildInfo (String buildId, String buildTargetName)

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

Dodaj atrybuty kompilacji

void cleanUp ()

Wyczyść wszelkie tymczasowe pliki kompilacji

void cleanUp ( doNotClean) cleanUp ( doNotClean)

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

IBuildInfo clone ()

final void copyAllFileFrom ( BuildInfo build)

Skopiuj cały VersionedFile z danej kompilacji do tej.

boolean equals (Object obj)

static IBuildInfo fromProto (BuildInformation.BuildInfo protoBuild)

Operacja odwrotna do toProto() w celu odzyskania instancji.

getAppPackageFiles ()

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

getBuildAttributes ()

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

String getBuildBranch ()

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

String getBuildFlavor ()

Opcjonalna metoda zwracania typu testowanej kompilacji.

String getBuildId ()

Zwraca unikalny identyfikator testowanej kompilacji.

String getBuildTargetName ()

Zwróć 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 pomocnika do pobierania pliku z podanym BuildInfoFileKey .

getFiles ()

Zwraca wszystkie VersionedFile s przechowywane w tym BuildInfo .

getProperties ()

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

getRemoteFiles ()

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

String getTestTag ()

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

String getVersion ( BuildInfoKey.BuildInfoFileKey key)

Metoda pomocnika do pobierania wersji pliku z podanym BuildInfoFileKey .

String getVersion (String name)

Metoda pomocnicza do pobierania wersji pliku o podanej nazwie.

VersionedFile getVersionedFile ( BuildInfoKey.BuildInfoFileKey key)

Metoda pomocnika do pobierania VersionedFile z danym BuildInfoFileKey .

final VersionedFile getVersionedFile (String name)

Metoda pomocnika do pobierania VersionedFile o podanej nazwie.

getVersionedFileKeys ()

Zwraca zestaw kluczy dostępnych do zapytania VersionedFile przez getFile(BuildInfoFileKey) .

final getVersionedFiles ( BuildInfoKey.BuildInfoFileKey key)

Metoda pomocnika do pobierania listy VersionedFile skojarzonych z danym BuildInfoFileKey .

int hashCode ()

void removeBuildAttribute (String attributeName)

Usuń daną nazwę atrybutu ze śledzenia.

void setBuildBranch (String branch)

Ustaw gałąź kompilacji

void setBuildFlavor (String buildFlavor)

Ustaw smak kompilacji.

void setBuildId (String buildId)

Ustawia unikalny identyfikator testowanej kompilacji.

void setDeviceSerial (String serial)

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

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

Przechowuje plik o podanej nazwie w tej informacji o kompilacji.

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

Przechowuje plik, któremu podano BuildInfoFileKey w tych informacjach o kompilacji.

void setProperties ( BuildInfoProperties... properties)

Ustaw BuildInfoProperties dla instancji IBuildInfo .

void setTestTag (String testTag)

Ustawia unikatową nazwę uruchamianych testów.

File stageRemoteFile (String fileName, File workingDir)

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

BuildInformation.BuildInfo toProto ()

Serializuj instancję BuildInfo do protobuf.

String toString ()

Metody chronione

void addAllBuildAttributes ( BuildInfo build)

Metoda pomocnika do kopiowania atrybutów kompilacji, gałęzi i smaku 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)

Zezwalaj na zastosowanie niektórych IBuildInfo.BuildInfoProperties i ewentualnie wykonaj inną obsługę.

MultiMap <String, String> getAttributesMultiMap ()
getVersionedFileMap ()
MultiMap <String, VersionedFile > getVersionedFileMapFull ()

Konstruktory publiczne

Informacje o kompilacji

public BuildInfo ()

Tworzy BuildInfo przy użyciu domyślnych wartości atrybutów.

Informacje o kompilacji

public BuildInfo (String buildId, 
                String buildTargetName)

Tworzy plik BuildInfo

Parametry
buildId String : identyfikator kompilacji

buildTargetName String : nazwa celu kompilacji

Metody publiczne

dodaj plik pakietu aplikacji

public void addAppPackageFile (File appPackageFile, 
                String version)

Dodaje lokalny plik apk i powiązaną z nim wersję. Zauważ, że apki zostaną zwrócone z getAppPackageFiles() w kolejności, w jakiej zostały dodane tą metodą.

Parametry
appPackageFile File

version String

dodajBuildAttribute

public void addBuildAttribute (String attributeName, 
                String attributeValue)

Dodaj atrybut kompilacji. Nie pozwala to na zastąpienie istniejącej nazwy atrybutu.

Parametry
attributeName String : unikalna nazwa atrybutu

attributeValue String : wartość atrybutu

dodaj atrybuty kompilacji

public void addBuildAttributes ( buildAttributes)

Dodaj atrybuty kompilacji

Parametry
buildAttributes : Mapa atrybutów do dodania

posprzątać

public void cleanUp ()

Wyczyść wszelkie tymczasowe pliki kompilacji

posprzątać

public void cleanUp ( doNotClean)

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

Parametry
doNotClean

klon

public IBuildInfo clone ()

Zwroty
IBuildInfo

skopiuj cały plik z

public final void copyAllFileFrom (BuildInfo build)

Skopiuj cały VersionedFile z danej kompilacji do tej.

Parametry
build BuildInfo

równa się

public boolean equals (Object obj)

Parametry
obj Object

Zwroty
boolean

z Proto

public static IBuildInfo fromProto (BuildInformation.BuildInfo protoBuild)

Operacja odwrotna do toProto() w celu odzyskania instancji.

Parametry
protoBuild BuildInformation.BuildInfo

Zwroty
IBuildInfo

getAppPackageFiles

public  getAppPackageFiles ()

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

Zwroty

getBuildAttributes

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

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

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

getBuildFlavour

public String getBuildFlavor ()

Opcjonalna metoda zwracania typu testowanej kompilacji.

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

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

getBuildId

public String getBuildId ()

Zwraca unikalny identyfikator testowanej kompilacji. Nigdy nie powinien być pusty. Domyślnie UNKNOWN_BUILD_ID .

Zwroty
String

getBuildTargetName

public String getBuildTargetName ()

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

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

Zwroty
String

getDeviceSerial

public String getDeviceSerial ()

Zwroty
String

dostać plik

public File getFile (String name)

Metoda pomocnicza do pobierania pliku o podanej nazwie.

Zwroty
File plik obrazu lub null , jeśli nie zostanie znaleziona

dostać plik

public File getFile (BuildInfoKey.BuildInfoFileKey key)

Metoda pomocnika do pobierania pliku z podanym BuildInfoFileKey .

Parametry
key BuildInfoKey.BuildInfoFileKey : wymagany BuildInfoFileKey .

Zwroty
File plik obrazu lub null , jeśli nie zostanie znaleziona

pobierz pliki

public  getFiles ()

Zwraca wszystkie VersionedFile s przechowywane w tym BuildInfo .

Zwroty

pobierzWłaściwości

public  getProperties ()

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

Zwroty

pobierzPlikiZdalne

public  getRemoteFiles ()

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

Zwroty

pobierzTestTag

public String getTestTag ()

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

Zwroty
String

pobierz wersję

public String getVersion (BuildInfoKey.BuildInfoFileKey key)

Metoda pomocnika do pobierania wersji pliku z podanym BuildInfoFileKey .

Parametry
key BuildInfoKey.BuildInfoFileKey : Żądany BuildInfoFileKey .

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

pobierz wersję

public String getVersion (String name)

Metoda pomocnicza do pobierania wersji pliku o podanej nazwie.

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

getVersionedFile

public VersionedFile getVersionedFile (BuildInfoKey.BuildInfoFileKey key)

Metoda pomocnika do pobierania VersionedFile z danym BuildInfoFileKey .

Parametry
key BuildInfoKey.BuildInfoFileKey : Żądany BuildInfoFileKey .

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

getVersionedFile

public final VersionedFile getVersionedFile (String name)

Metoda pomocnika 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 zapytania VersionedFile przez getFile(BuildInfoFileKey) .

Zwroty

getVersionedFiles

public final  getVersionedFiles (BuildInfoKey.BuildInfoFileKey key)

Metoda pomocnika do pobierania listy VersionedFile 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

HashCode

public int hashCode ()

Zwroty
int

usuńBuildAttribute

public void removeBuildAttribute (String attributeName)

Usuń daną nazwę atrybutu ze śledzenia.

Parametry
attributeName String : atrybut zatrzymania śledzenia

ustawBuildBranch

public void setBuildBranch (String branch)

Ustaw gałąź kompilacji

Parametry
branch String : nazwa oddziału

zestawBuildFlavour

public void setBuildFlavor (String buildFlavor)

Ustaw smak kompilacji.

setBuildId

public void setBuildId (String buildId)

Ustawia unikalny identyfikator testowanej kompilacji. Nigdy nie powinien być pusty.

Parametry
buildId String

ustaw numer seryjny urządzenia

public 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ę.

Ustaw plik

public 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

Ustaw plik

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 : unikatowa nazwa pliku oparta na BuildInfoFileKey .

file File : lokalny ERROR(/File)

version String : wersja pliku

ustawWłaściwości

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

ustaw znacznik testowy

public void setTestTag (String testTag)

Ustawia unikatową nazwę uruchamianych testów.

Parametry
testTag String

StageRemotePlik

public File stageRemoteFile (String fileName, 
                File workingDir)

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

TODO(b/138416078): Usuń ten interfejs i jego program wywołujący, gdy moduły wymagane przez test mogą być poprawnie zbudowane i wysyłane do samego katalogu modułu testowego.

Parametry
fileName String : Nazwa pliku, który ma być umieszczony w plikach zdalnych.

workingDir File : obiekt ERROR(/File) katalogu 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

do Ciągu

public String toString ()

Zwroty
String

Metody chronione

dodaj atrybuty AllBuild

protected void addAllBuildAttributes (BuildInfo build)

Metoda pomocnika do kopiowania atrybutów kompilacji, gałęzi i smaku z innej kompilacji.

Parametry
build BuildInfo

dodaj wszystkie pliki

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

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

ZastosujWłaściwościKompilacji

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

Zezwalaj na zastosowanie niektórych IBuildInfo.BuildInfoProperties i ewentualnie wykonaj inną obsługę.

Parametry
origFileConsidered VersionedFile : aktualnie przeglądany VersionedFile .

build IBuildInfo : oryginalna kompilacja jest klonowana

receiver IBuildInfo : kompilacja otrzymująca informacje.

Zwroty
boolean To prawda, gdybyśmy zastosowali właściwości i dalszą obsługę należy pominąć. Fałsz inaczej.

getAttributesMultiMap

protected MultiMap<String, String> getAttributesMultiMap ()

Zwroty
MultiMap <String, String>

getVersionedFileMap

protected  getVersionedFileMap ()

Zwroty

getVersionedFileMapFull

protected MultiMap<String, VersionedFile> getVersionedFileMapFull ()

Zwroty
MultiMap <String, VersionedFile >