ข้อมูลบิลด์

public class BuildInfo
extends Object implements IBuildInfo

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


การใช้งานทั่วไปของ 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()

เมธอดที่ไม่บังคับเพื่อแสดงผล Branch ของการควบคุมต้นทางที่บิลด์ที่กำลังทดสอบคือ ผลิตขึ้นจากที่ไหน

String getBuildFlavor()

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

String getBuildId()

แสดงผลตัวระบุที่ไม่ซ้ำกันของบิลด์ภายใต้การทดสอบ

String getBuildTargetName()

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

String getDeviceSerial()

File getFile(String name)

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

File getFile(BuildInfoKey.BuildInfoFileKey key)

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

getFiles()

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

getProperties()

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

getRemoteFiles()

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

String getTestTag()

แสดงชื่อที่ไม่ซ้ำกันสำหรับการทดสอบที่ดำเนินอยู่

String getVersion(BuildInfoKey.BuildInfoFileKey key)

เมธอด Helper ในการเรียกเวอร์ชันของไฟล์ด้วย BuildInfoFileKey

String getVersion(String name)

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

VersionedFile getVersionedFile(BuildInfoKey.BuildInfoFileKey key)

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

final VersionedFile getVersionedFile(String name)

เมธอดของ Helper ในการดึงข้อมูล VersionedFile ด้วยชื่อหนึ่งๆ

getVersionedFileKeys()

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

final getVersionedFiles(BuildInfoKey.BuildInfoFileKey key)

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

int hashCode()

void removeBuildAttribute(String attributeName)

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

void setBuildBranch(String branch)

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

void setBuildFlavor(String buildFlavor)

กำหนดเวอร์ชันบิลด์

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)

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

void addAllFiles(BuildInfo build)

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

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

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

MultiMap<String, String> getAttributesMultiMap()
getVersionedFileMap()
MultiMap<String, VersionedFile> getVersionedFileMapFull()

ช่างก่อสร้างสาธารณะ

ข้อมูลบิลด์

public BuildInfo ()

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

ข้อมูลบิลด์

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

โคลน

public IBuildInfo clone ()

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

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

public  getAppPackageFiles ()

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

คิกรีเทิร์น

getBuildAttributes

public  getBuildAttributes ()

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

คิกรีเทิร์น
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 หากไม่พบ

getFiles

public  getFiles ()

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

คิกรีเทิร์น

getProperties

public  getProperties ()

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

คิกรีเทิร์น

getRemoteFiles

public  getRemoteFiles ()

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

คิกรีเทิร์น

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

public  getVersionedFileKeys ()

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

คิกรีเทิร์น

getVersionedFiles

public final  getVersionedFiles (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

protected  getVersionedFileMap ()

คิกรีเทิร์น

getVersionedFileMapFull

protected MultiMap<String, VersionedFile> getVersionedFileMapFull ()

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