Mulai 27 Maret 2025, sebaiknya gunakan android-latest-release, bukan aosp-main, untuk mem-build dan berkontribusi pada AOSP. Untuk mengetahui informasi selengkapnya, lihat Perubahan pada AOSP.

Halaman ini diterjemahkan oleh Cloud Translation API.

BuildInfo

public class BuildInfo
extends Object implements IBuildInfo

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

Subclass langsung yang dikenal

AppBuildInfo, DeviceBuildInfo, FolderBuildInfo, OtatoolsBuildInfo

AppBuildInfo	`IBuildInfo` yang mewakili aplikasi Android dan paket pengujiannya.
DeviceBuildInfo	`IBuildInfo` yang mewakili build perangkat Android lengkap dan (opsional) pengujiannya.
FolderBuildInfo	Implementasi konkret `IFolderBuildInfo`.
OtatoolsBuildInfo	`IBuildInfo` yang berisi artefak otatools.

Subclass tidak langsung yang umum

AppDeviceBuildInfo, ClusterBuildInfo, DeviceFolderBuildInfo, OtaDeviceBuildInfo

AppDeviceBuildInfo	Class ini tidak digunakan lagi. Gunakan `IDeviceBuildInfo` secara langsung.
ClusterBuildInfo	Class `IBuildInfo` untuk build yang disalurkan dari TFC.
DeviceFolderBuildInfo	`IDeviceBuildInfo` yang juga berisi artefak build lain yang terdapat dalam direktori di sistem file lokal.
OtaDeviceBuildInfo	`IDeviceBuildInfo` yang digunakan untuk pengujian update over-the-air.

Implementasi umum IBuildInfo yang harus dikaitkan dengan ITestDevice.

Ringkasan

Konstruktor publik
`BuildInfo()` Membuat `BuildInfo` menggunakan nilai atribut default.
`BuildInfo(String buildId, String buildTargetName)` Membuat `BuildInfo`

Metode publik
`void`	`addAppPackageFile(File appPackageFile, String version)` Menambahkan file apk lokal dan versi terkaitnya.
`void`	`addBuildAttribute(String attributeName, String attributeValue)` Tambahkan atribut build.
`void`	`addBuildAttributes( buildAttributes)` Menambahkan atribut build
`void`	`allowStagingRemoteFile(boolean stageRemoteFile)` Menetapkan izin untuk mengizinkan staging file jarak jauh.
`void`	`cleanUp()` Membersihkan file build sementara
`void`	`cleanUp( doNotClean)` Versi `cleanUp()` yang beberapa file-nya tidak dihapus.
`IBuildInfo`	`clone()`
`final void`	`copyAllFileFrom(BuildInfo build)` Salin semua `VersionedFile` dari build tertentu ke build ini.
`boolean`	`equals(Object obj)`
`static IBuildInfo`	`fromProto(BuildInformation.BuildInfo protoBuild)` Operasi invers ke `toProto()` untuk mendapatkan kembali instance.
	`getAppPackageFiles()` Mendapatkan salinan kumpulan file apk aplikasi lokal dan versinya.
	`getBuildAttributes()` Mendapatkan kumpulan pasangan nama-nilai atribut tambahan yang mendeskripsikan build.
`String`	`getBuildBranch()` Metode opsional untuk menampilkan cabang kontrol sumber tempat build yang sedang diuji dihasilkan.
`String`	`getBuildFlavor()` Metode opsional untuk menampilkan jenis build yang sedang diuji.
`String`	`getBuildId()` Menampilkan ID unik build yang sedang diuji.
`String`	`getBuildTargetName()` Menampilkan nama lengkap untuk build yang sedang diuji.
`String`	`getDeviceSerial()`
`File`	`getFile(String name)` Metode helper untuk mengambil file dengan nama yang diberikan.
`File`	`getFile(BuildInfoKey.BuildInfoFileKey key)` Metode helper untuk mengambil file dengan `BuildInfoFileKey` yang diberikan.
	`getFiles()` Menampilkan semua `VersionedFile` yang disimpan di `BuildInfo` ini.
	`getProperties()` Menampilkan salinan properti yang saat ini ditetapkan di `IBuildInfo`.
	`getRemoteFiles()` Mendapatkan jalur untuk artefak build yang ditunda download-nya.
`String`	`getTestTag()` Menampilkan nama unik untuk pengujian yang sedang dijalankan.
`String`	`getVersion(BuildInfoKey.BuildInfoFileKey key)` Metode helper untuk mengambil versi file dengan `BuildInfoFileKey` yang diberikan.
`String`	`getVersion(String name)` Metode helper untuk mengambil versi file dengan nama yang diberikan.
`VersionedFile`	`getVersionedFile(BuildInfoKey.BuildInfoFileKey key)` Metode bantuan untuk mengambil `VersionedFile` dengan `BuildInfoFileKey` tertentu.
`final VersionedFile`	`getVersionedFile(String name)` Metode bantuan untuk mengambil `VersionedFile` dengan nama tertentu.
	`getVersionedFileKeys()` Menampilkan kumpulan kunci yang tersedia untuk membuat kueri `VersionedFile` melalui `getFile(BuildInfoFileKey)`.
`final`	`getVersionedFiles(BuildInfoKey.BuildInfoFileKey key)` Metode helper untuk mengambil daftar `VersionedFile` yang terkait dengan `BuildInfoFileKey` tertentu.
`int`	`hashCode()`
`void`	`removeBuildAttribute(String attributeName)` Menghapus attributeName tertentu dari pelacakan.
`void`	`setBuildBranch(String branch)` Menetapkan cabang build
`void`	`setBuildFlavor(String buildFlavor)` Tetapkan ragam build.
`void`	`setBuildId(String buildId)` Menetapkan ID unik build yang sedang diuji.
`void`	`setDeviceSerial(String serial)` Tetapkan serial `ITestDevice` yang terkait dengan build ini.
`void`	`setFile(String name, File file, String version)` Menyimpan file dengan nama yang diberikan dalam info build ini.
`void`	`setFile(BuildInfoKey.BuildInfoFileKey key, File file, String version)` Menyimpan file yang diberi `BuildInfoFileKey` dalam info build ini.
`void`	`setProperties(BuildInfoProperties... properties)` Tetapkan `BuildInfoProperties` untuk instance `IBuildInfo`.
`void`	`setTestTag(String testTag)` Menetapkan nama unik untuk pengujian yang sedang dijalankan.
`File`	`stageRemoteFile(String fileName, File workingDir)` Menyiapkan file yang merupakan bagian dari file jarak jauh di direktori root info build.
`BuildInformation.BuildInfo`	`toProto()` Lakukan serialisasi instance BuildInfo menjadi protobuf.
`String`	`toString()`

Metode yang dilindungi
`void`	`addAllBuildAttributes(BuildInfo build)` Metode helper untuk menyalin atribut build, cabang, dan ragam dari build lain.
`void`	`addAllFiles(BuildInfo build)` Metode bantuan untuk menyalin semua file dari build lain.
`boolean`	`applyBuildProperties(VersionedFile origFileConsidered, IBuildInfo build, IBuildInfo receiver)` Izinkan untuk menerapkan beberapa `IBuildInfo.BuildInfoProperties` dan mungkin melakukan penanganan yang berbeda.
`MultiMap<String, String>`	`getAttributesMultiMap()`
	`getVersionedFileMap()`
`MultiMap<String, VersionedFile>`	`getVersionedFileMapFull()`

Konstruktor publik

BuildInfo

public BuildInfo ()

Membuat BuildInfo menggunakan nilai atribut default.

BuildInfo

public BuildInfo (String buildId, 
                String buildTargetName)

Membuat BuildInfo

Parameter
`buildId`	`String`: ID build
`buildTargetName`	`String`: nama target build

Metode publik

addAppPackageFile

public void addAppPackageFile (File appPackageFile, 
                String version)

Menambahkan file apk lokal dan versi terkaitnya. Perhatikan bahwa apk akan ditampilkan dari getAppPackageFiles() sesuai urutan penambahannya oleh metode ini.

Parameter
`appPackageFile`	`File`
`version`	`String`

addBuildAttribute

public void addBuildAttribute (String attributeName, 
                String attributeValue)

Tambahkan atribut build. Tindakan ini tidak mengizinkan penggantian attributeName yang ada.

Parameter
`attributeName`	`String`: nama atribut unik
`attributeValue`	`String`: nilai atribut

addBuildAttributes

public void addBuildAttributes ( buildAttributes)

Menambahkan atribut build

Parameter
`buildAttributes`	: Peta atribut yang akan ditambahkan

allowStagingRemoteFile

public void allowStagingRemoteFile (boolean stageRemoteFile)

Menetapkan izin untuk mengizinkan staging file jarak jauh.

Parameter
`stageRemoteFile`	`boolean`

cleanUp

public void cleanUp ()

Membersihkan file build sementara

cleanUp

public void cleanUp ( doNotClean)

Versi cleanUp() yang beberapa file-nya tidak dihapus.

Parameter
`doNotClean`

clone

public IBuildInfo clone ()

Hasil
`IBuildInfo`

copyAllFileFrom

public final void copyAllFileFrom (BuildInfo build)

Salin semua VersionedFile dari build tertentu ke build ini.

Parameter
`build`	`BuildInfo`

sama dengan

public boolean equals (Object obj)

Parameter
`obj`	`Object`

Hasil
`boolean`

fromProto

public static IBuildInfo fromProto (BuildInformation.BuildInfo protoBuild)

Operasi invers ke toProto() untuk mendapatkan kembali instance.

Parameter
`protoBuild`	`BuildInformation.BuildInfo`

Hasil
`IBuildInfo`

getAppPackageFiles

public  getAppPackageFiles ()

Mendapatkan salinan kumpulan file apk aplikasi lokal dan versinya. Urutan yang ditampilkan cocok dengan urutan penambahan apk ke IAppBuildInfo.

Hasil

getBuildAttributes

public  getBuildAttributes ()

Mendapatkan kumpulan pasangan nama-nilai atribut tambahan yang mendeskripsikan build.

Hasil
	`ERROR(/Map)` atribut build. Tidak akan menjadi `null`, tetapi mungkin kosong.

getBuildBranch

public String getBuildBranch ()

Metode opsional untuk menampilkan cabang kontrol sumber tempat build yang sedang diuji dihasilkan.

Hasil
`String`	cabang build atau `null` jika tidak ditetapkan/tidak berlaku

getBuildFlavor

public String getBuildFlavor ()

Metode opsional untuk menampilkan jenis build yang sedang diuji.

Implementasi umum untuk build platform Android adalah menampilkan (build product)-(build os)-(build variant). ie generic-linux-userdebug

Hasil
`String`	ragam build atau `null` jika tidak ditetapkan/tidak berlaku

getBuildId

public String getBuildId ()

Menampilkan ID unik build yang sedang diuji. Tidak boleh null. Default-nya adalah UNKNOWN_BUILD_ID.

Hasil
`String`

getBuildTargetName

public String getBuildTargetName ()

Menampilkan nama lengkap untuk build yang sedang diuji.

Implementasi umum adalah membuat nama target build dari kombinasi ragam build dan nama cabang. [yaitu (nama cabang)-(rasa build)]

Hasil
`String`

getDeviceSerial

public String getDeviceSerial ()

Hasil
`String`

getFile

public File getFile (String name)

Metode helper untuk mengambil file dengan nama yang diberikan.

Hasil
`File`	file gambar atau `null` jika tidak ditemukan

getFile

public File getFile (BuildInfoKey.BuildInfoFileKey key)

Metode helper untuk mengambil file dengan BuildInfoFileKey yang diberikan.

Parameter
`key`	`BuildInfoKey.BuildInfoFileKey`: `BuildInfoFileKey` yang diminta.

Hasil
`File`	file gambar atau `null` jika tidak ditemukan

getFiles

public  getFiles ()

Menampilkan semua VersionedFile yang disimpan di BuildInfo ini.

Hasil

getProperties

public  getProperties ()

Menampilkan salinan properti yang saat ini ditetapkan di IBuildInfo.

Hasil

getRemoteFiles

public  getRemoteFiles ()

Mendapatkan jalur untuk artefak build yang ditunda download-nya.

Hasil

getTestTag

public String getTestTag ()

Menampilkan nama unik untuk pengujian yang sedang dijalankan.

Hasil
`String`

getVersion

public String getVersion (BuildInfoKey.BuildInfoFileKey key)

Metode helper untuk mengambil versi file dengan BuildInfoFileKey yang diberikan.

Parameter
`key`	`BuildInfoKey.BuildInfoFileKey`: `BuildInfoFileKey` yang diminta.

Hasil
`String`	versi image atau `null` jika tidak ditemukan

getVersion

public String getVersion (String name)

Metode helper untuk mengambil versi file dengan nama yang diberikan.

Hasil
`String`	versi image atau `null` jika tidak ditemukan

getVersionedFile

public VersionedFile getVersionedFile (BuildInfoKey.BuildInfoFileKey key)

Metode helper untuk mengambil VersionedFile dengan BuildInfoFileKey tertentu.

Parameter
`key`	`BuildInfoKey.BuildInfoFileKey`: `BuildInfoFileKey` yang diminta.

Hasil
`VersionedFile`	File yang memiliki versi atau `null` jika tidak ditemukan

getVersionedFile

public final VersionedFile getVersionedFile (String name)

Metode bantuan untuk mengambil VersionedFile dengan nama tertentu.

Hasil
`VersionedFile`	File yang memiliki versi atau `null` jika tidak ditemukan

getVersionedFileKeys

public  getVersionedFileKeys ()

Menampilkan kumpulan kunci yang tersedia untuk membuat kueri VersionedFile melalui getFile(BuildInfoFileKey).

Hasil

getVersionedFiles

public final  getVersionedFiles (BuildInfoKey.BuildInfoFileKey key)

Metode helper untuk mengambil daftar VersionedFile yang terkait dengan BuildInfoFileKey tertentu. Jika kunci memungkinkan penyimpanan daftar.

Parameter
`key`	`BuildInfoKey.BuildInfoFileKey`: `BuildInfoFileKey` yang diminta.

Hasil
	File yang memiliki versi atau `null` jika tidak ditemukan

hashCode

public int hashCode ()

Hasil
`int`

removeBuildAttribute

public void removeBuildAttribute (String attributeName)

Menghapus attributeName tertentu dari pelacakan.

Parameter
`attributeName`	`String`: atribut yang akan dihentikan pelacakannya

setBuildBranch

public void setBuildBranch (String branch)

Menetapkan cabang build

Parameter
`branch`	`String`: nama cabang

setBuildFlavor

public void setBuildFlavor (String buildFlavor)

Tetapkan ragam build.

setBuildId

public void setBuildId (String buildId)

Menetapkan ID unik build yang sedang diuji. Tidak boleh null.

Parameter
`buildId`	`String`

setDeviceSerial

public void setDeviceSerial (String serial)

Tetapkan serial ITestDevice yang terkait dengan build ini.

Parameter
`serial`	`String`: nomor seri `ITestDevice` yang digunakan untuk menjalankan build ini.

setFile

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

Menyimpan file dengan nama yang diberikan dalam info build ini.

Parameter
`name`	`String`: nama unik file
`file`	`File`: `ERROR(/File)` lokal
`version`	`String`: versi file

setFile

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

Menyimpan file yang diberi BuildInfoFileKey dalam info build ini.

Parameter
`key`	`BuildInfoKey.BuildInfoFileKey`: nama unik file berdasarkan `BuildInfoFileKey`.
`file`	`File`: `ERROR(/File)` lokal
`version`	`String`: versi file

setProperties

public void setProperties (BuildInfoProperties... properties)

Tetapkan BuildInfoProperties untuk instance IBuildInfo. Ganti properti yang ada yang ditetapkan sebelumnya.

Parameter
`properties`	`BuildInfoProperties`: Daftar properti yang akan ditambahkan.

setTestTag

public void setTestTag (String testTag)

Menetapkan nama unik untuk pengujian yang sedang dijalankan.

Parameter
`testTag`	`String`

stageRemoteFile

public File stageRemoteFile (String fileName, 
                File workingDir)

Menyiapkan file yang merupakan bagian dari file jarak jauh di direktori root info build.

TODO(b/138416078): Hapus antarmuka ini dan pemanggilnya saat modul yang diperlukan oleh pengujian dapat di-build dengan benar ke direktori modul pengujian itu sendiri.

Parameter
`fileName`	`String`: Nama file yang akan ditempatkan di file jarak jauh.
`workingDir`	`File`: objek `ERROR(/File)` dari direktori untuk melakukan staging file.

Hasil
`File`	objek `ERROR(/File)` file yang di-stage di workingDir lokal.

toProto

public BuildInformation.BuildInfo toProto ()

Lakukan serialisasi instance BuildInfo menjadi protobuf.

Hasil
`BuildInformation.BuildInfo`

toString

public String toString ()

Hasil
`String`

Metode yang dilindungi

addAllBuildAttributes

protected void addAllBuildAttributes (BuildInfo build)

Metode helper untuk menyalin atribut build, cabang, dan ragam dari build lain.

Parameter
`build`	`BuildInfo`

addAllFiles

protected void addAllFiles (BuildInfo build)

Metode bantuan untuk menyalin semua file dari build lain.

Membuat hardlink baru ke file sehingga setiap build akan memiliki jalur file unik ke file.

Parameter
`build`	`BuildInfo`

Menampilkan
	jika pengecualian ditampilkan saat membuat hardlink.

applyBuildProperties

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

Izinkan untuk menerapkan beberapa IBuildInfo.BuildInfoProperties dan mungkin melakukan penanganan yang berbeda.

Parameter
`origFileConsidered`	`VersionedFile`: `VersionedFile` yang saat ini dilihat.
`build`	`IBuildInfo`: build asli yang di-clone
`receiver`	`IBuildInfo`: build yang menerima informasi.

Hasil
`boolean`	Benar jika kita menerapkan properti dan penanganan lebih lanjut harus dilewati. Salah jika tidak.

getAttributesMultiMap

protected MultiMap<String, String> getAttributesMultiMap ()

Hasil
`MultiMap<String, String>`

getVersionedFileMap

protected  getVersionedFileMap ()

Hasil

getVersionedFileMapFull

protected MultiMap<String, VersionedFile> getVersionedFileMapFull ()

Hasil
`MultiMap<String, VersionedFile>`