ข้อมูลบิลด์
public
class
BuildInfo
extends Object
implements
IBuildInfo
java.lang.Object | |
↳ | com.android.tradefed.build.BuildInfo |
การใช้งานทั่วไปของ IBuildInfo
ที่ควรเชื่อมโยง
ด้วย ITestDevice
สรุป
ช่างก่อสร้างสาธารณะ | |
---|---|
BuildInfo()
สร้าง |
|
BuildInfo(String buildId, String buildTargetName)
สร้าง |
วิธีการสาธารณะ | |
---|---|
void
|
addAppPackageFile(File appPackageFile, String version)
เพิ่มไฟล์ apk ในเครื่องและเวอร์ชันที่เกี่ยวข้อง |
void
|
addBuildAttribute(String attributeName, String attributeValue)
เพิ่มแอตทริบิวต์บิลด์ |
void
|
addBuildAttributes(
เพิ่มแอตทริบิวต์ของบิลด์ |
void
|
allowStagingRemoteFile(boolean stageRemoteFile)
ตั้งค่าสิทธิ์เพื่ออนุญาตการทดลองใช้ไฟล์ระยะไกล |
void
|
cleanUp()
ล้างไฟล์บิลด์ชั่วคราว |
void
|
cleanUp(
เวอร์ชันของ |
IBuildInfo
|
clone()
|
final
void
|
copyAllFileFrom(BuildInfo build)
คัดลอก |
boolean
|
equals(Object obj)
|
static
IBuildInfo
|
fromProto(BuildInformation.BuildInfo protoBuild)
การดำเนินการผกผันกับ |
|
getAppPackageFiles()
รับสำเนาของชุดไฟล์ APK ของแอปในเครื่องและเวอร์ชัน |
|
getBuildAttributes()
รับชุดคู่ชื่อ-ค่าของแอตทริบิวต์เพิ่มเติมที่อธิบายบิลด์ |
String
|
getBuildBranch()
เมธอดที่ไม่บังคับเพื่อแสดงผล Branch ของการควบคุมต้นทางที่บิลด์ที่กำลังทดสอบคือ ผลิตขึ้นจากที่ไหน |
String
|
getBuildFlavor()
เมธอดที่ไม่บังคับเพื่อแสดงผลประเภทของบิลด์ที่กำลังทดสอบ |
String
|
getBuildId()
แสดงผลตัวระบุที่ไม่ซ้ำกันของบิลด์ภายใต้การทดสอบ |
String
|
getBuildTargetName()
แสดงผลชื่อเต็มของบิลด์ที่กำลังทดสอบ |
String
|
getDeviceSerial()
|
File
|
getFile(String name)
เมธอด Helper ในการเรียกไฟล์ที่มีชื่อตัวหนึ่ง |
File
|
getFile(BuildInfoKey.BuildInfoFileKey key)
เมธอดของ Helper ในการเรียกไฟล์ด้วย |
|
getFiles()
แสดง |
|
getProperties()
แสดงผลสำเนาของพร็อพเพอร์ตี้ที่ตั้งค่าไว้ใน |
|
getRemoteFiles()
รับเส้นทางสำหรับอาร์ติแฟกต์ของบิลด์ที่การดาวน์โหลดล่าช้า |
String
|
getTestTag()
แสดงชื่อที่ไม่ซ้ำกันสำหรับการทดสอบที่ดำเนินอยู่ |
String
|
getVersion(BuildInfoKey.BuildInfoFileKey key)
เมธอด Helper ในการเรียกเวอร์ชันของไฟล์ด้วย |
String
|
getVersion(String name)
เมธอด Helper ในการเรียกเวอร์ชันของไฟล์ที่มีชื่อตัวหนึ่ง |
VersionedFile
|
getVersionedFile(BuildInfoKey.BuildInfoFileKey key)
เมธอดของตัวช่วยในการเรียก |
final
VersionedFile
|
getVersionedFile(String name)
เมธอดของ Helper ในการดึงข้อมูล |
|
getVersionedFileKeys()
แสดงผลชุดคีย์ที่พร้อมใช้งานสำหรับการค้นหา |
final
|
getVersionedFiles(BuildInfoKey.BuildInfoFileKey key)
เมธอดของตัวช่วยในการเรียกดูรายการ |
int
|
hashCode()
|
void
|
removeBuildAttribute(String attributeName)
นำattributeName ที่ระบุออกจากการติดตาม |
void
|
setBuildBranch(String branch)
ตั้งค่า Branch ของบิลด์ |
void
|
setBuildFlavor(String buildFlavor)
กำหนดเวอร์ชันบิลด์ |
void
|
setBuildId(String buildId)
ตั้งค่าตัวระบุที่ไม่ซ้ำของบิลด์ภายใต้การทดสอบ |
void
|
setDeviceSerial(String serial)
ตั้งค่าอนุกรม |
void
|
setFile(String name, File file, String version)
จัดเก็บไฟล์ที่มีชื่อที่ระบุในข้อมูลบิลด์นี้ |
void
|
setFile(BuildInfoKey.BuildInfoFileKey key, File file, String version)
จัดเก็บไฟล์ที่ระบุ |
void
|
setProperties(BuildInfoProperties... properties)
ตั้งค่า |
void
|
setTestTag(String testTag)
ตั้งชื่อที่ไม่ซ้ำสำหรับการทดสอบที่ดำเนินอยู่ |
File
|
stageRemoteFile(String fileName, File workingDir)
จัดเตรียมไฟล์ที่เป็นส่วนหนึ่งของไฟล์ระยะไกลในไดเรกทอรีรากของข้อมูลบิลด์ |
BuildInformation.BuildInfo
|
toProto()
ทำให้อินสแตนซ์ BuildInfo เป็นอนุกรมเป็น Protobuf |
String
|
toString()
|
วิธีการป้องกัน | |
---|---|
void
|
addAllBuildAttributes(BuildInfo build)
เมธอดของตัวช่วยในการคัดลอกแอตทริบิวต์ของบิลด์ สาขา และเวอร์ชันจากบิลด์อื่น |
void
|
addAllFiles(BuildInfo build)
วิธีของตัวช่วยในการคัดลอกไฟล์ทั้งหมดจากบิลด์อื่น |
boolean
|
applyBuildProperties(VersionedFile origFileConsidered, IBuildInfo build, IBuildInfo receiver)
อนุญาตให้ใช้ |
MultiMap<String, String>
|
getAttributesMultiMap()
|
|
getVersionedFileMap()
|
MultiMap<String, VersionedFile>
|
getVersionedFileMapFull()
|
ช่างก่อสร้างสาธารณะ
ข้อมูลบิลด์
public BuildInfo (String buildId, String buildTargetName)
สร้าง BuildInfo
พารามิเตอร์ | |
---|---|
buildId |
String : รหัสบิลด์ |
buildTargetName |
String : ชื่อเป้าหมายของบิลด์ |
วิธีการสาธารณะ
เพิ่มAppPackageFile
public void addAppPackageFile (File appPackageFile, String version)
เพิ่มไฟล์ apk ในเครื่องและเวอร์ชันที่เกี่ยวข้อง โปรดทราบว่า apk จะถูกส่งคืนจาก
getAppPackageFiles()
ในลำดับที่เพิ่มโดยวิธีนี้
พารามิเตอร์ | |
---|---|
appPackageFile |
File |
version |
String |
addBuildAttribute
public void addBuildAttribute (String attributeName, String attributeValue)
เพิ่มแอตทริบิวต์บิลด์ ไม่อนุญาตให้ลบล้างค่าแอตทริบิวต์ที่มีอยู่
พารามิเตอร์ | |
---|---|
attributeName |
String : ชื่อแอตทริบิวต์ที่ไม่ซ้ำกัน |
attributeValue |
String : ค่าแอตทริบิวต์ |
addBuildAttributes
public void addBuildAttributes (buildAttributes)
เพิ่มแอตทริบิวต์ของบิลด์
พารามิเตอร์ | |
---|---|
buildAttributes |
: แมปแอตทริบิวต์ที่จะเพิ่ม |
AllowStagingRemoteFile
public void allowStagingRemoteFile (boolean stageRemoteFile)
ตั้งค่าสิทธิ์เพื่ออนุญาตการทดลองใช้ไฟล์ระยะไกล
พารามิเตอร์ | |
---|---|
stageRemoteFile |
boolean |
ล้าง
public void cleanUp ()
ล้างไฟล์บิลด์ชั่วคราว
ล้าง
public void cleanUp (doNotClean)
เวอร์ชันของ cleanUp()
ที่ไม่มีการลบไฟล์บางไฟล์
พารามิเตอร์ | |
---|---|
doNotClean |
|
CopyAllFileFrom
public final void copyAllFileFrom (BuildInfo build)
คัดลอก VersionedFile
ทั้งหมดจากบิลด์ที่กำหนดไปยังบิลด์นี้
พารามิเตอร์ | |
---|---|
build |
BuildInfo |
เท่ากับ
public boolean equals (Object obj)
พารามิเตอร์ | |
---|---|
obj |
Object |
คิกรีเทิร์น | |
---|---|
boolean |
จากโปรโตคอล
public static IBuildInfo fromProto (BuildInformation.BuildInfo protoBuild)
การดำเนินการผกผันกับ toProto()
เพื่อรับอินสแตนซ์คืน
พารามิเตอร์ | |
---|---|
protoBuild |
BuildInformation.BuildInfo |
คิกรีเทิร์น | |
---|---|
IBuildInfo |
getAppPackageFiles
publicgetAppPackageFiles ()
รับสำเนาของชุดไฟล์ APK ของแอปในเครื่องและเวอร์ชัน คำสั่งซื้อที่ส่งคืน
ตรงกับลำดับที่เพิ่ม apk ใน IAppBuildInfo
คิกรีเทิร์น | |
---|---|
|
getBuildAttributes
publicgetBuildAttributes ()
รับชุดคู่ชื่อ-ค่าของแอตทริบิวต์เพิ่มเติมที่อธิบายบิลด์
คิกรีเทิร์น | |
---|---|
|
ERROR(/Map) ของแอตทริบิวต์บิลด์ ค่าจะไม่เป็น null แต่อาจว่างเปล่า |
getBuildBranch
public String getBuildBranch ()
เมธอดที่ไม่บังคับเพื่อแสดงผล Branch ของการควบคุมต้นทางที่บิลด์ที่กำลังทดสอบคือ ผลิตขึ้นจากที่ไหน
คิกรีเทิร์น | |
---|---|
String |
สาขาของบิลด์หรือ null หากไม่ได้ตั้งค่า/ไม่เกี่ยวข้อง |
getBuildFlavor
public String getBuildFlavor ()
เมธอดที่ไม่บังคับเพื่อแสดงผลประเภทของบิลด์ที่กำลังทดสอบ
การใช้งานทั่วไปสำหรับบิลด์แพลตฟอร์ม Android คือการส่งคืน (ผลิตภัณฑ์รุ่น)-(ระบบปฏิบัติการของบิลด์)-(สร้างตัวแปร) เช่น ทั่วไป-linux-userdebug
คิกรีเทิร์น | |
---|---|
String |
เวอร์ชันของบิลด์หรือ null หากไม่ได้ตั้งค่า/ไม่เกี่ยวข้อง |
getBuildId
public String getBuildId ()
แสดงผลตัวระบุที่ไม่ซ้ำกันของบิลด์ภายใต้การทดสอบ ไม่ควรเป็นค่าว่าง ค่าเริ่มต้นคือ UNKNOWN_BUILD_ID
คิกรีเทิร์น | |
---|---|
String |
ชื่อเป้าหมายสำหรับสร้างบิลด์
public String getBuildTargetName ()
แสดงผลชื่อเต็มของบิลด์ที่กำลังทดสอบ
การใช้งานทั่วไปคือการสร้างชื่อเป้าหมายของบิลด์จากชุดค่าผสมของ เวอร์ชันของบิลด์และชื่อ Branch [เช่น (ชื่อสาขา)-(เวอร์ชันบิลด์)]
คิกรีเทิร์น | |
---|---|
String |
รับซีเรียลของอุปกรณ์
public String getDeviceSerial ()
คิกรีเทิร์น | |
---|---|
String |
getFile
public File getFile (String name)
เมธอด Helper ในการเรียกไฟล์ที่มีชื่อตัวหนึ่ง
คิกรีเทิร์น | |
---|---|
File |
ไฟล์ภาพหรือ null หากไม่พบ |
getFile
public File getFile (BuildInfoKey.BuildInfoFileKey key)
เมธอดของ Helper ในการเรียกไฟล์ด้วย BuildInfoFileKey
ที่ระบุ
พารามิเตอร์ | |
---|---|
key |
BuildInfoKey.BuildInfoFileKey : BuildInfoFileKey ที่ขอ |
คิกรีเทิร์น | |
---|---|
File |
ไฟล์ภาพหรือ null หากไม่พบ |
getProperties
publicgetProperties ()
แสดงผลสำเนาของพร็อพเพอร์ตี้ที่ตั้งค่าไว้ใน IBuildInfo
คิกรีเทิร์น | |
---|---|
|
getRemoteFiles
publicgetRemoteFiles ()
รับเส้นทางสำหรับอาร์ติแฟกต์ของบิลด์ที่การดาวน์โหลดล่าช้า
คิกรีเทิร์น | |
---|---|
|
getTestTag
public String getTestTag ()
แสดงชื่อที่ไม่ซ้ำกันสำหรับการทดสอบที่ดำเนินอยู่
คิกรีเทิร์น | |
---|---|
String |
getVersion
public String getVersion (BuildInfoKey.BuildInfoFileKey key)
เมธอด Helper ในการเรียกเวอร์ชันของไฟล์ด้วย BuildInfoFileKey
พารามิเตอร์ | |
---|---|
key |
BuildInfoKey.BuildInfoFileKey : BuildInfoFileKey ส่งคำขอแล้ว |
คิกรีเทิร์น | |
---|---|
String |
เวอร์ชันอิมเมจหรือ null หากไม่พบ |
getVersion
public String getVersion (String name)
เมธอด Helper ในการเรียกเวอร์ชันของไฟล์ที่มีชื่อตัวหนึ่ง
คิกรีเทิร์น | |
---|---|
String |
เวอร์ชันอิมเมจหรือ null หากไม่พบ |
getVersionedFile
public VersionedFile getVersionedFile (BuildInfoKey.BuildInfoFileKey key)
เมธอดของตัวช่วยในการเรียก VersionedFile
ด้วย BuildInfoFileKey
ที่ระบุ
พารามิเตอร์ | |
---|---|
key |
BuildInfoKey.BuildInfoFileKey : BuildInfoFileKey ส่งคำขอแล้ว |
คิกรีเทิร์น | |
---|---|
VersionedFile |
ไฟล์ที่มีเวอร์ชันหรือ null หากไม่พบ |
getVersionedFile
public final VersionedFile getVersionedFile (String name)
เมธอดของ Helper ในการดึงข้อมูล VersionedFile
ด้วยชื่อหนึ่งๆ
คิกรีเทิร์น | |
---|---|
VersionedFile |
ไฟล์ที่มีเวอร์ชันหรือ null หากไม่พบ |
getVersionedFileKeys
publicgetVersionedFileKeys ()
แสดงผลชุดคีย์ที่พร้อมใช้งานสำหรับการค้นหา VersionedFile
ผ่าน getFile(BuildInfoFileKey)
คิกรีเทิร์น | |
---|---|
|
getVersionedFiles
public finalgetVersionedFiles (BuildInfoKey.BuildInfoFileKey key)
เมธอดของตัวช่วยในการเรียกดูรายการ VersionedFile
ที่เชื่อมโยงกับ BuildInfoFileKey
ที่ระบุ หากคีย์อนุญาตให้จัดเก็บรายการ
พารามิเตอร์ | |
---|---|
key |
BuildInfoKey.BuildInfoFileKey : BuildInfoFileKey ส่งคำขอแล้ว |
คิกรีเทิร์น | |
---|---|
|
ไฟล์ที่มีเวอร์ชันหรือ null หากไม่พบ |
แฮชโค้ด
public int hashCode ()
คิกรีเทิร์น | |
---|---|
int |
removeBuildAttribute
public void removeBuildAttribute (String attributeName)
นำattributeName ที่ระบุออกจากการติดตาม
พารามิเตอร์ | |
---|---|
attributeName |
String : แอตทริบิวต์ที่จะหยุดการติดตาม |
setBuildBranch
public void setBuildBranch (String branch)
ตั้งค่า Branch ของบิลด์
พารามิเตอร์ | |
---|---|
branch |
String : ชื่อสาขา |
ตั้งค่า BuildFlavor
public void setBuildFlavor (String buildFlavor)
กำหนดเวอร์ชันบิลด์
รหัส setBuildId
public void setBuildId (String buildId)
ตั้งค่าตัวระบุที่ไม่ซ้ำของบิลด์ภายใต้การทดสอบ ไม่ควรเป็นค่าว่าง
พารามิเตอร์ | |
---|---|
buildId |
String |
ตั้งค่าซีเรียลของอุปกรณ์
public void setDeviceSerial (String serial)
ตั้งค่าอนุกรม ITestDevice
ที่เชื่อมโยงกับบิลด์นี้
พารามิเตอร์ | |
---|---|
serial |
String : หมายเลขซีเรียลของ ITestDevice ที่มีการดำเนินการบิลด์นี้ |
ตั้งค่าไฟล์
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 : เวอร์ชันของไฟล์ |
ตั้งค่าพร็อพเพอร์ตี้
public void setProperties (BuildInfoProperties... properties)
ตั้งค่า BuildInfoProperties
สำหรับอินสแตนซ์ IBuildInfo
ลบล้างค่าใดก็ได้
ที่มีอยู่ก่อนหน้านี้
พารามิเตอร์ | |
---|---|
properties |
BuildInfoProperties : รายการที่พักที่จะเพิ่ม |
setTestTag
public void setTestTag (String testTag)
ตั้งชื่อที่ไม่ซ้ำสำหรับการทดสอบที่ดำเนินอยู่
พารามิเตอร์ | |
---|---|
testTag |
String |
ไฟล์ระยะไกลของขั้นตอน
public File stageRemoteFile (String fileName, File workingDir)
จัดเตรียมไฟล์ที่เป็นส่วนหนึ่งของไฟล์ระยะไกลในไดเรกทอรีรากของข้อมูลบิลด์
TODO(b/138416078): ลบอินเทอร์เฟซนี้และผู้โทรเมื่อการทดสอบจำเป็นต้องใช้โมดูล สามารถสร้างเอาต์พุตไปยังไดเรกทอรีของโมดูลทดสอบได้อย่างเหมาะสม
พารามิเตอร์ | |
---|---|
fileName |
String : ชื่อไฟล์ที่จะอยู่ในไฟล์ระยะไกล |
workingDir |
File : ออบเจ็กต์ ERROR(/File) ของไดเรกทอรีเพื่อแสดงไฟล์ |
คิกรีเทิร์น | |
---|---|
File |
ออบเจ็กต์ ERROR(/File) ของไฟล์ที่จัดเตรียมไว้ใน WorkDir ในเครื่อง |
เป็นโปรโตคอล
public BuildInformation.BuildInfo toProto ()
ทำให้อินสแตนซ์ BuildInfo เป็นอนุกรมเป็น Protobuf
คิกรีเทิร์น | |
---|---|
BuildInformation.BuildInfo |
toString
public String toString ()
คิกรีเทิร์น | |
---|---|
String |
วิธีการป้องกัน
addAllBuildAttributes
protected void addAllBuildAttributes (BuildInfo build)
เมธอดของตัวช่วยในการคัดลอกแอตทริบิวต์ของบิลด์ สาขา และเวอร์ชันจากบิลด์อื่น
พารามิเตอร์ | |
---|---|
build |
BuildInfo |
addAllFiles
protected void addAllFiles (BuildInfo build)
วิธีของตัวช่วยในการคัดลอกไฟล์ทั้งหมดจากบิลด์อื่น
สร้างลิงก์ถาวรใหม่ไปยังไฟล์เพื่อให้แต่ละบิลด์มีเส้นทางไฟล์ที่ไม่ซ้ำกันไปยังไฟล์
พารามิเตอร์ | |
---|---|
build |
BuildInfo |
การขว้าง | |
---|---|
|
มีข้อยกเว้นเมื่อสร้างฮาร์ดลิงก์ |
UseBuildProperties
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
protectedgetVersionedFileMap ()
คิกรีเทิร์น | |
---|---|
|
getVersionedFileMapFull
protected MultiMap<String, VersionedFile> getVersionedFileMapFull ()
คิกรีเทิร์น | |
---|---|
MultiMap<String, VersionedFile> |