Od 27 marca 2025 r. zalecamy używanie android-latest-release zamiast aosp-main do kompilowania i wspołtworzenia AOSP. Więcej informacji znajdziesz w artykule o zmianach w AOSP.

Ta strona została przetłumaczona przez Cloud Translation API.

IBuildInfo

public interface IBuildInfo

com.android.tradefed.build.IBuildInfo

Znane podklasy pośrednie

AppBuildInfo, AppDeviceBuildInfo, BuildInfo, ClusterBuildInfo, DeviceBuildInfo, DeviceFolderBuildInfo, FolderBuildInfo, IAppBuildInfo, IDeviceBuildInfo, IFolderBuildInfo, OtaDeviceBuildInfo, OtatoolsBuildInfo

AppBuildInfo	`IBuildInfo`, który reprezentuje aplikację na Androida i jej pakiety testowe.
AppDeviceBuildInfo	Ta klasa została wycofana. Użyj bezpośrednio funkcji `IDeviceBuildInfo`.
BuildInfo	Ogólna implementacja `IBuildInfo`, która powinna być powiązana z `ITestDevice`.
ClusterBuildInfo	Klasa `IBuildInfo` dla wersji przesyłanych z TFC.
DeviceBuildInfo	`IBuildInfo`, który reprezentuje kompletną kompilację urządzenia z Androidem i (opcjonalnie) jej testy.
DeviceFolderBuildInfo	`IDeviceBuildInfo`, który zawiera też inne artefakty kompilacji zawarte w katalogu w lokalnym systemie plików.
FolderBuildInfo	konkretne wdrożenie `IFolderBuildInfo`.
IAppBuildInfo	Ten interfejs został wycofany. Użyj bezpośrednio funkcji `IBuildInfo`.
IDeviceBuildInfo	`IBuildInfo`, który reprezentuje kompletną kompilację urządzenia z Androidem i (opcjonalnie) jej testy.
IFolderBuildInfo	Prosty abstrakt `IBuildInfo`, którego artefakty kompilacji znajdują się w katalogu lokalnego systemu plików.
OtaDeviceBuildInfo	`IDeviceBuildInfo` używany do testowania aktualizacji OTA.
OtatoolsBuildInfo	Plik `IBuildInfo` zawierający artefakty otatools.

Zawiera informacje o testowanej wersji.

Podsumowanie

Stałe
`String`	`REMOTE_FILE_PREFIX` W nazwie pliku jest używany prefiks, który wskazuje, że plik ma być pobierany z opóźnieniem.
`String`	`REMOTE_FILE_VERSION` Plik zdalny nie jest wersjonowany.
`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)` Dodawanie atrybutów kompilacji
`default void`	`allowStagingRemoteFile(boolean stageRemoteFile)` Ustawia uprawnienia, aby zezwolić na etapowanie plików zdalnych.
`abstract void`	`cleanUp()` Usuń tymczasowe pliki kompilacji.
`abstract void`	`cleanUp( doNotDelete)` Wersja `cleanUp()`, w której niektóre pliki nie zostały usunięte.
`abstract IBuildInfo`	`clone()` Klonuje obiekt `IBuildInfo`.
`default`	`getAppPackageFiles()` Pobiera kopię zestawu lokalnych plików APK aplikacji i ich wersji.
`abstract`	`getBuildAttributes()` Pobierz zestaw par nazwa-wartość dodatkowych atrybutów opisujących wersję.
`abstract String`	`getBuildBranch()` Opcjonalna metoda zwracania gałęzi kontroli źródłowej, z której pochodzi testowana kompilacja.
`abstract String`	`getBuildFlavor()` Opcjonalna metoda zwracania typu testowanej kompilacji.
`abstract String`	`getBuildId()` Zwraca unikalny identyfikator wersji testowanej.
`abstract String`	`getBuildTargetName()` Zwraca pełną nazwę testowanej wersji.
`abstract String`	`getDeviceSerial()`
`abstract File`	`getFile(String name)` Metoda pomocnicza do pobierania pliku o danej nazwie.
`default File`	`getFile(BuildInfoKey.BuildInfoFileKey key)` Metoda pomocnicza do pobierania pliku o podanym identyfikatorze `BuildInfoFileKey`.
`abstract`	`getFiles()` Zwraca wszystkie `VersionedFile` przechowywane w tym `BuildInfo`.
`abstract`	`getProperties()` Zwraca kopię właściwości ustawionych w obiekcie `IBuildInfo`.
`default`	`getRemoteFiles()` Pobierz ścieżki do artefaktów kompilacji, które są opóźnione w pobieraniu.
`abstract String`	`getTestTag()` Zwraca niepowtarzalną nazwę testów, które są wykonywane.
`default String`	`getVersion(BuildInfoKey.BuildInfoFileKey key)` Metoda pomocnicza do pobierania wersji pliku z danym `BuildInfoFileKey`.
`abstract String`	`getVersion(String name)` Metoda pomocnicza do pobierania wersji pliku o określonej 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 danej nazwie.
`default`	`getVersionedFileKeys()` Zwraca zestaw kluczy, których można używać do wysyłania zapytań do usługi `VersionedFile` za pomocą interfejsu `getFile(BuildInfoFileKey)`.
`default`	`getVersionedFiles(BuildInfoKey.BuildInfoFileKey key)` Metoda pomocnicza do pobierania listy `VersionedFile` powiązanych z danym `BuildInfoFileKey`.
`default void`	`removeBuildAttribute(String attributeName)` Usuń z śledzenia podany atrybut attributeName.
`abstract void`	`setBuildBranch(String branch)` Ustawianie gałęzi kompilacji
`abstract void`	`setBuildFlavor(String buildFlavor)` Ustaw wersję kompilacji.
`abstract void`	`setBuildId(String buildId)` Ustawia unikalny identyfikator wersji testowanej.
`abstract void`	`setDeviceSerial(String serial)` Ustaw numer seryjny `ITestDevice` powiązany z tą wersją.
`abstract void`	`setFile(String name, File file, String version)` Przechowuje plik o podanej nazwie w informacjach o tej kompilacji.
`default void`	`setFile(BuildInfoKey.BuildInfoFileKey key, File file, String version)` Przechowuje plik o wartości `BuildInfoFileKey` w informacjach o tej kompilacji.
`abstract void`	`setProperties(BuildInfoProperties... properties)` Ustaw wartość `BuildInfoProperties` dla instancji `IBuildInfo`.
`abstract void`	`setTestTag(String testTag)` Ustawia niepowtarzalną nazwę testów, które są wykonywane.
`default File`	`stageRemoteFile(String fileName, File workingDir)` Prześlij plik, który jest częścią plików zdalnych, do katalogu głównego informacji o kompilacji.
`default BuildInformation.BuildInfo`	`toProto()` Serializuj instancję BuildInfo do formatu protobuf.

Stałe

REMOTE_FILE_PREFIX

public static final String REMOTE_FILE_PREFIX

W nazwie pliku jest używany prefiks, który wskazuje, że plik ma być pobierany z opóźnieniem.

Wartość stała: "remote_file:"

REMOTE_FILE_VERSION

public static final String REMOTE_FILE_VERSION

Plik zdalny nie jest wersjonowany.

Wartość stała: ""

UNKNOWN_BUILD_ID

public static final String UNKNOWN_BUILD_ID

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

Wartość stała: "-1"

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 abstract 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 abstract void cleanUp ()

Usuń tymczasowe pliki kompilacji.

cleanUp

public abstract void cleanUp ( doNotDelete)

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

Parametry
`doNotDelete`

klon

public abstract IBuildInfo clone ()

Klonuje obiekt IBuildInfo.

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

Zwraca unikalny identyfikator wersji testowanej. Nigdy nie powinien być pusty. Domyślna wartość to UNKNOWN_BUILD_ID.

Zwroty
`String`

getBuildTargetName

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

Zwroty
`String`	numer seryjny `ITestDevice`, na którym została uruchomiona ta kompilacja. Zwraca wartość `null`, jeśli z tą wersją nie jest powiązane żadne urządzenie.

getFile

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

Zwraca wszystkie VersionedFile przechowywane w tym BuildInfo.

Zwroty

getProperties

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

Metoda pomocnicza 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 ma;

getVersionedFile

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

removeBuildAttribute

public void removeBuildAttribute (String attributeName)

Usuń z śledzenia podany atrybut attributeName.

Parametry
`attributeName`	`String`: atrybut, który ma przestać być śledzony

setBuildBranch

public abstract void setBuildBranch (String branch)

Ustawianie gałęzi kompilacji

Parametry
`branch`	`String`: nazwa gałęzi;

setBuildFlavor

public abstract void setBuildFlavor (String buildFlavor)

Ustaw wersję kompilacji.

setBuildId

public abstract void setBuildId (String buildId)

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

Parametry
`buildId`	`String`

setDeviceSerial

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