Informacje o kompilacji

public class BuildInfo
extends Object implements IBuildInfo

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

Ogólna implementacja elementu IBuildInfo, który powinien być powiązany dzięki ITestDevice.

Podsumowanie

Konstruktory publiczne

BuildInfo()

Tworzy BuildInfo z użyciem 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)

Dodaj atrybuty kompilacji

void allowStagingRemoteFile(boolean stageRemoteFile)

Określa uprawnienia zezwalające na przejściowe pliki zdalne.

void cleanUp()

Usuń wszelkie 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 wartości 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ę.

getAppPackageFiles()

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

getBuildAttributes()

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

String getBuildBranch()

Opcjonalna metoda zwracająca źródłową gałąź kontrolną, na której była testowana kompilacja z którego pochodzą.

String getBuildFlavor()

Metoda opcjonalna zwracająca typ testowanej kompilacji.

String getBuildId()

Zwraca unikalny identyfikator testowanej kompilacji.

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 określonym atrybutem BuildInfoFileKey.

getFiles()

Zwraca wszystkie VersionedFile przechowywane w BuildInfo.

getProperties()

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

getRemoteFiles()

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

String getTestTag()

Zwraca unikalną nazwę uruchamianych testów.

String getVersion(BuildInfoKey.BuildInfoFileKey key)

Metoda pomocnicza do pobierania wersji pliku z określonym atrybutem BuildInfoFileKey.

String getVersion(String name)

Metoda pomocnicza do pobierania wersji pliku o podanej nazwie.

VersionedFile getVersionedFile(BuildInfoKey.BuildInfoFileKey key)

Metoda pomocnicza do pobierania żądania VersionedFile z określonym BuildInfoFileKey.

final VersionedFile getVersionedFile(String name)

Metoda pomocnicza do pobierania obiektu VersionedFile o podanej nazwie.

getVersionedFileKeys()

Zwraca zbiór kluczy dostępnych do wykonania zapytania VersionedFile za pomocą getFile(BuildInfoFileKey).

final getVersionedFiles(BuildInfoKey.BuildInfoFileKey key)

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

int hashCode()

void removeBuildAttribute(String attributeName)

Usunąć atrybut „attributeName” ze śledzenia.

void setBuildBranch(String branch)

Ustaw gałąź kompilacji

void setBuildFlavor(String buildFlavor)

Ustaw rodzaj 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 tych informacjach o kompilacji.

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

Przechowuje plik z wskaźnikiem BuildInfoFileKey w tych informacjach o kompilacji.

void setProperties(BuildInfoProperties... properties)

Ustaw BuildInfoProperties dla instancji IBuildInfo.

void setTestTag(String testTag)

Ustawia unikalną nazwę uruchamianych 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()

Zserializuj instancję BuildInfo w protobufie.

String toString()

Metody chronione

void addAllBuildAttributes(BuildInfo build)

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

void addAllFiles(BuildInfo build)

Metoda pomocnicza do skopiowania wszystkich plików z innej kompilacji.

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

Zezwalaj na stosowanie niektórych z IBuildInfo.BuildInfoProperties i zająć się czymś innym.

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

Konstruktory publiczne

Informacje o kompilacji

public BuildInfo ()

Tworzy BuildInfo z użyciem domyślnych wartości atrybutów.

Informacje o kompilacji

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 pakiety APK będą zwracane z 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 można zastąpić istniejącej nazwy atrybutu.

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

allowStagingRemoteFile

public void allowStagingRemoteFile (boolean stageRemoteFile)

Określa uprawnienia zezwalające na przejściowe pliki zdalne.

Parametry
stageRemoteFile boolean

czyszczenie

public void cleanUp ()

Usuń wszelkie tymczasowe pliki kompilacji

czyszczenie

public void cleanUp ( doNotClean)

Wersja cleanUp(), w której niektóre pliki nie zostały usunięte.

Parametry
doNotClean

klonować

public IBuildInfo clone ()

Zwroty
IBuildInfo

kopiujWszystkiePlikZ

public final void copyAllFileFrom (BuildInfo build)

Skopiuj wszystkie wartości 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)

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

Parametry
protoBuild BuildInformation.BuildInfo

Zwroty
IBuildInfo

getAppPackageFiles

public  getAppPackageFiles ()

Pobiera kopię zestawu plików APK aplikacji lokalnych i ich wersji. Zwrócone zamówienie odpowiada kolejności dodania pakietów apk do IAppBuildInfo.

Zwroty

getBuildAttributes

public  getBuildAttributes ()

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

Zwroty
ERROR(/Map) atrybutów kompilacji. To nie jest pole null, ale może być puste.

getBuildBranch

public String getBuildBranch ()

Opcjonalna metoda zwracająca źródłową gałąź kontrolną, na której była testowana kompilacja z którego pochodzą.

Zwroty
String gałąź kompilacji lub null, jeśli jest nieskonfigurowana/nie ma zastosowania

PobierzKompilacjaFlavor

public String getBuildFlavor ()

Metoda opcjonalna zwracająca typ testowanej kompilacji.

W przypadku kompilacji platformy Android często stosowany jest zwrot (skompiluj produkt)-(kompiluj system operacyjny)-(utwórz wariant). ie general-linux-userdebug

Zwroty
String rodzaj kompilacji lub null, jeśli nie jest ustawiony lub nie ma zastosowania

getBuildId

public String getBuildId ()

Zwraca unikalny identyfikator testowanej kompilacji. Nigdy nie może mieć wartości null. Domyślna wartość to UNKNOWN_BUILD_ID.

Zwroty
String

getBuildTargetName

public String getBuildTargetName ()

Zwraca pełną nazwę testowanej kompilacji.

Typowym wdrożeniem jest utworzenie nazwy celu kompilacji na podstawie kombinacji rodzaj kompilacji i nazwę gałęzi. [np (nazwa oddziału)-(rodzaj kompilacji)]

Zwroty
String

getDeviceSerial

public String getDeviceSerial ()

Zwroty
String

getFile

public File getFile (String name)

Metoda pomocnicza do pobierania pliku o podanej nazwie.

Zwroty
File plik obrazu lub null, jeśli go nie znaleziono

getFile

public File getFile (BuildInfoKey.BuildInfoFileKey key)

Metoda pomocnicza do pobierania pliku z określonym atrybutem BuildInfoFileKey.

Parametry
key BuildInfoKey.BuildInfoFileKey: żądane BuildInfoFileKey.
Zwroty
File plik obrazu lub null, jeśli go nie znaleziono

getFiles,

public  getFiles ()

Zwraca wszystkie VersionedFile przechowywane w BuildInfo.

Zwroty

getWłaściwości

public  getProperties ()

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

Zwroty

getRemoteFiles

public  getRemoteFiles ()

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

Zwroty

getTestTag

public String getTestTag ()

Zwraca unikalną nazwę uruchamianych testów.

Zwroty
String

getVersion

public String getVersion (BuildInfoKey.BuildInfoFileKey key)

Metoda pomocnicza do pobierania wersji pliku z określonym atrybutem BuildInfoFileKey.

Parametry
key BuildInfoKey.BuildInfoFileKey: BuildInfoFileKey.
Zwroty
String wersja obrazu lub null, jeśli nie znaleziono

getVersion

public String getVersion (String name)

Metoda pomocnicza do pobierania wersji pliku o podanej nazwie.

Zwroty
String wersja obrazu lub null, jeśli nie znaleziono

Plik getVersioned

public VersionedFile getVersionedFile (BuildInfoKey.BuildInfoFileKey key)

Metoda pomocnicza do pobierania żądania VersionedFile z określonym BuildInfoFileKey.

Parametry
key BuildInfoKey.BuildInfoFileKey: BuildInfoFileKey.
Zwroty
VersionedFile Plik z włączoną obsługą wersji lub null, jeśli nie znaleziono

Plik getVersioned

public final VersionedFile getVersionedFile (String name)

Metoda pomocnicza do pobierania obiektu VersionedFile o podanej nazwie.

Zwroty
VersionedFile Plik z włączoną obsługą wersji lub null, jeśli nie znaleziono

Klucze getVersionedFileKeys

public  getVersionedFileKeys ()

Zwraca zbiór kluczy dostępnych do wykonania zapytania VersionedFile za pomocą getFile(BuildInfoFileKey).

Zwroty

getVersionedFiles,

public final  getVersionedFiles (BuildInfoKey.BuildInfoFileKey key)

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

Parametry
key BuildInfoKey.BuildInfoFileKey: BuildInfoFileKey.
Zwroty
Plik z włączoną obsługą wersji lub null, jeśli nie znaleziono

kod skrótu

public int hashCode ()

Zwroty
int

removeBuildAttribute

public void removeBuildAttribute (String attributeName)

Usunąć atrybut „attributeName” ze śledzenia.

Parametry
attributeName String: atrybut do zatrzymania śledzenia.

setBuildBranch

public void setBuildBranch (String branch)

Ustaw gałąź kompilacji

Parametry
branch String: nazwa oddziału.

ustawBuildFlavor

public void setBuildFlavor (String buildFlavor)

Ustaw rodzaj kompilacji.

Identyfikator setBuildId

public void setBuildId (String buildId)

Ustawia unikalny identyfikator testowanej kompilacji. Nigdy nie może mieć wartości null.

Parametry
buildId String

setDeviceSerial

public void setDeviceSerial (String serial)

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

Parametry
serial String: numer seryjny modelu ITestDevice, za pomocą którego została wykonana ta kompilacja.

plik set

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

Przechowuje plik o podanej nazwie w tych informacjach o kompilacji.

Parametry
name String: unikalna nazwa pliku,
file File: lokalny ERROR(/File)
version String: wersja pliku,

plik set

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

Przechowuje plik z wskaźnikiem BuildInfoFileKey w tych informacjach o kompilacji.

Parametry
key BuildInfoKey.BuildInfoFileKey: unikalna nazwa pliku na podstawie BuildInfoFileKey.
file File: lokalny ERROR(/File)
version String: wersja pliku,

setWłaściwości

public void setProperties (BuildInfoProperties... properties)

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

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

setTestTag

public void setTestTag (String testTag)

Ustawia unikalną nazwę uruchamianych testów.

Parametry
testTag String

etapieZdalnaplikat

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 element wywołujący, gdy moduły są wymagane przez test można prawidłowo umieścić dane wyjściowe w katalogu modułu testowego.

Parametry
fileName String: nazwa pliku, który ma znajdować się w plikach zdalnych.
workingDir File: obiekt ERROR(/File) katalogu służący do testowania pliku.
Zwroty
File Obiekt ERROR(/File) pliku przestawiony w lokalnym narzędziu WorkDir.

toProto

public BuildInformation.BuildInfo toProto ()

Zserializuj instancję BuildInfo w protobufie.

Zwroty
BuildInformation.BuildInfo

Ciąg

public String toString ()

Zwroty
String

Metody chronione

addAllBuildAttributes

protected void addAllBuildAttributes (BuildInfo build)

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

Parametry
build BuildInfo

addAllFiles

protected void addAllFiles (BuildInfo build)

Metoda pomocnicza do skopiowania wszystkich plików z innej kompilacji.

Tworzy nowe linki sztywne do plików, tak aby każda kompilacja miała unikalną ścieżkę do pliku .

Parametry
build BuildInfo

Rzuty
jeśli podczas tworzenia linku sztywnego zostanie zgłoszony wyjątek.

zastosuj właściwości kompilacji

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

Zezwalaj na stosowanie niektórych z IBuildInfo.BuildInfoProperties i zająć się czymś innym.

Parametry
origFileConsidered VersionedFile: obecnie szukany element: VersionedFile.
build IBuildInfo: klonowana jest pierwotna kompilacja.
receiver IBuildInfo: kompilacja, która odbiera informacje.
Zwroty
boolean Wartość prawda, jeśli zastosowano te właściwości i pominięto dalszą obsługę. Fałsz w przeciwnym razie.

getAttributesMultiMap

protected MultiMap<String, String> getAttributesMultiMap ()

Zwroty
MultiMap<String, String>

getVersionedFileMap,

protected  getVersionedFileMap ()

Zwroty

getVersionedFileMapFull (pełne mapy pliku)

protected MultiMap<String, VersionedFile> getVersionedFileMapFull ()

Zwroty
MultiMap<String, VersionedFile>