IBuildInfo

public interface IBuildInfo
implements Serializable

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

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

default void allowStagingRemoteFile(boolean stageRemoteFile)

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

abstract void cleanUp()

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

abstract void cleanUp(List<File> doNotDelete)

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

abstract IBuildInfo clone()

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

default List<VersionedFile> getAppPackageFiles()

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

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

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

abstract Collection<VersionedFile> getFiles()

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

abstract Set<IBuildInfo.BuildInfoProperties> getProperties()

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

default Set<File> getRemoteFiles()

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

abstract String getTestTag()

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

default String getVersion(BuildInfoKey.BuildInfoFileKey key)

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

abstract String getVersion(String name)

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

default VersionedFile getVersionedFile(BuildInfoKey.BuildInfoFileKey key)

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

default VersionedFile getVersionedFile(String name)

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

default Set<String> getVersionedFileKeys()

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

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

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

default void removeBuildAttribute(String attributeName)

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

abstract void setBuildBranch(String branch)

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

abstract void setBuildFlavor(String buildFlavor)

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

abstract void setBuildId(String buildId)

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

abstract void setDeviceSerial(String serial)

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

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

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

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

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

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

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

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

allowStagingRemoteFile

public void allowStagingRemoteFile (boolean stageRemoteFile)

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

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

cleanUp

public abstract void cleanUp ()

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

cleanUp

public abstract void cleanUp (List<File> doNotDelete)

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

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

โคลน

public abstract IBuildInfo clone ()

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

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

getAppPackageFiles

public List<VersionedFile> getAppPackageFiles ()

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

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

getBuildAttributes

public abstract Map<String, String> getBuildAttributes ()

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

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

getBuildBranch

public abstract String getBuildBranch ()

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

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

getBuildFlavor

public abstract String getBuildFlavor ()

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

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

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

getBuildId

public abstract String getBuildId ()

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

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

getBuildTargetName

public abstract String getBuildTargetName ()

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

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

การคืนสินค้า
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)

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

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

getFiles

public abstract Collection<VersionedFile> getFiles ()

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

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

getProperties

public abstract Set<IBuildInfo.BuildInfoProperties> getProperties ()

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

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

getRemoteFiles

public Set<File> getRemoteFiles ()

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

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

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)

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

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

getVersionedFile

public VersionedFile getVersionedFile (String name)

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

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

getVersionedFileKeys

public Set<String> getVersionedFileKeys ()

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

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

getVersionedFiles

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

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

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

removeBuildAttribute

public void removeBuildAttribute (String attributeName)

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

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

setBuildBranch

public abstract void setBuildBranch (String branch)

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

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

setBuildFlavor

public abstract void setBuildFlavor (String buildFlavor)

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

setBuildId

public abstract void setBuildId (String buildId)

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

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

setDeviceSerial

public abstract 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 abstract void setFile (String name, 
                File file, 
                String version)

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

พารามิเตอร์
name String: ชื่อที่ไม่ซ้ำกันของไฟล์
file File: 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): 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