IBuildInfo
public interface IBuildInfo
com.android.tradefed.build.IBuildInfo |
เก็บข้อมูลเกี่ยวกับการสร้างภายใต้การทดสอบ
สรุป
ค่าคงที่ | |
---|---|
String | REMOTE_FILE_PREFIX คำนำหน้าที่ใช้ในชื่อเพื่อระบุว่าไฟล์ถูกตั้งค่าให้ดาวน์โหลดล่าช้า |
String | REMOTE_FILE_VERSION ไฟล์ระยะไกลไม่ได้กำหนดเวอร์ชัน |
String | UNKNOWN_BUILD_ID ค่าเริ่มต้นเมื่อไม่ทราบ ID บิลด์ |
วิธีการสาธารณะ | |
---|---|
default void | addAppPackageFile (File appPackageFile, String version) เพิ่มไฟล์ apk ในเครื่องและเวอร์ชันที่เกี่ยวข้อง |
abstract void | addBuildAttribute (String attributeName, String attributeValue) เพิ่มแอตทริบิวต์การสร้าง |
default void | addBuildAttributes ( buildAttributes) addBuildAttributes ( buildAttributes) เพิ่มคุณสมบัติการสร้าง |
abstract void | cleanUp () ล้างไฟล์บิลด์ชั่วคราว |
abstract void | cleanUp ( doNotDelete) cleanUp ( doNotDelete) รุ่นของ |
abstract IBuildInfo | clone () โคลนวัตถุ |
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) วิธีการช่วยเหลือในการดึงไฟล์ด้วย |
abstract | getFiles () คืน |
abstract | getProperties () ส่งคืนสำเนาของคุณสมบัติที่ตั้งค่าไว้บน |
default | getRemoteFiles () รับเส้นทางสำหรับการสร้างสิ่งประดิษฐ์ที่ดาวน์โหลดล่าช้า |
abstract String | getTestTag () ส่งคืนชื่อเฉพาะสำหรับการทดสอบที่กำลังดำเนินการ |
default String | getVersion ( BuildInfoKey.BuildInfoFileKey key) เมธอด Helper เพื่อดึงเวอร์ชันไฟล์ด้วย |
abstract String | getVersion (String name) วิธีการช่วยเหลือในการเรียกรุ่นของไฟล์ที่มีชื่อที่กำหนด |
default VersionedFile | getVersionedFile ( BuildInfoKey.BuildInfoFileKey key) วิธีการช่วยเหลือเพื่อดึง |
default VersionedFile | getVersionedFile (String name) วิธีการช่วยเหลือเพื่อดึง |
default | getVersionedFileKeys () ส่งคืนชุดของคีย์ที่มีให้ค้นหา |
default | getVersionedFiles ( BuildInfoKey.BuildInfoFileKey key) เมธอด Helper เพื่อดึงรายการของ |
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) ตั้งค่าซีเรียล |
abstract void | setFile (String name, File file, String version) เก็บไฟล์ด้วยชื่อที่กำหนดในข้อมูลการสร้างนี้ |
default void | setFile ( BuildInfoKey.BuildInfoFileKey key, File file, String version) เก็บไฟล์ที่กำหนด |
abstract void | setProperties ( BuildInfoProperties... properties) ตั้งค่า |
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
ค่าเริ่มต้นเมื่อไม่ทราบ ID บิลด์
ค่าคงที่: "-1"
วิธีการสาธารณะ
เพิ่มAppPackageFile
public void addAppPackageFile (File appPackageFile, String version)
เพิ่มไฟล์ apk ในเครื่องและเวอร์ชันที่เกี่ยวข้อง โปรดทราบว่า apk จะถูกส่งคืนจาก getAppPackageFiles()
ตามลำดับที่ถูกเพิ่มด้วยวิธีนี้
พารามิเตอร์ | |
---|---|
appPackageFile | File |
version | String |
เพิ่ม BuildAttribute
public abstract void addBuildAttribute (String attributeName, String attributeValue)
เพิ่มแอตทริบิวต์การสร้าง สิ่งนี้ไม่อนุญาตให้แทนที่ชื่อแอตทริบิวต์ที่มีอยู่
พารามิเตอร์ | |
---|---|
attributeName | String : ชื่อแอตทริบิวต์เฉพาะ |
attributeValue | String : ค่าแอตทริบิวต์ |
เพิ่ม BuildAttributes
public void addBuildAttributes (buildAttributes)
เพิ่มคุณสมบัติการสร้าง
พารามิเตอร์ | |
---|---|
buildAttributes |
ทำความสะอาด
public abstract void cleanUp ()
ล้างไฟล์บิลด์ชั่วคราว
ทำความสะอาด
public abstract void cleanUp (doNotDelete)
รุ่นของ cleanUp()
ที่บางไฟล์ไม่ถูกลบ
พารามิเตอร์ | |
---|---|
doNotDelete |
getAppPackageFiles
publicgetAppPackageFiles ()
รับสำเนาของชุดไฟล์ apk ของแอปในเครื่องและเวอร์ชัน ลำดับที่ส่งคืนตรงกับลำดับที่เพิ่ม apk ลงใน IAppBuildInfo
ส่งคืน | |
---|---|
getBuildAttributes
public abstractgetBuildAttributes ()
รับคู่ชื่อ-ค่าของแอตทริบิวต์เพิ่มเติมที่อธิบายถึงงานสร้าง
ส่งคืน | |
---|---|
ERROR(/Map) ของแอตทริบิวต์บิลด์ จะไม่เป็น null แต่อาจว่างเปล่า |
getBuildBranch
public abstract String getBuildBranch ()
วิธีทางเลือกในการส่งคืนสาขาการควบคุมต้นทางที่สร้างจากบิลด์ที่กำลังทดสอบ
ส่งคืน | |
---|---|
String | สาขาบิลด์หรือ null หากไม่ได้ตั้งค่า/ไม่เกี่ยวข้อง |
getBuildFlavor
public abstract String getBuildFlavor ()
วิธีทางเลือกในการส่งคืนประเภทของบิลด์ที่กำลังทดสอบ
การใช้งานทั่วไปสำหรับรุ่นแพลตฟอร์ม Android คือการส่งคืน (ผลิตภัณฑ์รุ่น)-(รุ่นระบบปฏิบัติการ)-(รุ่นรุ่นบิลด์) เช่น generic-linux-userdebugส่งคืน | |
---|---|
String | สร้างรสชาติหรือ null หากไม่ได้ตั้งค่า/ไม่เกี่ยวข้อง |
getBuildId
public abstract String getBuildId ()
ส่งกลับตัวระบุเฉพาะของการสร้างภายใต้การทดสอบ ไม่ควรเป็นโมฆะ ค่าเริ่มต้นคือ UNKNOWN_BUILD_ID
ส่งคืน | |
---|---|
String |
getBuildTargetName
public abstract String getBuildTargetName ()
ส่งคืนชื่อที่สมบูรณ์สำหรับบิลด์ที่กำลังทดสอบ
การใช้งานทั่วไปคือการสร้างชื่อเป้าหมายของบิลด์จากส่วนผสมของกลิ่นบิลด์และชื่อสาขา [เช่น (ชื่อสาขา)-(สร้างรสชาติ)]ส่งคืน | |
---|---|
String |
getDeviceSerial
public abstract String getDeviceSerial ()
ส่งคืน | |
---|---|
String | อนุกรม ITestDevice ที่บิลด์นี้ดำเนินการอยู่ คืนค่า null หากไม่มีอุปกรณ์ใดเชื่อมโยงกับบิลด์นี้ |
รับไฟล์
public abstract File getFile (String name)
วิธีการช่วยเหลือในการดึงไฟล์ที่มีชื่อที่กำหนด
ส่งคืน | |
---|---|
File | ไฟล์รูปภาพหรือ null หากไม่พบ |
รับไฟล์
public File getFile (BuildInfoKey.BuildInfoFileKey key)
วิธีการช่วยเหลือในการดึงไฟล์ด้วย BuildInfoFileKey
ที่กำหนด
พารามิเตอร์ | |
---|---|
key | BuildInfoKey.BuildInfoFileKey : BuildInfoFileKey ที่ร้องขอ |
ส่งคืน | |
---|---|
File | ไฟล์รูปภาพหรือ null หากไม่พบ |
รับคุณสมบัติ
public abstractgetProperties ()
ส่งคืนสำเนาของคุณสมบัติที่ตั้งค่าไว้บน IBuildInfo
ในปัจจุบัน
ส่งคืน | |
---|---|
รับไฟล์ระยะไกล
publicgetRemoteFiles ()
รับเส้นทางสำหรับการสร้างสิ่งประดิษฐ์ที่ดาวน์โหลดล่าช้า
ส่งคืน | |
---|---|
รับTestTag
public abstract String getTestTag ()
ส่งคืนชื่อเฉพาะสำหรับการทดสอบที่กำลังดำเนินการ
ส่งคืน | |
---|---|
String |
รับเวอร์ชัน
public String getVersion (BuildInfoKey.BuildInfoFileKey key)
เมธอด Helper เพื่อดึงเวอร์ชันไฟล์ด้วย BuildInfoFileKey
ที่กำหนด
พารามิเตอร์ | |
---|---|
key | BuildInfoKey.BuildInfoFileKey : BuildInfoFileKey ที่ร้องขอ |
ส่งคืน | |
---|---|
String | เวอร์ชันอิมเมจหรือ null หากไม่พบ |
รับเวอร์ชัน
public abstract String getVersion (String name)
วิธีการช่วยเหลือในการเรียกรุ่นของไฟล์ที่มีชื่อที่กำหนด
ส่งคืน | |
---|---|
String | เวอร์ชันอิมเมจหรือ null หากไม่พบ |
getVersionedFile
public VersionedFile getVersionedFile (BuildInfoKey.BuildInfoFileKey key)
วิธีการช่วยเหลือเพื่อดึง VersionedFile
ด้วย BuildInfoFileKey
ที่กำหนด
พารามิเตอร์ | |
---|---|
key | BuildInfoKey.BuildInfoFileKey : BuildInfoFileKey ที่ร้องขอ |
ส่งคืน | |
---|---|
VersionedFile | ไฟล์เวอร์ชันหรือ null หากไม่พบ |
getVersionedFile
public VersionedFile getVersionedFile (String name)
วิธีการช่วยเหลือเพื่อดึง VersionedFile
ด้วยชื่อที่กำหนด
ส่งคืน | |
---|---|
VersionedFile | ไฟล์เวอร์ชันหรือ null หากไม่พบ |
getVersionedFileKeys
publicgetVersionedFileKeys ()
ส่งคืนชุดของคีย์ที่มีให้ค้นหา VersionedFile
ผ่าน getFile(BuildInfoFileKey)
ส่งคืน | |
---|---|
รับไฟล์เวอร์ชัน
publicgetVersionedFiles (BuildInfoKey.BuildInfoFileKey key)
เมธอด Helper เพื่อดึงรายการของ VersionedFile
ที่เชื่อมโยงกับ BuildInfoFileKey
ที่กำหนด หากคีย์อนุญาตให้จัดเก็บรายการ
พารามิเตอร์ | |
---|---|
key | BuildInfoKey.BuildInfoFileKey : BuildInfoFileKey ที่ร้องขอ |
ส่งคืน | |
---|---|
ไฟล์เวอร์ชันหรือ null หากไม่พบ |
ลบ BuildAttribute
public void removeBuildAttribute (String attributeName)
ลบชื่อแอตทริบิวต์ที่ระบุออกจากการติดตาม
พารามิเตอร์ | |
---|---|
attributeName | String : คุณลักษณะที่จะหยุดการติดตาม |
setBuildBranch
public abstract void setBuildBranch (String branch)
ตั้งค่าสาขาการสร้าง
พารามิเตอร์ | |
---|---|
branch | String : ชื่อสาขา |
setBuildFlavor
public abstract void setBuildFlavor (String buildFlavor)
กำหนดรสชาติของบิลด์
setBuildId
public abstract void setBuildId (String buildId)
ตั้งค่าตัวระบุเฉพาะของบิลด์ภายใต้การทดสอบ ไม่ควรเป็นโมฆะ
พารามิเตอร์ | |
---|---|
buildId | String |
setDeviceSerial
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 : เวอร์ชันของไฟล์ |
setProperties
public abstract void setProperties (BuildInfoProperties... properties)
ตั้งค่า BuildInfoProperties
สำหรับอินสแตนซ์ IBuildInfo
แทนที่คุณสมบัติที่มีอยู่ที่ตั้งค่าไว้ก่อนหน้านี้
พารามิเตอร์ | |
---|---|
properties | BuildInfoProperties : รายการคุณสมบัติที่จะเพิ่ม |
setTestTag
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) ของไฟล์ที่จัดฉากใน workingDir ภายในเครื่อง |
เพื่อโปรโต
public BuildInformation.BuildInfo toProto ()
ทำให้อินสแตนซ์ BuildInfo เป็นอนุกรมเป็น protobuf
ส่งคืน | |
---|---|
BuildInformation.BuildInfo |