BuildInfo

public class BuildInfo
extends Object implements IBuildInfo

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

คลาสย่อยโดยตรงที่ทราบ AppBuildInfo, DeviceBuildInfo, FolderBuildInfo, OtatoolsBuildInfo AppBuildInfo IBuildInfo ที่แสดงถึงแอปพลิเคชัน Android และแพ็กเกจทดสอบของแอปพลิเคชัน  DeviceBuildInfo IBuildInfo ที่แสดงถึงบิลด์อุปกรณ์ Android ที่สมบูรณ์และการทดสอบ (ไม่บังคับ)  FolderBuildInfo การใช้งาน IFolderBuildInfo อย่างเป็นรูปธรรม  OtatoolsBuildInfo IBuildInfo ที่มีอาร์ติแฟกต์ otatools

คลาสย่อยโดยอ้อมที่ทราบ AppDeviceBuildInfo, ClusterBuildInfo, DeviceFolderBuildInfo, OtaDeviceBuildInfo AppDeviceBuildInfo คลาสนี้เลิกใช้งานแล้ว ใช้ IDeviceBuildInfo โดยตรง  ClusterBuildInfo คลาส IBuildInfo สำหรับบิลด์ที่ส่งผ่านจาก TFC  DeviceFolderBuildInfo IDeviceBuildInfo ที่มีอาร์ติแฟกต์อื่นๆ ของบิลด์อยู่ในไดเรกทอรีในระบบไฟล์ในเครื่องด้วย  OtaDeviceBuildInfo IDeviceBuildInfo ที่ใช้สำหรับการทดสอบการอัปเดตแบบ OTA

---

การใช้งานทั่วไปของ IBuildInfo ที่ควรเชื่อมโยงกับ ITestDevice

สรุป

ตัวสร้างแบบสาธารณะ
BuildInfo() สร้าง BuildInfo โดยใช้ค่าแอตทริบิวต์เริ่มต้น
BuildInfo(String buildId, String buildTargetName) สร้าง BuildInfo

เมธอดสาธารณะ
void	addAppPackageFile(File appPackageFile, String version) เพิ่มไฟล์ APK ในเครื่องและเวอร์ชันที่เกี่ยวข้อง
void	addBuildAttribute(String attributeName, String attributeValue) เพิ่มแอตทริบิวต์บิลด์
void	addBuildAttributes( buildAttributes) เพิ่มแอตทริบิวต์บิลด์
void	allowStagingRemoteFile(boolean stageRemoteFile) ตั้งค่าสิทธิ์เพื่ออนุญาตให้จัดเตรียมไฟล์ระยะไกล
void	cleanUp() ล้างไฟล์บิลด์ชั่วคราว
void	cleanUp( doNotClean) เวอร์ชัน cleanUp() ที่ระบบไม่ได้ลบบางไฟล์
IBuildInfo	clone()
final void	copyAllFileFrom(BuildInfo build) คัดลอก VersionedFile ทั้งหมดจากบิลด์หนึ่งไปยังบิลด์นี้
boolean	equals(Object obj)
static IBuildInfo	fromProto(BuildInformation.BuildInfo protoBuild) ดำเนินการแบบย้อนกลับเป็น toProto() เพื่อรับอินสแตนซ์คืน
	getAppPackageFiles() รับสำเนาชุดไฟล์ APK ของแอปในเครื่องและเวอร์ชันของไฟล์
	getBuildAttributes() รับชุดคู่ชื่อ-ค่าของแอตทริบิวต์เพิ่มเติมที่อธิบายบิลด์
String	getBuildBranch() วิธีการที่ไม่บังคับในการแสดงผลสาขาการควบคุมแหล่งที่มาที่บิลด์ที่ทดสอบสร้างขึ้น
String	getBuildFlavor() เมธอดที่ไม่บังคับเพื่อแสดงผลประเภทของบิลด์ที่ทดสอบ
String	getBuildId() แสดงผลตัวระบุที่ไม่ซ้ำกันของบิลด์ที่ทดสอบ
String	getBuildTargetName() แสดงชื่อแบบเต็มของบิลด์ที่ทดสอบ
String	getDeviceSerial()
File	getFile(String name) เมธอดตัวช่วยในการเรียกข้อมูลไฟล์ที่มีชื่อที่ระบุ
File	getFile(BuildInfoKey.BuildInfoFileKey key) เมธอดตัวช่วยในการเรียกข้อมูลไฟล์ที่มี BuildInfoFileKey ที่ระบุ
	getFiles() แสดงผล VersionedFile ทั้งหมดที่จัดเก็บไว้ใน BuildInfo นี้
	getProperties() แสดงผลสําเนาของพร็อพเพอร์ตี้ที่ตั้งค่าไว้ใน IBuildInfo ในขณะนั้น
	getRemoteFiles() รับเส้นทางสำหรับอาร์ติแฟกต์การสร้างที่เลื่อนเวลาการดาวน์โหลด
String	getTestTag() แสดงผลชื่อที่ไม่ซ้ำกันสําหรับการทดสอบที่กําลังทํางาน
String	getVersion(BuildInfoKey.BuildInfoFileKey key) เมธอดตัวช่วยในการดึงข้อมูลเวอร์ชันไฟล์ที่มี BuildInfoFileKey ที่ระบุ
String	getVersion(String name) เมธอดตัวช่วยในการเรียกข้อมูลเวอร์ชันไฟล์ที่มีชื่อที่ระบุ
VersionedFile	getVersionedFile(BuildInfoKey.BuildInfoFileKey key) เมธอดตัวช่วยในการดึงข้อมูล VersionedFile ที่มี BuildInfoFileKey หนึ่งๆ
final VersionedFile	getVersionedFile(String name) เมธอดตัวช่วยในการดึงข้อมูล VersionedFile ที่มีชื่อที่ระบุ
	getVersionedFileKeys() แสดงชุดคีย์ที่ใช้ค้นหา VersionedFile ผ่าน getFile(BuildInfoFileKey) ได้
final	getVersionedFiles(BuildInfoKey.BuildInfoFileKey key) เมธอดตัวช่วยในการดึงข้อมูลรายการ VersionedFile ที่เชื่อมโยงกับ BuildInfoFileKey หนึ่งๆ
int	hashCode()
void	removeBuildAttribute(String attributeName) นํา attributeName ที่ระบุออกจากการติดตาม
void	setBuildBranch(String branch) ตั้งค่าสาขาบิลด์
void	setBuildFlavor(String buildFlavor) ตั้งค่า Flavor ของบิลด์
void	setBuildId(String buildId) ตั้งค่าตัวระบุที่ไม่ซ้ำของบิลด์ที่ทดสอบ
void	setDeviceSerial(String serial) ตั้งค่าซีเรียล ITestDevice ที่เชื่อมโยงกับบิลด์นี้
void	setFile(String name, File file, String version) จัดเก็บไฟล์ที่มีชื่อที่ระบุไว้ในข้อมูลบิลด์นี้
void	setFile(BuildInfoKey.BuildInfoFileKey key, File file, String version) จัดเก็บไฟล์ที่ได้รับ BuildInfoFileKey ในข้อมูลบิลด์นี้
void	setProperties(BuildInfoProperties... properties) ตั้งค่า BuildInfoProperties สำหรับอินสแตนซ์ IBuildInfo
void	setTestTag(String testTag) ตั้งชื่อที่ไม่ซ้ำกันสําหรับการทดสอบที่กําลังทํางาน
File	stageRemoteFile(String fileName, File workingDir) จัดเตรียมไฟล์ที่เป็นส่วนหนึ่งของไฟล์ระยะไกลในไดเรกทอรีรูทของข้อมูลบิลด์
BuildInformation.BuildInfo	toProto() แปลงอินสแตนซ์ BuildInfo เป็น protobuf
String	toString()

วิธีการที่มีการป้องกัน
void	addAllBuildAttributes(BuildInfo build) เมธอดตัวช่วยในการคัดลอกแอตทริบิวต์ บิลด์ สาขา และ Flavour จากบิลด์อื่น
void	addAllFiles(BuildInfo build) เมธอดตัวช่วยในการคัดลอกไฟล์ทั้งหมดจากบิลด์อื่น
boolean	applyBuildProperties(VersionedFile origFileConsidered, IBuildInfo build, IBuildInfo receiver) อนุญาตให้ใช้ IBuildInfo.BuildInfoProperties บางส่วน และอาจใช้การจัดการแบบอื่น
MultiMap<String, String>	getAttributesMultiMap()
	getVersionedFileMap()
MultiMap<String, VersionedFile>	getVersionedFileMapFull()

ตัวสร้างแบบสาธารณะ

BuildInfo

public BuildInfo ()

สร้าง BuildInfo โดยใช้ค่าแอตทริบิวต์เริ่มต้น

BuildInfo

public BuildInfo (String buildId, 
                String buildTargetName)

สร้าง BuildInfo

พารามิเตอร์
buildId	String: รหัสบิลด์
buildTargetName	String: ชื่อเป้าหมายการสร้าง

เมธอดสาธารณะ

addAppPackageFile

public void addAppPackageFile (File appPackageFile, 
                String version)

เพิ่มไฟล์ APK ในเครื่องและเวอร์ชันที่เกี่ยวข้อง โปรดทราบว่าระบบจะแสดงผล APK จาก getAppPackageFiles() ตามลำดับที่เพิ่มด้วยวิธีนี้

พารามิเตอร์
appPackageFile	File
version	String

addBuildAttribute

public void addBuildAttribute (String attributeName, 
                String attributeValue)

เพิ่มแอตทริบิวต์บิลด์ ซึ่งไม่อนุญาตให้ลบล้างattributeName ที่มีอยู่

พารามิเตอร์
attributeName	String: ชื่อแอตทริบิวต์ที่ไม่ซ้ำ
attributeValue	String: ค่าแอตทริบิวต์

addBuildAttributes

public void addBuildAttributes ( buildAttributes)

เพิ่มแอตทริบิวต์บิลด์

พารามิเตอร์
buildAttributes	: แมปแอตทริบิวต์ที่จะเพิ่ม

allowStagingRemoteFile

public void allowStagingRemoteFile (boolean stageRemoteFile)

ตั้งค่าสิทธิ์เพื่ออนุญาตให้จัดเตรียมไฟล์ระยะไกล

พารามิเตอร์
stageRemoteFile	boolean

cleanUp

public void cleanUp ()

ล้างไฟล์บิลด์ชั่วคราว

cleanUp

public void cleanUp ( doNotClean)

เวอร์ชัน cleanUp() ที่ระบบไม่ได้ลบบางไฟล์

พารามิเตอร์
doNotClean

โคลน

public IBuildInfo clone ()

คิกรีเทิร์น
IBuildInfo

copyAllFileFrom

public final void copyAllFileFrom (BuildInfo build)

คัดลอก VersionedFile ทั้งหมดจากบิลด์หนึ่งไปยังบิลด์นี้

พารามิเตอร์
build	BuildInfo

เท่ากับ

public boolean equals (Object obj)

พารามิเตอร์
obj	Object

คิกรีเทิร์น
boolean

fromProto

public static IBuildInfo fromProto (BuildInformation.BuildInfo protoBuild)

ดำเนินการแบบย้อนกลับเป็น toProto() เพื่อรับอินสแตนซ์คืน

พารามิเตอร์
protoBuild	BuildInformation.BuildInfo

คิกรีเทิร์น
IBuildInfo

getAppPackageFiles

public  getAppPackageFiles ()

รับสำเนาชุดไฟล์ APK ของแอปในเครื่องและเวอร์ชันของไฟล์ ลําดับที่แสดงจะตรงกับลําดับที่เพิ่ม apk ลงใน IAppBuildInfo

คิกรีเทิร์น

getBuildAttributes

public  getBuildAttributes ()

รับชุดคู่ชื่อ-ค่าของแอตทริบิวต์เพิ่มเติมที่อธิบายบิลด์

คิกรีเทิร์น
	ERROR(/Map) ของแอตทริบิวต์บิลด์ จะไม่เท่ากับ null แต่อาจว่างเปล่า

getBuildBranch

public String getBuildBranch ()

วิธีการที่ไม่บังคับในการแสดงผลสาขาการควบคุมแหล่งที่มาที่บิลด์ที่ทดสอบสร้างขึ้น

คิกรีเทิร์น
String	branch ของบิลด์หรือ null หากไม่ได้ตั้งค่า/ไม่เกี่ยวข้อง

getBuildFlavor

public String getBuildFlavor ()

เมธอดที่ไม่บังคับเพื่อแสดงผลประเภทของบิลด์ที่ทดสอบ

การใช้งานทั่วไปสำหรับบิลด์แพลตฟอร์ม Android คือการคืนค่า (build product)-(build os)-(build variant) ie generic-linux-userdebug

คิกรีเทิร์น
String	รสชาติของบิลด์หรือ null หากไม่ได้ตั้งค่า/ไม่เกี่ยวข้อง

getBuildId

public String getBuildId ()

แสดงผลตัวระบุที่ไม่ซ้ำกันของบิลด์ที่ทดสอบ ไม่ควรเป็นค่า Null ค่าเริ่มต้นคือ UNKNOWN_BUILD_ID

คิกรีเทิร์น
String

getBuildTargetName

public String getBuildTargetName ()

แสดงชื่อแบบเต็มของบิลด์ที่ทดสอบ

การใช้งานทั่วไปคือการสร้างชื่อเป้าหมายการสร้างจากชื่อรุ่นการสร้างและชื่อสาขา [เช่น (ชื่อสาขา)-(ชื่อรุ่นบิลด์)]

คิกรีเทิร์น
String

getDeviceSerial

public String getDeviceSerial ()

คิกรีเทิร์น
String

getFile

public File getFile (String name)

เมธอดตัวช่วยในการเรียกข้อมูลไฟล์ที่มีชื่อที่ระบุ

คิกรีเทิร์น
File	ไฟล์รูปภาพหรือ null หากไม่พบ

getFile

public File getFile (BuildInfoKey.BuildInfoFileKey key)

เมธอดตัวช่วยในการเรียกข้อมูลไฟล์ที่มี BuildInfoFileKey ที่ระบุ

พารามิเตอร์
key	BuildInfoKey.BuildInfoFileKey: BuildInfoFileKey ที่ขอ

คิกรีเทิร์น
File	ไฟล์รูปภาพหรือ null หากไม่พบ

getFiles

public  getFiles ()

แสดงผล VersionedFile ทั้งหมดที่จัดเก็บไว้ใน BuildInfo นี้

คิกรีเทิร์น

getProperties

public  getProperties ()

แสดงผลสําเนาของพร็อพเพอร์ตี้ที่ตั้งค่าไว้ใน IBuildInfo ในขณะนั้น

คิกรีเทิร์น

getRemoteFiles

public  getRemoteFiles ()

รับเส้นทางสำหรับอาร์ติแฟกต์การสร้างที่เลื่อนเวลาการดาวน์โหลด

คิกรีเทิร์น

getTestTag

public String getTestTag ()

แสดงผลชื่อที่ไม่ซ้ำกันสําหรับการทดสอบที่กําลังทํางาน

คิกรีเทิร์น
String

getVersion

public String getVersion (BuildInfoKey.BuildInfoFileKey key)

เมธอดตัวช่วยในการดึงข้อมูลเวอร์ชันไฟล์ที่มี BuildInfoFileKey ที่ระบุ

พารามิเตอร์
key	BuildInfoKey.BuildInfoFileKey: BuildInfoFileKey ที่ขอ

คิกรีเทิร์น
String	เวอร์ชันรูปภาพหรือ null หากไม่พบ

getVersion

public String getVersion (String name)

เมธอดตัวช่วยในการเรียกข้อมูลเวอร์ชันไฟล์ที่มีชื่อที่ระบุ

คิกรีเทิร์น
String	เวอร์ชันรูปภาพหรือ null หากไม่พบ

getVersionedFile

public VersionedFile getVersionedFile (BuildInfoKey.BuildInfoFileKey key)

เมธอดตัวช่วยในการดึงข้อมูล VersionedFile ที่มี BuildInfoFileKey หนึ่งๆ

พารามิเตอร์
key	BuildInfoKey.BuildInfoFileKey: BuildInfoFileKey ที่ขอ

คิกรีเทิร์น
VersionedFile	ไฟล์ที่มีเวอร์ชันหรือ null หากไม่พบ

getVersionedFile

public final VersionedFile getVersionedFile (String name)

เมธอดตัวช่วยในการดึงข้อมูล VersionedFile ที่มีชื่อที่ระบุ

คิกรีเทิร์น
VersionedFile	ไฟล์ที่มีเวอร์ชันหรือ null หากไม่พบ

getVersionedFileKeys

public  getVersionedFileKeys ()

แสดงชุดคีย์ที่ใช้ค้นหา VersionedFile ผ่าน getFile(BuildInfoFileKey) ได้

คิกรีเทิร์น

getVersionedFiles

public final  getVersionedFiles (BuildInfoKey.BuildInfoFileKey key)

เมธอดตัวช่วยในการดึงข้อมูลรายการ VersionedFile ที่เชื่อมโยงกับ BuildInfoFileKey หนึ่งๆ หากคีย์อนุญาตให้จัดเก็บรายการ

พารามิเตอร์
key	BuildInfoKey.BuildInfoFileKey: BuildInfoFileKey ที่ขอ

คิกรีเทิร์น
	ไฟล์ที่มีเวอร์ชันหรือ null หากไม่พบ

hashCode

public int hashCode ()

คิกรีเทิร์น
int

removeBuildAttribute

public void removeBuildAttribute (String attributeName)

นํา attributeName ที่ระบุออกจากการติดตาม

พารามิเตอร์
attributeName	String: แอตทริบิวต์ที่จะหยุดการติดตาม

setBuildBranch

public void setBuildBranch (String branch)

ตั้งค่าสาขาบิลด์

พารามิเตอร์
branch	String: ชื่อสาขา

setBuildFlavor

public void setBuildFlavor (String buildFlavor)

ตั้งค่า Flavour ของบิลด์

setBuildId

public void setBuildId (String buildId)

ตั้งค่าตัวระบุที่ไม่ซ้ำของบิลด์ที่ทดสอบ ไม่ควรเป็นค่า Null

พารามิเตอร์
buildId	String

setDeviceSerial

public void setDeviceSerial (String serial)

ตั้งค่าซีเรียล ITestDevice ที่เชื่อมโยงกับบิลด์นี้

พารามิเตอร์
serial	String: หมายเลขซีเรียลของ ITestDevice ที่ใช้เรียกใช้บิลด์นี้

setFile

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

จัดเก็บไฟล์ที่มีชื่อที่ระบุไว้ในข้อมูลบิลด์นี้

พารามิเตอร์
name	String: ชื่อที่ไม่ซ้ำของไฟล์
file	File: ERROR(/File) ในพื้นที่
version	String: เวอร์ชันไฟล์

setFile

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

จัดเก็บไฟล์ที่ได้รับ BuildInfoFileKey ในข้อมูลบิลด์นี้

พารามิเตอร์
key	BuildInfoKey.BuildInfoFileKey: ชื่อที่ไม่ซ้ำของไฟล์ตาม BuildInfoFileKey
file	File: ERROR(/File) ในพื้นที่
version	String: เวอร์ชันไฟล์

setProperties

public void setProperties (BuildInfoProperties... properties)

ตั้งค่า BuildInfoProperties สำหรับอินสแตนซ์ IBuildInfo ลบล้างพร็อพเพอร์ตี้ที่มีอยู่ซึ่งตั้งค่าไว้ก่อนหน้านี้

พารามิเตอร์
properties	BuildInfoProperties: รายการพร็อพเพอร์ตี้ที่จะเพิ่ม

setTestTag

public void setTestTag (String testTag)

ตั้งชื่อที่ไม่ซ้ำกันสําหรับการทดสอบที่กําลังทํางาน

พารามิเตอร์
testTag	String

stageRemoteFile

public File stageRemoteFile (String fileName, 
                File workingDir)

จัดเตรียมไฟล์ที่เป็นส่วนหนึ่งของไฟล์ระยะไกลในไดเรกทอรีรูทของข้อมูลบิลด์

TODO(b/138416078): นำอินเทอร์เฟซนี้และผู้เรียกใช้ออกเมื่อโมดูลที่จําเป็นสําหรับการทดสอบสามารถสร้างเอาต์พุตไปยังไดเรกทอรีของโมดูลทดสอบได้อย่างถูกต้อง

พารามิเตอร์
fileName	String: ชื่อไฟล์ที่จะอยู่ในไฟล์ระยะไกล
workingDir	File: ออบเจ็กต์ ERROR(/File) ของไดเรกทอรีที่จะจัดเตรียมไฟล์

คิกรีเทิร์น
File	ออบเจ็กต์ ERROR(/File) ของไฟล์ที่จัดเตรียมไว้ใน workingDir ในพื้นที่

toProto

public BuildInformation.BuildInfo toProto ()

แปลงอินสแตนซ์ BuildInfo เป็น protobuf

คิกรีเทิร์น
BuildInformation.BuildInfo

toString

public String toString ()

คิกรีเทิร์น
String

วิธีการที่มีการป้องกัน

addAllBuildAttributes

protected void addAllBuildAttributes (BuildInfo build)

เมธอดตัวช่วยในการคัดลอกแอตทริบิวต์ บิลด์ สาขา และ Flavour จากบิลด์อื่น

พารามิเตอร์
build	BuildInfo

addAllFiles

protected void addAllFiles (BuildInfo build)

เมธอดตัวช่วยในการคัดลอกไฟล์ทั้งหมดจากบิลด์อื่น

สร้างฮาร์ดลิงก์ใหม่ไปยังไฟล์เพื่อให้แต่ละบิลด์มีเส้นทางไฟล์ที่ไม่ซ้ำกันไปยังไฟล์

พารามิเตอร์
build	BuildInfo

การโยน
	หากมีการยกเว้นเมื่อสร้างฮาร์ดลิงก์

applyBuildProperties

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

อนุญาตให้ใช้ IBuildInfo.BuildInfoProperties บางส่วน และอาจใช้การจัดการแบบอื่น

พารามิเตอร์
origFileConsidered	VersionedFile: VersionedFile ที่กําลังดูอยู่
build	IBuildInfo: บิลด์ต้นฉบับที่โคลน
receiver	IBuildInfo: บิลด์ที่รับข้อมูล

คิกรีเทิร์น
boolean	เป็นจริงหากเราใช้พร็อพเพอร์ตี้และควรข้ามการจัดการเพิ่มเติม เท็จ ไม่เช่นนั้น

getAttributesMultiMap

protected MultiMap<String, String> getAttributesMultiMap ()

คิกรีเทิร์น
MultiMap<String, String>

getVersionedFileMap

protected  getVersionedFileMap ()

คิกรีเทิร์น

getVersionedFileMapFull

protected MultiMap<String, VersionedFile> getVersionedFileMapFull ()

คิกรีเทิร์น
MultiMap<String, VersionedFile>