W 2026 r., aby dostosować się do naszego modelu stabilnego rozwoju trunk i zapewnić stabilność platformy w ekosystemie, będziemy publikować kod źródłowy w AOSP w drugim i czwartym kwartale. Do tworzenia i współtworzenia AOSP używaj gałęzi android-latest-release. Gałąź manifestu android-latest-release będzie zawsze odwoływać się do najnowszej wersji przesłanej do AOSP. Więcej informacji znajdziesz w artykule Zmiany w AOSP.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

IBuildInfo

public interface IBuildInfo
implements Serializable

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. Korzystaj z `IDeviceBuildInfo` bezpośrednio.
BuildInfo	Ogólna implementacja `IBuildInfo`, która powinna być powiązana z `ITestDevice`.
ClusterBuildInfo	Klasa `IBuildInfo` do kompilacji przesyłanych potokowo 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 znajdujące się w katalogu w lokalnym systemie plików.
FolderBuildInfo	Konkretna implementacja `IFolderBuildInfo`.
IAppBuildInfo	Ten interfejs został wycofany. Korzystaj z `IBuildInfo` bezpośrednio.
IDeviceBuildInfo	`IBuildInfo`, który reprezentuje kompletną kompilację urządzenia z Androidem i (opcjonalnie) jej testy.
IFolderBuildInfo	Prosty abstrakcyjny `IBuildInfo`, którego artefakty kompilacji znajdują się w katalogu lokalnego systemu plików.
OtaDeviceBuildInfo	`IDeviceBuildInfo` używane do testowania aktualizacji bezprzewodowych.
OtatoolsBuildInfo	`IBuildInfo` zawierający artefakty otatools.

Zawiera informacje o kompilacji poddanej testom.

Podsumowanie

Stałe
`String`	`REMOTE_FILE_PREFIX` Prefiks używany w nazwie, aby wskazać, że plik ma być pobierany z opóźnieniem.
`String`	`REMOTE_FILE_VERSION` Plik zdalny nie ma wersji.
`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(Map<String, String> buildAttributes)` Dodawanie atrybutów kompilacji
`default void`	`allowStagingRemoteFile(boolean stageRemoteFile)` Ustawia uprawnienia, aby zezwolić na przygotowywanie zdalnych plików.
`abstract void`	`cleanUp()` Zwalniaj miejsce, usuwając tymczasowe pliki kompilacji.
`abstract void`	`cleanUp(List<File> doNotDelete)` Wersja `cleanUp()`, w której niektóre pliki nie są usuwane.
`abstract IBuildInfo`	`clone()` Klonuje obiekt `IBuildInfo`.
`default List<VersionedFile>`	`getAppPackageFiles()` Pobiera kopię zestawu lokalnych plików APK aplikacji i ich wersji.
`abstract Map<String, String>`	`getBuildAttributes()` Pobierz zestaw par nazwa-wartość dodatkowych atrybutów opisujących kompilację.
`abstract String`	`getBuildBranch()` Opcjonalna metoda zwracania gałęzi kontroli źródła, z której pochodzi testowana kompilacja.
`abstract String`	`getBuildFlavor()` Opcjonalna metoda zwracania typu testowanej kompilacji.
`abstract String`	`getBuildId()` Zwraca unikalny identyfikator kompilacji poddanej testowi.
`abstract String`	`getBuildTargetName()` Zwraca pełną nazwę testowanej kompilacji.
`abstract String`	`getDeviceSerial()`
`abstract File`	`getFile(String name)` Metoda pomocnicza do pobierania pliku o podanej nazwie.
`default File`	`getFile(BuildInfoKey.BuildInfoFileKey key)` Metoda pomocnicza do pobierania pliku z podanym parametrem `BuildInfoFileKey`.
`abstract Collection<VersionedFile>`	`getFiles()` Zwraca wszystkie `VersionedFile` przechowywane w tym `BuildInfo`.
`abstract Set<IBuildInfo.BuildInfoProperties>`	`getProperties()` Zwraca kopię właściwości aktualnie ustawionych w obiekcie `IBuildInfo`.
`default Set<File>`	`getRemoteFiles()` Pobieranie ścieżek do artefaktów kompilacji, które są pobierane z opóźnieniem.
`abstract String`	`getTestTag()` Zwraca niepowtarzalną nazwę uruchamianych testów.
`default String`	`getVersion(BuildInfoKey.BuildInfoFileKey key)` Metoda pomocnicza do pobierania wersji pliku z podanym parametrem `BuildInfoFileKey`.
`abstract String`	`getVersion(String name)` Metoda pomocnicza do pobierania wersji pliku o podanej nazwie.
`default VersionedFile`	`getVersionedFile(BuildInfoKey.BuildInfoFileKey key)` Metoda pomocnicza do pobierania obiektu `VersionedFile` z danym obiektem `BuildInfoFileKey`.
`default VersionedFile`	`getVersionedFile(String name)` Metoda pomocnicza do pobierania elementu `VersionedFile` o podanej nazwie.
`default Set<String>`	`getVersionedFileKeys()` Zwraca zestaw kluczy dostępnych do wysyłania zapytań `VersionedFile` za pomocą `getFile(BuildInfoFileKey)`.
`default List<VersionedFile>`	`getVersionedFiles(BuildInfoKey.BuildInfoFileKey key)` Metoda pomocnicza do pobierania listy obiektów `VersionedFile` powiązanych z danym obiektem `BuildInfoFileKey`.
`default void`	`removeBuildAttribute(String attributeName)` Usuń z śledzenia dany 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 kompilacji podlegającej testowaniu.
`abstract void`	`setDeviceSerial(String serial)` Ustaw `ITestDevice` numer seryjny powiązany z tą kompilacją.
`default void`	`setFile(BuildInfoKey.BuildInfoFileKey key, File file, String version)` Przechowuje plik podany w `BuildInfoFileKey` w informacjach o tej kompilacji.
`abstract void`	`setFile(String name, File file, String version)` Przechowuje plik o podanej nazwie w informacjach o kompilacji.
`abstract void`	`setProperties(BuildInfoProperties... properties)` Ustaw wartość `BuildInfoProperties` dla instancji `IBuildInfo`.
`abstract void`	`setTestTag(String testTag)` Ustawia unikalną nazwę przeprowadzanych testów.
`default File`	`stageRemoteFile(String fileName, File workingDir)` Przygotuj plik, który jest częścią plików zdalnych w katalogu głównym informacji o kompilacji.
`default BuildInformation.BuildInfo`	`toProto()` Serializuj instancję BuildInfo do bufora protokołu.

Stałe

REMOTE_FILE_PREFIX

public static final String REMOTE_FILE_PREFIX

Prefiks używany w nazwie, aby wskazać, ż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 ma wersji.

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 pliki APK będą zwracane z getAppPackageFiles() w kolejności, w jakiej zostały dodane tą metodą.

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

Zwalniaj miejsce, usuwając tymczasowe pliki kompilacji.

cleanUp

public abstract void cleanUp (List<File> doNotDelete)

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

Parametry
`doNotDelete`	`List`

klon

public abstract IBuildInfo clone ()

Klonuje obiekt IBuildInfo.

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

Zwraca
`String`	numer seryjny `ITestDevice`, na którym wykonano tę kompilację. Zwraca wartość `null`, jeśli z tą kompilacją nie jest powiązane żadne urządzenie.

getFile

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

Zwraca wszystkie VersionedFile przechowywane w tym BuildInfo.

Zwraca
`Collection<VersionedFile>`

getProperties

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

removeBuildAttribute

public void removeBuildAttribute (String attributeName)

Usuń z śledzenia dany atrybut attributeName.

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

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

Parametry
`buildId`	`String`

setDeviceSerial

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