IBuildInfo

public interface IBuildInfo

com.android.tradefed.build.IBuildInfo

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

สรุป

ค่าคงที่

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)

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

default void allowStagingRemoteFile(boolean stageRemoteFile)

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

abstract void cleanUp()

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

abstract void 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)

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

abstract void setBuildBranch(String branch)

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

abstract void setBuildFlavor(String buildFlavor)

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

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)

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

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 ในเครื่องและเวอร์ชันที่เกี่ยวข้อง โปรดทราบว่าระบบจะแสดงผล APK จาก getAppPackageFiles() ตามลำดับที่เพิ่มด้วยวิธีนี้

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

version String

addBuildAttribute

public abstract void addBuildAttribute (String attributeName, 
                String attributeValue)

เพิ่มแอตทริบิวต์บิลด์ ซึ่งไม่อนุญาตให้ลบล้างattributeName ที่มีอยู่

พารามิเตอร์
attributeName String: ชื่อแอตทริบิวต์ที่ไม่ซ้ำ
attributeValue String: ค่าแอตทริบิวต์

addBuildAttributes

public void addBuildAttributes ( buildAttributes)

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

พารามิเตอร์
buildAttributes : แมปแอตทริบิวต์ที่จะเพิ่ม

allowStagingRemoteFile

public void allowStagingRemoteFile (boolean stageRemoteFile)

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

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

cleanUp

public abstract void cleanUp ()

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

cleanUp

public abstract void cleanUp ( doNotDelete)

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

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

โคลน

public abstract IBuildInfo clone ()

โคลนออบเจ็กต์ IBuildInfo

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

getAppPackageFiles

public  getAppPackageFiles ()

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

คิกรีเทิร์น

getBuildAttributes

public abstract  getBuildAttributes ()

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

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

getBuildBranch

public abstract String getBuildBranch ()

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

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

getBuildFlavor

public abstract String getBuildFlavor ()

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

การใช้งานทั่วไปสำหรับบิลด์แพลตฟอร์ม Android คือการคืนค่า (build product)-(build os)-(build variant) ie generic-linux-userdebug

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

getBuildId

public abstract String getBuildId ()

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

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

getBuildTargetName

public abstract String getBuildTargetName ()

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

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

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

getDeviceSerial

public abstract String getDeviceSerial ()

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

getFile

public abstract File getFile (String name)

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

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

getFile

public File getFile (BuildInfoKey.BuildInfoFileKey key)

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

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

getFiles

public abstract  getFiles ()

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

คิกรีเทิร์น

getProperties

public abstract  getProperties ()

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

คิกรีเทิร์น

getRemoteFiles

public  getRemoteFiles ()

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

คิกรีเทิร์น

getTestTag

public abstract String getTestTag ()

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

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

getVersion

public String getVersion (BuildInfoKey.BuildInfoFileKey key)

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

พารามิเตอร์
key BuildInfoKey.BuildInfoFileKey: BuildInfoFileKey ที่ขอ
คิกรีเทิร์น
String เวอร์ชันรูปภาพหรือ null หากไม่พบ

getVersion

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

public  getVersionedFileKeys ()

แสดงชุดคีย์ที่ใช้ค้นหา VersionedFile ผ่าน getFile(BuildInfoFileKey) ได้

คิกรีเทิร์น

getVersionedFiles

public  getVersionedFiles (BuildInfoKey.BuildInfoFileKey key)

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

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

removeBuildAttribute

public void removeBuildAttribute (String attributeName)

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

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

setBuildBranch

public abstract void setBuildBranch (String branch)

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

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

setBuildFlavor

public abstract void setBuildFlavor (String buildFlavor)

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

setBuildId

public abstract void setBuildId (String buildId)

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

พารามิเตอร์
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)

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

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

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

toProto

public BuildInformation.BuildInfo toProto ()

แปลงอินสแตนซ์ BuildInfo เป็น protobuf

คิกรีเทิร์น
BuildInformation.BuildInfo