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 merepresentasikan aplikasi Android dan paket pengujiannya.  DeviceBuildInfo IBuildInfo yang merepresentasikan 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 ada dalam direktori di sistem file lokal.  OtaDeviceBuildInfo IDeviceBuildInfo yang digunakan untuk pengujian update over-the-air.

---

Implementasi generik 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(Map<String, String> buildAttributes) Menambahkan atribut build
void	allowStagingRemoteFile(boolean stageRemoteFile) Menetapkan izin untuk mengizinkan penyiapan file jarak jauh.
void	cleanUp() Hapus semua file build sementara
void	cleanUp(List<File> doNotClean) Versi cleanUp() yang beberapa filenya tidak dihapus.
IBuildInfo	clone()
final void	copyAllFileFrom(BuildInfo build) Menyalin semua VersionedFile dari build tertentu ke build ini.
boolean	equals(Object obj)
static IBuildInfo	fromProto(BuildInformation.BuildInfo protoBuild) Operasi terbalik ke toProto() untuk mendapatkan kembali instance.
List<VersionedFile>	getAppPackageFiles() Mendapatkan salinan set file APK aplikasi lokal dan versinya.
Map<String, String>	getBuildAttributes() Mendapatkan serangkaian pasangan nama-nilai dari atribut tambahan yang mendeskripsikan build.
String	getBuildBranch() Metode opsional untuk menampilkan cabang kontrol sumber yang digunakan untuk membuat build yang sedang diuji.
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 tertentu.
File	getFile(BuildInfoKey.BuildInfoFileKey key) Metode helper untuk mengambil file dengan BuildInfoFileKey tertentu.
Collection<VersionedFile>	getFiles() Menampilkan semua VersionedFile yang disimpan dalam BuildInfo ini.
Set<IBuildInfo.BuildInfoProperties>	getProperties() Menampilkan salinan properti yang saat ini ditetapkan di IBuildInfo.
Set<File>	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 tertentu.
String	getVersion(String name) Metode helper untuk mengambil versi file dengan nama tertentu.
VersionedFile	getVersionedFile(BuildInfoKey.BuildInfoFileKey key) Metode helper untuk mengambil VersionedFile dengan BuildInfoFileKey tertentu.
final VersionedFile	getVersionedFile(String name) Metode helper untuk mengambil VersionedFile dengan nama tertentu.
Set<String>	getVersionedFileKeys() Menampilkan kumpulan kunci yang tersedia untuk mengkueri VersionedFile melalui getFile(BuildInfoFileKey).
final List<VersionedFile>	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 varian build.
void	setBuildId(String buildId) Menetapkan ID unik build yang sedang diuji.
void	setDeviceSerial(String serial) Menetapkan ITestDeviceserial yang terkait dengan build ini.
void	setFile(BuildInfoKey.BuildInfoFileKey key, File file, String version) Menyimpan file yang diberi BuildInfoFileKey dalam info build ini.
void	setFile(String name, File file, String version) Menyimpan file dengan nama tertentu 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) Siapkan file yang merupakan bagian dari file jarak jauh di direktori root info build.
BuildInformation.BuildInfo	toProto() Lakukan serialisasi instance BuildInfo ke dalam protobuf.
String	toString()

Metode yang dilindungi
void	addAllBuildAttributes(BuildInfo build) Metode helper untuk menyalin atribut build, cabang, dan varian dari build lain.
void	addAllFiles(BuildInfo build) Metode helper untuk menyalin semua file dari build lain.
boolean	applyBuildProperties(VersionedFile origFileConsidered, IBuildInfo build, IBuildInfo receiver) Mengizinkan penerapan beberapa IBuildInfo.BuildInfoProperties dan mungkin melakukan penanganan yang berbeda.
MultiMap<String, String>	getAttributesMultiMap()
Map<String, VersionedFile>	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() dalam urutan penambahannya oleh metode ini.

Parameter
appPackageFile	File
version	String

addBuildAttribute

public void addBuildAttribute (String attributeName, 
                String attributeValue)

Tambahkan atribut build. Hal ini tidak memungkinkan penggantian attributeName yang ada.

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

addBuildAttributes

public void addBuildAttributes (Map<String, String> buildAttributes)

Menambahkan atribut build

Parameter
buildAttributes	Map: Peta atribut yang akan ditambahkan

allowStagingRemoteFile

public void allowStagingRemoteFile (boolean stageRemoteFile)

Menetapkan izin untuk mengizinkan penyiapan file jarak jauh.

Parameter
stageRemoteFile	boolean

cleanUp

public void cleanUp ()

Hapus semua file build sementara

cleanUp

public void cleanUp (List<File> doNotClean)

Versi cleanUp() yang beberapa filenya tidak dihapus.

Parameter
doNotClean	List

clone

public IBuildInfo clone ()

Hasil
IBuildInfo

copyAllFileFrom

public final void copyAllFileFrom (BuildInfo build)

Menyalin 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 terbalik ke toProto() untuk mendapatkan kembali instance.

Parameter
protoBuild	BuildInformation.BuildInfo

Hasil
IBuildInfo

getAppPackageFiles

public List<VersionedFile> getAppPackageFiles ()

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

Hasil
List<VersionedFile>

getBuildAttributes

public Map<String, String> getBuildAttributes ()

Mendapatkan serangkaian pasangan nama-nilai dari atribut tambahan yang mendeskripsikan build.

Hasil
Map<String, String>	Map atribut build. Tidak akan menjadi null, tetapi mungkin kosong.

getBuildBranch

public String getBuildBranch ()

Metode opsional untuk menampilkan cabang kontrol sumber yang digunakan untuk membuat build yang sedang diuji.

Hasil
String	cabang build atau null jika tidak disetel/tidak berlaku

getBuildFlavor

public String getBuildFlavor ()

Metode opsional untuk menampilkan jenis build yang sedang diuji.

Implementasi umum untuk build platform Android adalah menampilkan (produk build)-(OS build)-(varian build). ie generic-linux-userdebug

Hasil
String	varian build atau null jika tidak disetel/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. [ie (nama cabang)-(varian build)]

Hasil
String

getDeviceSerial

public String getDeviceSerial ()

Hasil
String

getFile

public File getFile (String name)

Metode helper untuk mengambil file dengan nama tertentu.

Hasil
File	file gambar atau null jika tidak ditemukan

getFile

public File getFile (BuildInfoKey.BuildInfoFileKey key)

Metode helper untuk mengambil file dengan BuildInfoFileKey tertentu.

Parameter
key	BuildInfoKey.BuildInfoFileKey: BuildInfoFileKey yang diminta.

Hasil
File	file gambar atau null jika tidak ditemukan

getFiles

public Collection<VersionedFile> getFiles ()

Menampilkan semua VersionedFile yang disimpan dalam BuildInfo ini.

Hasil
Collection<VersionedFile>

getProperties

public Set<IBuildInfo.BuildInfoProperties> getProperties ()

Menampilkan salinan properti yang saat ini ditetapkan di IBuildInfo.

Hasil
Set<IBuildInfo.BuildInfoProperties>

getRemoteFiles

public Set<File> getRemoteFiles ()

Mendapatkan jalur untuk artefak build yang ditunda download-nya.

Hasil
Set<File>

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

Parameter
key	BuildInfoKey.BuildInfoFileKey: BuildInfoFileKey yang diminta.

Hasil
String	versi gambar atau null jika tidak ditemukan

getVersion

public String getVersion (String name)

Metode helper untuk mengambil versi file dengan nama tertentu.

Hasil
String	versi gambar 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 berversi atau null jika tidak ditemukan

getVersionedFile

public final VersionedFile getVersionedFile (String name)

Metode helper untuk mengambil VersionedFile dengan nama tertentu.

Hasil
VersionedFile	File berversi atau null jika tidak ditemukan

getVersionedFileKeys

public Set<String> getVersionedFileKeys ()

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

Hasil
Set<String>

getVersionedFiles

public final List<VersionedFile> 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
List<VersionedFile>	File berversi 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 berhenti dilacak

setBuildBranch

public void setBuildBranch (String branch)

Menetapkan cabang build

Parameter
branch	String: nama cabang

setBuildFlavor

public void setBuildFlavor (String buildFlavor)

Tetapkan varian 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)

Menetapkan ITestDeviceserial yang terkait dengan build ini.

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

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: File lokal
version	String: versi file

setFile

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

Menyimpan file dengan nama tertentu dalam info build ini.

Parameter
name	String: nama unik file
file	File: 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)

Siapkan 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 dibangun dengan benar dan menghasilkan output ke direktori modul pengujian itu sendiri.

Parameter
fileName	String: Nama file yang akan ditemukan di file jarak jauh.
workingDir	File: objek File dari direktori untuk mengatur file.

Hasil
File	objek File dari file yang di-stage di workingDir lokal.

toProto

public BuildInformation.BuildInfo toProto ()

Lakukan serialisasi instance BuildInfo ke dalam 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 varian dari build lain.

Parameter
build	BuildInfo

addAllFiles

protected void addAllFiles (BuildInfo build)

Metode helper untuk menyalin semua file dari build lain.

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

Parameter
build	BuildInfo

Menampilkan
IOException	jika pengecualian terjadi saat membuat hardlink.

applyBuildProperties

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

Mengizinkan penerapan 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 kami menerapkan properti dan penanganan lebih lanjut harus dilewati. Salah jika tidak.

getAttributesMultiMap

protected MultiMap<String, String> getAttributesMultiMap ()

Hasil
MultiMap<String, String>

getVersionedFileMap

protected Map<String, VersionedFile> getVersionedFileMap ()

Hasil
Map<String, VersionedFile>

getVersionedFileMapFull

protected MultiMap<String, VersionedFile> getVersionedFileMapFull ()

Hasil
MultiMap<String, VersionedFile>