IBuildInfo

public interface IBuildInfo

com.android.tradefed.build.IBuildInfo


เก็บข้อมูลเกี่ยวกับการสร้างภายใต้การทดสอบ

สรุป

ค่าคงที่

String REMOTE_FILE_PREFIX

คำนำหน้าที่ใช้ในชื่อเพื่อระบุว่าไฟล์ถูกตั้งค่าให้ดาวน์โหลดล่าช้า

String REMOTE_FILE_VERSION

ไฟล์ระยะไกลไม่ได้กำหนดเวอร์ชัน

String UNKNOWN_BUILD_ID

ค่าเริ่มต้นเมื่อไม่ทราบ 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)

เมธอด Helper เพื่อดึงเวอร์ชันไฟล์ด้วย 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)

เมธอด Helper เพื่อดึงรายการของ 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

ค่าเริ่มต้นเมื่อไม่ทราบ ID บิลด์

ค่าคงที่: "-1"

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

เพิ่มAppPackageFile

public void addAppPackageFile (File appPackageFile, 
                String version)

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

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

version String

เพิ่ม BuildAttribute

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 ของแอปในเครื่องและเวอร์ชัน ลำดับที่ส่งคืนตรงกับลำดับที่เพิ่ม apk ลงใน IAppBuildInfo

ส่งคืน

getBuildAttributes

public abstract  getBuildAttributes ()

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

ส่งคืน
ERROR(/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 ()

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

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

ส่งคืน
String

getDeviceSerial

public abstract String getDeviceSerial ()

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

รับไฟล์

public abstract File getFile (String name)

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

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

รับไฟล์

public File getFile (BuildInfoKey.BuildInfoFileKey key)

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

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

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

รับไฟล์

public abstract  getFiles ()

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

ส่งคืน

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

public abstract  getProperties ()

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

ส่งคืน

รับไฟล์ระยะไกล

public  getRemoteFiles ()

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

ส่งคืน

รับTestTag

public abstract String getTestTag ()

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

ส่งคืน
String

รับเวอร์ชัน

public String getVersion (BuildInfoKey.BuildInfoFileKey key)

เมธอด Helper เพื่อดึงเวอร์ชันไฟล์ด้วย BuildInfoFileKey ที่กำหนด

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

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

รับเวอร์ชัน

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)

ส่งคืน

รับไฟล์เวอร์ชัน

public  getVersionedFiles (BuildInfoKey.BuildInfoFileKey key)

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

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

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

ลบ BuildAttribute

public void removeBuildAttribute (String attributeName)

ลบชื่อแอตทริบิวต์ที่ระบุออกจากการติดตาม

พารามิเตอร์
attributeName String : คุณลักษณะที่จะหยุดการติดตาม

setBuildBranch

public abstract void setBuildBranch (String branch)

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

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

setBuildFlavor

public abstract void setBuildFlavor (String buildFlavor)

กำหนดรสชาติของบิลด์

setBuildId

public abstract void setBuildId (String buildId)

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

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

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

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

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

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

ส่งคืน
File วัตถุ ERROR(/File) ของไฟล์ที่จัดฉากใน workingDir ภายในเครื่อง

เพื่อโปรโต

public BuildInformation.BuildInfo toProto ()

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

ส่งคืน
BuildInformation.BuildInfo