BuildInfo

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(Map<String, String> buildAttributes)

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

void allowStagingRemoteFile(boolean stageRemoteFile)

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

void cleanUp()

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

void cleanUp(List<File> doNotClean)

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

IBuildInfo clone()

final void copyAllFileFrom(BuildInfo build)

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

boolean equals(Object obj)

static IBuildInfo fromProto(BuildInformation.BuildInfo protoBuild)

การดำเนินการผกผันกับ toProto() เพื่อนำอินสแตนซ์กลับมา

List<VersionedFile> getAppPackageFiles()

รับสำเนาชุดไฟล์ APK ของแอปในเครื่องและเวอร์ชันของไฟล์

Map<String, String> getBuildAttributes()

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

String getBuildBranch()

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

String getBuildFlavor()

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

String getBuildId()

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

String getBuildTargetName()

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

String getDeviceSerial()

File getFile(String name)

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

File getFile(BuildInfoKey.BuildInfoFileKey key)

เมธอด Helper เพื่อดึงข้อมูลไฟล์ด้วย BuildInfoFileKey ที่ระบุ

Collection<VersionedFile> getFiles()

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

Set<IBuildInfo.BuildInfoProperties> getProperties()

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

Set<File> getRemoteFiles()

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

String getTestTag()

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

String getVersion(BuildInfoKey.BuildInfoFileKey key)

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

String getVersion(String name)

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

VersionedFile getVersionedFile(BuildInfoKey.BuildInfoFileKey key)

เมธอด Helper เพื่อดึงข้อมูล VersionedFile ที่มี BuildInfoFileKey ที่ระบุ

final VersionedFile getVersionedFile(String name)

เมธอดช่วยในการเรียก VersionedFile ที่มีชื่อที่ระบุ

Set<String> getVersionedFileKeys()

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

final List<VersionedFile> getVersionedFiles(BuildInfoKey.BuildInfoFileKey key)

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

int hashCode()

void removeBuildAttribute(String attributeName)

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

void setBuildBranch(String branch)

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

void setBuildFlavor(String buildFlavor)

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

void setBuildId(String buildId)

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

void setDeviceSerial(String serial)

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

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

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

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

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

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)

เมธอด Helper สำหรับคัดลอกแอตทริบิวต์บิลด์ Branch และเวอร์ชันจากการสร้างอื่น

void addAllFiles(BuildInfo build)

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

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

อนุญาตให้ใช้IBuildInfo.BuildInfoProperties บางรายการและอาจมีการจัดการที่แตกต่างกัน

MultiMap<String, String> getAttributesMultiMap()
Map<String, VersionedFile> 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 (Map<String, String> buildAttributes)

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

พารามิเตอร์
buildAttributes Map: แผนที่ของแอตทริบิวต์ที่จะเพิ่ม

allowStagingRemoteFile

public void allowStagingRemoteFile (boolean stageRemoteFile)

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

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

cleanUp

public void cleanUp ()

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

cleanUp

public void cleanUp (List<File> doNotClean)

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

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

โคลน

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 List<VersionedFile> getAppPackageFiles ()

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

การคืนสินค้า
List<VersionedFile>

getBuildAttributes

public Map<String, String> getBuildAttributes ()

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

การคืนสินค้า
Map<String, String> Map ของแอตทริบิวต์บิลด์ จะไม่ใช่ null แต่อาจเป็นค่าว่าง

getBuildBranch

public String getBuildBranch ()

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

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

getBuildFlavor

public String getBuildFlavor ()

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

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

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

getBuildId

public String getBuildId ()

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

การคืนสินค้า
String

getBuildTargetName

public String getBuildTargetName ()

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

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

การคืนสินค้า
String

getDeviceSerial

public String getDeviceSerial ()

การคืนสินค้า
String

getFile

public File getFile (String name)

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

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

getFile

public File getFile (BuildInfoKey.BuildInfoFileKey key)

เมธอด Helper เพื่อดึงข้อมูลไฟล์ด้วย BuildInfoFileKey ที่ระบุ

พารามิเตอร์
key BuildInfoKey.BuildInfoFileKey: BuildInfoFileKey ที่ขอ
การคืนสินค้า
File ไฟล์รูปภาพหรือ null หากไม่พบ

getFiles

public Collection<VersionedFile> getFiles ()

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

การคืนสินค้า
Collection<VersionedFile>

getProperties

public Set<IBuildInfo.BuildInfoProperties> getProperties ()

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

การคืนสินค้า
Set<IBuildInfo.BuildInfoProperties>

getRemoteFiles

public Set<File> getRemoteFiles ()

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

การคืนสินค้า
Set<File>

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)

เมธอด Helper เพื่อดึงข้อมูล VersionedFile ที่มี BuildInfoFileKey ที่ระบุ

พารามิเตอร์
key BuildInfoKey.BuildInfoFileKey: BuildInfoFileKey ที่ขอ
การคืนสินค้า
VersionedFile ไฟล์ที่จัดเวอร์ชันหรือ null หากไม่พบ

getVersionedFile

public final VersionedFile getVersionedFile (String name)

เมธอดช่วยในการเรียก VersionedFile ที่มีชื่อที่ระบุ

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

getVersionedFileKeys

public Set<String> getVersionedFileKeys ()

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

การคืนสินค้า
Set<String>

getVersionedFiles

public final List<VersionedFile> getVersionedFiles (BuildInfoKey.BuildInfoFileKey key)

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

พารามิเตอร์
key BuildInfoKey.BuildInfoFileKey: BuildInfoFileKey ที่ขอ
การคืนสินค้า
List<VersionedFile> ไฟล์ที่จัดเวอร์ชันหรือ null หากไม่พบ

hashCode

public int hashCode ()

การคืนสินค้า
int

removeBuildAttribute

public void removeBuildAttribute (String attributeName)

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

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

setBuildBranch

public void setBuildBranch (String branch)

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

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

setBuildFlavor

public void setBuildFlavor (String buildFlavor)

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

setBuildId

public void setBuildId (String buildId)

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

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

setDeviceSerial

public void setDeviceSerial (String serial)

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

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

setFile

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

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

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

setFile

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

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

พารามิเตอร์
name String: ชื่อที่ไม่ซ้ำกันของไฟล์
file File: 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): Remove this interface and its caller when modules required by a test can be properly built output to the test module's directory itself.

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

toProto

public BuildInformation.BuildInfo toProto ()

ซีเรียลไลซ์อินสแตนซ์ BuildInfo เป็น Protobuf

การคืนสินค้า
BuildInformation.BuildInfo

toString

public String toString ()

การคืนสินค้า
String

วิธีการที่ได้รับการป้องกัน

addAllBuildAttributes

protected void addAllBuildAttributes (BuildInfo build)

เมธอด Helper สำหรับคัดลอกแอตทริบิวต์บิลด์ Branch และเวอร์ชันจากการสร้างอื่น

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

addAllFiles

protected void addAllFiles (BuildInfo build)

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

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

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

ส่ง
IOException หากระบบแสดงข้อยกเว้นเมื่อสร้างฮาร์ดลิงก์

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 Map<String, VersionedFile> getVersionedFileMap ()

การคืนสินค้า
Map<String, VersionedFile>

getVersionedFileMapFull

protected MultiMap<String, VersionedFile> getVersionedFileMapFull ()

การคืนสินค้า
MultiMap<String, VersionedFile>