IBuildInfo

public interface IBuildInfo

com.android.tradefed.build.IBuildInfo

คลาสย่อยทางอ้อมที่รู้จัก AppBuildInfo , AppDeviceBuildInfo , BuildInfo , ClusterBuildInfo , DeviceBuildInfo , DeviceFolderBuildInfo , FolderBuildInfo , IAppBuildInfo , IDeviceBuildInfo , IFolderBuildInfo , OtaDeviceBuildInfo , OtatoolsBuildInfo AppBuildInfo IBuildInfo ที่แสดงถึงแอปพลิเคชัน Android และแพ็คเกจทดสอบ AppDeviceBuildInfo ชั้นเรียนนี้เลิกใช้แล้ว ใช้ IDeviceBuildInfo โดยตรง BuildInfo การใช้งานทั่วไปของ IBuildInfo ที่ควรเชื่อมโยงกับ ITestDevice ClusterBuildInfo คลาส IBuildInfo สำหรับบิลด์ที่ส่งมาจาก TFC DeviceBuildInfo IBuildInfo ที่แสดงถึงบิวด์อุปกรณ์ Android ที่สมบูรณ์และ (เป็นทางเลือก) การทดสอบ DeviceFolderBuildInfo IDeviceBuildInfo ที่ยังมี build artifact อื่นๆ ที่มีอยู่ในไดเร็กทอรีบนระบบไฟล์ในเครื่อง FolderBuildInfo การใช้งานอย่างเป็นรูปธรรมของ IFolderBuildInfo IAppBuildInfo อินเทอร์เฟซนี้เลิกใช้แล้ว ใช้ IBuildInfo โดยตรง IDeviceBuildInfo IBuildInfo ที่แสดงถึงบิวด์อุปกรณ์ Android ที่สมบูรณ์และ (เป็นทางเลือก) การทดสอบ IFolderBuildInfo IBuildInfo แบบนามธรรมอย่างง่ายซึ่งมีอาร์ติแฟกต์ของ build อยู่ในไดเร็กทอรีระบบไฟล์ในเครื่อง ข้อมูล OtaDeviceBuildInfo IDeviceBuildInfo ที่ใช้สำหรับการทดสอบการอัปเดตแบบ over-the-air OtatoolsBuildInfo IBuildInfo ที่มีสิ่งประดิษฐ์ otatools

---

เก็บข้อมูลเกี่ยวกับบิลด์ที่อยู่ระหว่างการทดสอบ

สรุป

ค่าคงที่
String	REMOTE_FILE_PREFIX คำนำหน้าที่ใช้ในชื่อเพื่อระบุว่าไฟล์ถูกตั้งค่าให้ดาวน์โหลดล่าช้า
String	REMOTE_FILE_VERSION ไฟล์ระยะไกลไม่ได้กำหนดเวอร์ชัน
String	UNKNOWN_BUILD_ID ค่าเริ่มต้นเมื่อไม่ทราบรหัสบิลด์

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

ค่าคงที่

REMOTE_FILE_PREFIX

public static final String REMOTE_FILE_PREFIX

คำนำหน้าที่ใช้ในชื่อเพื่อระบุว่าไฟล์ถูกตั้งค่าให้ดาวน์โหลดล่าช้า

ค่าคงที่: "remote_file:"

REMOTE_FILE_VERSION

public static final String REMOTE_FILE_VERSION

ไฟล์ระยะไกลไม่ได้กำหนดเวอร์ชัน

ค่าคงที่: ""

UNKNOWN_BUILD_ID

public static final String UNKNOWN_BUILD_ID

ค่าเริ่มต้นเมื่อไม่ทราบรหัสบิลด์

ค่าคงที่: "-1"

วิธีการสาธารณะ

addAppPackageFile

public void addAppPackageFile (File appPackageFile, 
                String version)

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

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

addBuildAttribute

public abstract void addBuildAttribute (String attributeName, 
                String attributeValue)

เพิ่มแอตทริบิวต์การสร้าง สิ่งนี้ไม่อนุญาตให้แทนที่ชื่อแอตทริบิวต์ที่มีอยู่

พารามิเตอร์
attributeName	String : ชื่อแอตทริบิวต์เฉพาะ
attributeValue	String : ค่าแอตทริบิวต์

เพิ่ม BuildAttributes

public void addBuildAttributes ( buildAttributes)

เพิ่มคุณสมบัติการสร้าง

พารามิเตอร์
buildAttributes	: แผนที่ของคุณสมบัติที่จะเพิ่ม

AllowStagingRemoteFile

public void allowStagingRemoteFile (boolean stageRemoteFile)

ตั้งค่าสิทธิ์เพื่ออนุญาตไฟล์ระยะไกลชั่วคราว

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

ทำความสะอาด

public abstract void cleanUp ()

ทำความสะอาดไฟล์บิลด์ชั่วคราว

ทำความสะอาด

public abstract void cleanUp ( doNotDelete)

เวอร์ชันของ cleanUp() ซึ่งไฟล์บางไฟล์ไม่ถูกลบ

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

โคลน

public abstract IBuildInfo clone ()

โคลนวัตถุ IBuildInfo

การส่งคืน
IBuildInfo

getAppPackageFiles

public  getAppPackageFiles ()

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

การส่งคืน

getBuildAttributes

public abstract  getBuildAttributes ()

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

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

getBuildBranch

public abstract String getBuildBranch ()

วิธีทางเลือกในการส่งคืนสาขาการควบคุมต้นทางที่ใช้สร้างบิลด์ที่กำลังทดสอบ

การส่งคืน
String	สาขา build หรือ null หากไม่ได้ตั้งค่า/ไม่เกี่ยวข้อง

getBuildFlavour

public abstract String getBuildFlavor ()

วิธีทางเลือกในการส่งคืนประเภทของบิลด์ที่กำลังทดสอบ

การใช้งานทั่วไปสำหรับการสร้างแพลตฟอร์ม Android คือการส่งคืน (สร้างผลิตภัณฑ์)-(สร้างระบบปฏิบัติการ)-(สร้างตัวแปร) เช่น generic-linux-userdebug

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

รับ BuildId

public abstract String getBuildId ()

ส่งกลับตัวระบุเฉพาะของรุ่นภายใต้การทดสอบ ไม่ควรจะเป็นโมฆะ ค่าเริ่มต้นเป็น UNKNOWN_BUILD_ID

การส่งคืน
String

รับ BuildTargetName

public abstract String getBuildTargetName ()

ส่งคืนชื่อที่สมบูรณ์ของบิลด์ที่กำลังทดสอบ

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

การส่งคืน
String

รับDeviceSerial

public abstract String getDeviceSerial ()

การส่งคืน
String	อนุกรม ITestDevice ที่บิลด์นี้ถูกดำเนินการ ส่งคืน null หากไม่มีอุปกรณ์เชื่อมโยงกับโครงสร้างนี้

getFile.getFile

public abstract File getFile (String name)

วิธีการช่วยเหลือในการดึงไฟล์ที่มีชื่อที่กำหนด

การส่งคืน
File	ไฟล์ภาพหรือ null หากไม่พบ

getFile.getFile

public File getFile (BuildInfoKey.BuildInfoFileKey key)

วิธีการช่วยเหลือในการดึงไฟล์ด้วย BuildInfoFileKey ที่กำหนด

พารามิเตอร์
key	BuildInfoKey.BuildInfoFileKey : BuildInfoFileKey ที่ถูกร้องขอ

การส่งคืน
File	ไฟล์ภาพหรือ null หากไม่พบ

รับไฟล์

public abstract  getFiles ()

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

การส่งคืน

รับคุณสมบัติ

public abstract  getProperties ()

ส่งกลับสำเนาของคุณสมบัติที่ตั้งค่าไว้ใน IBuildInfo ในปัจจุบัน

การส่งคืน

getRemoteFiles

public  getRemoteFiles ()

รับเส้นทางสำหรับการสร้างสิ่งประดิษฐ์ที่ล่าช้าในการดาวน์โหลด

การส่งคืน

รับTestTag

public abstract String getTestTag ()

ส่งกลับชื่อเฉพาะสำหรับการทดสอบที่กำลังดำเนินการอยู่

การส่งคืน
String

รับเวอร์ชัน

public String getVersion (BuildInfoKey.BuildInfoFileKey key)

วิธีการช่วยเหลือในการดึงข้อมูลเวอร์ชันไฟล์โดยกำหนด BuildInfoFileKey

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

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

รับเวอร์ชัน

public abstract String getVersion (String name)

วิธีการช่วยเหลือในการดึงข้อมูลเวอร์ชันของไฟล์ที่มีชื่อที่กำหนด

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

getVersionedFile.getVersionedFile

public VersionedFile getVersionedFile (BuildInfoKey.BuildInfoFileKey key)

วิธีการช่วยเหลือในการดึง VersionedFile ด้วย BuildInfoFileKey ที่กำหนด

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

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

getVersionedFile.getVersionedFile

public VersionedFile getVersionedFile (String name)

วิธีการช่วยเหลือในการดึงข้อมูล VersionedFile ด้วยชื่อที่กำหนด

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

getVersionedFileKeys.getVersionedFileKeys

public  getVersionedFileKeys ()

ส่งคืนชุดคีย์ที่พร้อมใช้งานสำหรับการสืบค้น VersionedFile ผ่าน getFile(BuildInfoFileKey)

การส่งคืน

getVersionedFiles.getVersionedFiles

public  getVersionedFiles (BuildInfoKey.BuildInfoFileKey key)

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

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

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

ลบBuildAttribute

public void removeBuildAttribute (String attributeName)

ลบชื่อแอตทริบิวต์ที่กำหนดออกจากการติดตาม

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

setBuildBranch

public abstract void setBuildBranch (String branch)

ตั้งค่าสาขาการสร้าง

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

ตั้งค่า BuildFlavour

public abstract void setBuildFlavor (String buildFlavor)

กำหนดรสชาติการสร้าง

setBuildId

public abstract void setBuildId (String buildId)

ตั้งค่าตัวระบุเฉพาะของบิลด์ที่อยู่ระหว่างการทดสอบ ไม่ควรจะเป็นโมฆะ

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

ตั้งค่า DeviceSerial

public abstract void setDeviceSerial (String serial)

ตั้งค่าอนุกรม ITestDevice ที่เกี่ยวข้องกับโครงสร้างนี้

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

setFile

public abstract 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 : เวอร์ชันของไฟล์

ตั้งค่าคุณสมบัติ

public abstract void setProperties (BuildInfoProperties... properties)

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

พารามิเตอร์
properties	BuildInfoProperties : รายการคุณสมบัติที่จะเพิ่ม

ตั้งค่าTestTag

public abstract void setTestTag (String testTag)

ตั้งชื่อเฉพาะสำหรับการทดสอบที่กำลังรัน

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

stageRemoteFile

public File stageRemoteFile (String fileName, 
                File workingDir)

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

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

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

การส่งคืน
File	อ็อบเจ็กต์ ERROR(/File) ของไฟล์ที่จัดฉากใน localworkingDir

ถึงโปรโต

public BuildInformation.BuildInfo toProto ()

ทำให้อินสแตนซ์ BuildInfo เป็นอนุกรมลงใน protobuf

การส่งคืน
BuildInformation.BuildInfo