ข้อมูล IBuild

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()

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

abstract String getBuildFlavor()

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

abstract String getBuildId()

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

abstract String getBuildTargetName()

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

abstract String getDeviceSerial()
abstract File getFile(String name)

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

default File getFile(BuildInfoKey.BuildInfoFileKey key)

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

abstract getFiles()

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

abstract getProperties()

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

default getRemoteFiles()

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

abstract String getTestTag()

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

default String getVersion(BuildInfoKey.BuildInfoFileKey key)

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

abstract String getVersion(String name)

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

default VersionedFile getVersionedFile(BuildInfoKey.BuildInfoFileKey key)

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

default VersionedFile getVersionedFile(String name)

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

default getVersionedFileKeys()

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

default getVersionedFiles(BuildInfoKey.BuildInfoFileKey key)

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

default void removeBuildAttribute(String attributeName)

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

abstract void setBuildBranch(String branch)

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

abstract void setBuildFlavor(String buildFlavor)

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

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_VERSION

public static final String REMOTE_FILE_VERSION

ไฟล์ระยะไกลยังไม่มีเวอร์ชัน

มูลค่าคงที่: ""

รหัสบิลด์ที่ไม่รู้จัก

public static final String UNKNOWN_BUILD_ID

ค่าเริ่มต้นเมื่อไม่รู้จักรหัสบิลด์

มูลค่าคงที่: "-1"

วิธีการสาธารณะ

เพิ่มAppPackageFile

public void addAppPackageFile (File appPackageFile, 
                String version)

เพิ่มไฟล์ apk ในเครื่องและเวอร์ชันที่เกี่ยวข้อง โปรดทราบว่า apk จะถูกส่งคืนจาก getAppPackageFiles() ในลำดับที่เพิ่มโดยวิธีนี้

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

version String

addBuildAttribute

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

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

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

getBuildFlavor

public abstract String getBuildFlavor ()

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

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

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

getBuildId

public abstract String getBuildId ()

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

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

ชื่อเป้าหมายสำหรับสร้างบิลด์

public abstract String getBuildTargetName ()

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

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

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

รับซีเรียลของอุปกรณ์

public abstract String getDeviceSerial ()

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

getFile

public abstract File getFile (String name)

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

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

getFile

public File getFile (BuildInfoKey.BuildInfoFileKey key)

เมธอดของ Helper ในการเรียกไฟล์ด้วย 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)

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

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

getVersion

public abstract String getVersion (String name)

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

คิกรีเทิร์น
String เวอร์ชันอิมเมจหรือ null หากไม่พบ

getVersionedFile

public VersionedFile getVersionedFile (BuildInfoKey.BuildInfoFileKey key)

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

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

getVersionedFile

public VersionedFile getVersionedFile (String name)

เมธอดของ Helper ในการดึงข้อมูล 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 ของบิลด์

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

ตั้งค่า BuildFlavor

public abstract void setBuildFlavor (String buildFlavor)

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

รหัส setBuildId

public abstract void setBuildId (String buildId)

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

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

ตั้งค่าซีเรียลของอุปกรณ์

public abstract void setDeviceSerial (String serial)

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

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

ตั้งค่าไฟล์

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

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

พารามิเตอร์
name String: ชื่อที่ไม่ซ้ำกันของไฟล์
file File: ERROR(/File) ในท้องที่
version String: เวอร์ชันของไฟล์

ตั้งค่าไฟล์

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

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

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

ตั้งค่าพร็อพเพอร์ตี้

public abstract void setProperties (BuildInfoProperties... properties)

ตั้งค่า BuildInfoProperties สำหรับอินสแตนซ์ IBuildInfo ลบล้างค่าใดก็ได้ ที่มีอยู่ก่อนหน้านี้

พารามิเตอร์
properties BuildInfoProperties: รายการที่พักที่จะเพิ่ม

setTestTag

public abstract 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