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

เพิ่มคุณสมบัติการสร้าง

abstract void cleanUp ()

ทำความสะอาดไฟล์บิลด์ชั่วคราว

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

ลบชื่อแอตทริบิวต์ที่กำหนดออกจากการติดตาม

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

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

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

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

version String

addBuildAttribute

public abstract void addBuildAttribute (String attributeName, 
                String attributeValue)

เพิ่มแอตทริบิวต์การสร้าง สิ่งนี้ไม่อนุญาตให้แทนที่ชื่อแอตทริบิวต์ที่มีอยู่

พารามิเตอร์
attributeName String : ชื่อแอตทริบิวต์เฉพาะ

attributeValue String : ค่าแอตทริบิวต์

เพิ่ม BuildAttributes

public void addBuildAttributes ( buildAttributes)

เพิ่มคุณสมบัติการสร้าง

พารามิเตอร์
buildAttributes : แผนที่ของคุณสมบัติที่จะเพิ่ม

ทำความสะอาด

public abstract void cleanUp ()

ทำความสะอาดไฟล์บิลด์ชั่วคราว

ทำความสะอาด

public abstract void cleanUp ( doNotDelete)

เวอร์ชันของ cleanUp() ซึ่งไฟล์บางไฟล์ไม่ถูกลบ

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

โคลน

public abstract IBuildInfo clone ()

โคลนวัตถุ IBuildInfo

การส่งคืน
IBuildInfo

getAppPackageFiles

public  getAppPackageFiles ()

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

การส่งคืน

getBuildAttributes

public abstract  getBuildAttributes ()

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

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

getBuildBranch

public abstract String getBuildBranch ()

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

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

getBuildFlavour

public abstract String getBuildFlavor ()

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

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

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

รับ BuildId

public abstract String getBuildId ()

ส่งกลับตัวระบุเฉพาะของรุ่นภายใต้การทดสอบ ไม่ควรจะเป็นโมฆะ ค่าเริ่มต้นเป็น UNKNOWN_BUILD_ID

การส่งคืน
String

รับ BuildTargetName

public abstract String getBuildTargetName ()

ส่งคืนชื่อที่สมบูรณ์ของบิลด์ที่กำลังทดสอบ

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

การส่งคืน
String

รับDeviceSerial

public abstract String getDeviceSerial ()

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

getFile.getFile

public abstract File getFile (String name)

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

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

getFile.getFile

public File getFile (BuildInfoKey.BuildInfoFileKey key)

วิธีการช่วยเหลือในการดึงไฟล์ด้วย BuildInfoFileKey ที่กำหนด

พารามิเตอร์
key BuildInfoKey.BuildInfoFileKey : BuildInfoFileKey ที่ถูกร้องขอ

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

รับไฟล์

public abstract  getFiles ()

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

การส่งคืน

รับคุณสมบัติ

public abstract  getProperties ()

ส่งกลับสำเนาของคุณสมบัติที่ตั้งค่าไว้ใน IBuildInfo ในปัจจุบัน

การส่งคืน

getRemoteFiles

public  getRemoteFiles ()

รับเส้นทางสำหรับการสร้างสิ่งประดิษฐ์ที่ล่าช้าในการดาวน์โหลด

การส่งคืน

รับTestTag

public abstract String getTestTag ()

ส่งกลับชื่อเฉพาะสำหรับการทดสอบที่กำลังดำเนินการอยู่

การส่งคืน
String

รับเวอร์ชัน

public String getVersion (BuildInfoKey.BuildInfoFileKey key)

วิธีการช่วยเหลือในการดึงข้อมูลเวอร์ชันไฟล์โดยกำหนด BuildInfoFileKey

พารามิเตอร์
key BuildInfoKey.BuildInfoFileKey : BuildInfoFileKey ที่ร้องขอ

การส่งคืน
String เวอร์ชันรูปภาพหรือ null หากไม่พบ

รับเวอร์ชัน

public abstract String getVersion (String name)

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

การส่งคืน
String เวอร์ชันรูปภาพหรือ null หากไม่พบ

getVersionedFile.getVersionedFile

public VersionedFile getVersionedFile (BuildInfoKey.BuildInfoFileKey key)

วิธีการช่วยเหลือในการดึง VersionedFile ด้วย BuildInfoFileKey ที่กำหนด

พารามิเตอร์
key BuildInfoKey.BuildInfoFileKey : BuildInfoFileKey ที่ร้องขอ

การส่งคืน
VersionedFile ไฟล์เวอร์ชันหรือ null หากไม่พบ

getVersionedFile.getVersionedFile

public VersionedFile getVersionedFile (String name)

วิธีการช่วยเหลือในการดึง VersionedFile ด้วยชื่อที่กำหนด

การส่งคืน
VersionedFile ไฟล์เวอร์ชันหรือ null หากไม่พบ

getVersionedFileKeys.getVersionedFileKeys

public  getVersionedFileKeys ()

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

การส่งคืน

getVersionedFiles.getVersionedFiles

public  getVersionedFiles (BuildInfoKey.BuildInfoFileKey key)

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

พารามิเตอร์
key BuildInfoKey.BuildInfoFileKey : BuildInfoFileKey ที่ร้องขอ

การส่งคืน
ไฟล์เวอร์ชันหรือ null หากไม่พบ

ลบBuildAttribute

public void removeBuildAttribute (String attributeName)

ลบชื่อแอตทริบิวต์ที่กำหนดออกจากการติดตาม

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

setBuildBranch

public abstract void setBuildBranch (String branch)

ตั้งค่าสาขาการสร้าง

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

ตั้งค่า BuildFlavour

public abstract void setBuildFlavor (String buildFlavor)

กำหนดรสชาติการสร้าง

setBuildId

public abstract void setBuildId (String buildId)

ตั้งค่าตัวระบุเฉพาะของบิลด์ที่อยู่ระหว่างการทดสอบ ไม่ควรจะเป็นโมฆะ

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

ตั้งค่า DeviceSerial

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 : เวอร์ชันของไฟล์

ตั้งค่าคุณสมบัติ

public abstract void setProperties (BuildInfoProperties... properties)

ตั้งค่า BuildInfoProperties สำหรับอินสแตนซ์ IBuildInfo แทนที่คุณสมบัติที่มีอยู่ที่ตั้งไว้ก่อนหน้า

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

ตั้งค่าTestTag

public abstract void setTestTag (String testTag)

ตั้งชื่อเฉพาะสำหรับการทดสอบที่กำลังรัน

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

stageRemoteFile

public File stageRemoteFile (String fileName, 
                File workingDir)

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

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

พารามิเตอร์
fileName String : ชื่อของไฟล์ที่จะอยู่ในไฟล์ระยะไกล

workingDir File : อ็อบเจ็กต์ ERROR(/File) ของไดเร็กทอรีเพื่อจัดเตรียมไฟล์

การส่งคืน
File อ็อบเจ็กต์ ERROR(/File) ของไฟล์ที่จัดฉากใน localworkingDir

ถึงโปรโต

public BuildInformation.BuildInfo toProto ()

ทำให้อินสแตนซ์ BuildInfo เป็นอนุกรมลงใน protobuf

การส่งคืน
BuildInformation.BuildInfo