GTestBase
public abstract class GTestBase
extends Object
implements IRemoteTest , IConfigurationReceiver , ITestFilterReceiver , IRuntimeHintProvider , ITestCollector , IShardableTest , IAbiReceiver
java.lang.Object | |
↳ | com.android.tradefed.testtype.GTestBase |
คลาสพื้นฐานของ gTest
สรุป
เขตข้อมูล | |
---|---|
protected static final String | FILTER_EXTENSION |
protected static final String | GTEST_FLAG_FILE |
protected static final String | GTEST_FLAG_FILTER |
protected static final String | GTEST_FLAG_LIST_TESTS |
protected static final String | GTEST_FLAG_PRINT_TIME |
protected static final String | GTEST_FLAG_RUN_DISABLED_TESTS |
protected static final String | GTEST_XML_OUTPUT
|
ผู้รับเหมาก่อสร้างสาธารณะ | |
---|---|
GTestBase () |
วิธีการสาธารณะ | |
---|---|
void | addAllExcludeFilters ( filters) addAllExcludeFilters ( filters) เพิ่ม |
void | addAllIncludeFilters ( filters) addAllIncludeFilters ( filters) เพิ่ม |
void | addExcludeFilter (String filter) เพิ่มตัวกรองว่าการทดสอบใดที่จะยกเว้น |
void | addIncludeFilter (String filter) เพิ่มตัวกรองว่าจะรวมการทดสอบใดบ้าง |
String | cleanFilter (String filter) |
void | clearExcludeFilters () ลบตัวกรองยกเว้นทั้งหมดที่ติดตามอยู่ในปัจจุบัน |
void | clearIncludeFilters () ลบตัวกรองรวมทั้งหมดที่ติดตามอยู่ในปัจจุบัน |
IAbi | getAbi () |
getAfterTestCmd () รับคำสั่งเชลล์เพื่อทำงานหลังจาก Gtest | |
getBeforeTestCmd () รับคำสั่งเชลล์เพื่อทำงานก่อน Gtest | |
getExcludeFilters () ส่งกลับ | |
getFileExclusionFilterRegex () รับ regex เพื่อแยกไฟล์บางไฟล์ออกจากการดำเนินการ | |
getGTestFlags () รับค่าแฟล็กเพิ่มเติมเพื่อส่งผ่านไปยังคำสั่งเชลล์ของการทดสอบเนทิฟ | |
getIncludeFilters () ส่งกลับ | |
long | getMaxTestTimeMs () รับเวลาสูงสุดเพื่อให้ gtest ทำงาน |
String | getModuleName () รับโมดูลการทดสอบดั้งเดิมของ Android เพื่อทำงาน |
boolean | getRunDisabledTests () รับว่า Gtest ควรทำการทดสอบที่ปิดใช้งานหรือไม่ |
long | getRuntimeHint () ส่งกลับรันไทม์ที่คาดไว้ของการทดสอบในหน่วยมิลลิวินาที |
int | getShardCount () ส่งกลับจำนวนชาร์ดปัจจุบัน |
int | getShardIndex () รับดัชนีชาร์ดของการทดสอบนี้ |
String | getTestFilterKey () รับคีย์ตัวกรองการทดสอบ |
String | getTestModule () รับชื่อโมดูล |
boolean | isCollectTestsOnly () รับเฉพาะการเรียกใช้ไบนารีการทดสอบเพื่อรวบรวมรายการกรณีทดสอบที่เกี่ยวข้องหรือไม่ |
boolean | isEnableXmlOutput () รับการใช้เอาต์พุต gtest xml สำหรับผลการทดสอบหรือไม่ |
boolean | isSharded () รับค่าสถานะ isSharded |
void | notifyTestExecution (boolean incompleteTestFound, failedTests) notifyTestExecution (boolean incompleteTestFound, failedTests) แจ้งผู้ปกครองเกี่ยวกับการดำเนินการทดสอบ เพื่อให้สามารถจัดการตัวกรองการรวม/การแยกได้อย่างถูกต้องสำหรับการลองอีกครั้ง |
void | setAbi ( IAbi abi) |
void | setCollectTestsOnly (boolean shouldCollectTest) เปิดใช้งานหรือปิดใช้งานโหมดการรวบรวมการทดสอบ |
void | setConfiguration ( IConfiguration configuration) แทรก |
void | setModuleName (String moduleName) ตั้งค่าโมดูลการทดสอบดั้งเดิมของ Android ให้ทำงาน |
void | setShardCount (int shardCount) ตั้งค่าจำนวนชาร์ดของการทดสอบนี้ |
void | setShardIndex (int shardIndex) ตั้งค่าดัชนีชาร์ดของการทดสอบนี้ |
split (int shardCountHint) เวอร์ชันทางเลือกของ |
วิธีการที่ได้รับการป้องกัน | |
---|---|
String | createFlagFile (String filter) สร้างไฟล์ที่มีตัวกรองที่จะใช้ผ่าน --gtest_flagfile เพื่อหลีกเลี่ยงข้อจำกัดของระบบปฏิบัติการในด้านขนาด args |
void | erasePrependedFileName ( filters, String filename) erasePrependedFileName ( filters, String filename) |
String | getAllGTestFlags (String path) ตัวช่วยในการรับแฟล็ก Gtest ทั้งหมดเพื่อส่งผ่านไปยังคำสั่ง adb shell |
IConfiguration | getConfiguration () ส่งคืนการกำหนดค่าการทดสอบ |
String | getExceptionMessage (Exception e) ใช้ความพยายามอย่างเต็มที่ในการดึงข้อความอธิบายสั้นๆ ที่มีความหมายสำหรับ |
String | getGTestCmdLine (String fullPath, String flags) วิธีการช่วยเหลือในการสร้างคำสั่ง gtest เพื่อรัน |
String | getGTestCmdLineWrapper (String fullPath, String flags) ตัวช่วยเหลือที่อนุญาตให้คลาสที่ได้รับห่อคำสั่ง gtest ภายใต้เครื่องมืออื่น ๆ (chroot, strace, gdb และอื่น ๆ ที่คล้ายกัน) |
String | getGTestFilters (String path) ตัวช่วยในการรับตัวกรอง g-test ของการทดสอบให้ทำงาน |
ITestInvocationListener | getGTestListener ( ITestInvocationListener listener) ส่งคืน GTestListener ที่ให้ข้อมูลการดีบักเพิ่มเติม เช่น การตรวจจับและรายงานการทดสอบที่ซ้ำกัน หาก mDisabledDuplicateCheck เป็นเท็จ |
abstract String | loadFilter (String path) กำหนดวิธีการกรองรับ |
void | setRunDisabled (boolean runDisabled) ตั้งค่าว่า Gtest ควรทำการทดสอบที่ปิดใช้งานหรือไม่ |
เขตข้อมูล
FILTER_EXTENSION
protected static final String FILTER_EXTENSION
GTEST_FLAG_FILE
protected static final String GTEST_FLAG_FILE
GTEST_FLAG_FILTER
protected static final String GTEST_FLAG_FILTER
GTEST_FLAG_LIST_TESTS
protected static final String GTEST_FLAG_LIST_TESTS
GTEST_FLAG_PRINT_TIME
protected static final String GTEST_FLAG_PRINT_TIME
GTEST_FLAG_RUN_DISABLED_TESTS
protected static final String GTEST_FLAG_RUN_DISABLED_TESTS
GTEST_XML_OUTPUT
protected static final String GTEST_XML_OUTPUT
ผู้รับเหมาก่อสร้างสาธารณะ
GTestBase
public GTestBase ()
วิธีการสาธารณะ
addAllExcludeFilters
public void addAllExcludeFilters (filters)
เพิ่ม ERROR(/Set)
ของตัวกรองที่จะยกเว้นการทดสอบ
พารามิเตอร์ | |
---|---|
filters |
addAllIncludeFilters
public void addAllIncludeFilters (filters)
เพิ่ม ERROR(/Set)
ของตัวกรองที่ต้องการรวมการทดสอบ
พารามิเตอร์ | |
---|---|
filters |
addExcludeFilter
public void addExcludeFilter (String filter)
เพิ่มตัวกรองว่าการทดสอบใดที่จะยกเว้น
พารามิเตอร์ | |
---|---|
filter | String |
เพิ่มIncludeFilter
public void addIncludeFilter (String filter)
เพิ่มตัวกรองว่าจะรวมการทดสอบใดบ้าง
พารามิเตอร์ | |
---|---|
filter | String |
ทำความสะอาดตัวกรอง
public String cleanFilter (String filter)
พารามิเตอร์ | |
---|---|
filter | String |
การส่งคืน | |
---|---|
String |
clearExcludeFilters
public void clearExcludeFilters ()
ลบตัวกรองยกเว้นทั้งหมดที่ติดตามอยู่ในปัจจุบัน
ล้างรวมตัวกรอง
public void clearIncludeFilters ()
ลบตัวกรองรวมทั้งหมดที่ติดตามอยู่ในปัจจุบัน
getAfterTestCmd
publicgetAfterTestCmd ()
รับคำสั่งเชลล์เพื่อทำงานหลังจาก Gtest
การส่งคืน | |
---|---|
getBeforeTestCmd
publicgetBeforeTestCmd ()
รับคำสั่งเชลล์เพื่อทำงานก่อน Gtest
การส่งคืน | |
---|---|
getExcludeFilters
publicgetExcludeFilters ()
ส่งกลับ ERROR(/Set)
ปัจจุบันของตัวกรองที่แยกออก
การส่งคืน | |
---|---|
getFileExclusionFilterRegex.getFileExclusionFilterRegex
publicgetFileExclusionFilterRegex ()
รับ regex เพื่อแยกไฟล์บางไฟล์ออกจากการดำเนินการ
การส่งคืน | |
---|---|
getGTestFlags
publicgetGTestFlags ()
รับค่าแฟล็กเพิ่มเติมเพื่อส่งผ่านไปยังคำสั่งเชลล์ของการทดสอบเนทิฟ
การส่งคืน | |
---|---|
getMaxTestTimeMs
public long getMaxTestTimeMs ()
รับเวลาสูงสุดเพื่อให้ gtest ทำงาน
การส่งคืน | |
---|---|
long |
รับชื่อโมดูล
public String getModuleName ()
รับโมดูลการทดสอบดั้งเดิมของ Android เพื่อทำงาน
การส่งคืน | |
---|---|
String | ชื่อของโมดูลการทดสอบดั้งเดิมที่จะรัน หรือเป็นค่าว่างหากไม่ได้ตั้งค่า |
getRunDisabledTests
public boolean getRunDisabledTests ()
รับว่า Gtest ควรทำการทดสอบที่ปิดใช้งานหรือไม่
การส่งคืน | |
---|---|
boolean | เป็นจริงหากควรทำการทดสอบที่ปิดใช้งาน มิฉะนั้นจะเป็นเท็จ |
รับ RuntimeHint
public long getRuntimeHint ()
ส่งกลับรันไทม์ที่คาดไว้ของการทดสอบในหน่วยมิลลิวินาที เวลาที่ใช้ในการโหลดการดำเนินการแบ่งส่วนยอดคงเหลือ
การส่งคืน | |
---|---|
long |
getShardCount
public int getShardCount ()
ส่งกลับจำนวนชาร์ดปัจจุบัน
การส่งคืน | |
---|---|
int |
getShardIndex
public int getShardIndex ()
รับดัชนีชาร์ดของการทดสอบนี้
การส่งคืน | |
---|---|
int |
รับ TestFilterKey
public String getTestFilterKey ()
รับคีย์ตัวกรองการทดสอบ
การส่งคืน | |
---|---|
String |
รับTestModule
public String getTestModule ()
รับชื่อโมดูล
การส่งคืน | |
---|---|
String |
isCollectTestsOnly
public boolean isCollectTestsOnly ()
รับเฉพาะการเรียกใช้ไบนารีการทดสอบเพื่อรวบรวมรายการกรณีทดสอบที่เกี่ยวข้องหรือไม่
การส่งคืน | |
---|---|
boolean |
isEnableXmlOutput
public boolean isEnableXmlOutput ()
รับการใช้เอาต์พุต gtest xml สำหรับผลการทดสอบหรือไม่
การส่งคืน | |
---|---|
boolean |
เป็นชาร์ด
public boolean isSharded ()
รับค่าสถานะ isSharded
การส่งคืน | |
---|---|
boolean |
notifyTestExecution
public void notifyTestExecution (boolean incompleteTestFound,failedTests)
แจ้งผู้ปกครองเกี่ยวกับการดำเนินการทดสอบ เพื่อให้สามารถจัดการตัวกรองการรวม/การแยกได้อย่างถูกต้องสำหรับการลองอีกครั้ง
พารามิเตอร์ | |
---|---|
incompleteTestFound | boolean |
failedTests |
setCollectTestsOnly
public void setCollectTestsOnly (boolean shouldCollectTest)
เปิดใช้งานหรือปิดใช้งานโหมดการรวบรวมการทดสอบ
ตั้งค่าคอนฟิก
public void setConfiguration (IConfiguration configuration)
แทรก IConfiguration
ที่ใช้งานอยู่
พารามิเตอร์ | |
---|---|
configuration | IConfiguration |
ชื่อชุดโมดูล
public void setModuleName (String moduleName)
ตั้งค่าโมดูลการทดสอบดั้งเดิมของ Android ให้ทำงาน
พารามิเตอร์ | |
---|---|
moduleName | String : ชื่อของโมดูลการทดสอบดั้งเดิมที่จะรัน |
setShardCount
public void setShardCount (int shardCount)
ตั้งค่าจำนวนชาร์ดของการทดสอบนี้
พารามิเตอร์ | |
---|---|
shardCount | int |
setShardIndex
public void setShardIndex (int shardIndex)
ตั้งค่าดัชนีชาร์ดของการทดสอบนี้
พารามิเตอร์ | |
---|---|
shardIndex | int |
แยก
publicsplit (int shardCountHint)
เวอร์ชันทางเลือกของ split()
ซึ่งจัดเตรียม shardCount ที่พยายามเรียกใช้ด้วย สิ่งนี้มีประโยชน์สำหรับผู้ทดสอบบางรายที่ไม่สามารถตัดสินใจได้ตามอำเภอใจในบางครั้ง
พารามิเตอร์ | |
---|---|
shardCountHint | int : จำนวนชาร์ดที่พยายามทำ |
การส่งคืน | |
---|---|
ชุดของการทดสอบย่อยที่จะดำเนินการแยกกันหรือ null หากการทดสอบยังไม่สามารถแบ่งส่วนได้ |
วิธีการที่ได้รับการป้องกัน
createFlagFile
protected String createFlagFile (String filter)
สร้างไฟล์ที่มีตัวกรองที่จะใช้ผ่าน --gtest_flagfile เพื่อหลีกเลี่ยงข้อจำกัดของระบบปฏิบัติการในด้านขนาด args
พารามิเตอร์ | |
---|---|
filter | String : สตริงตัวกรอง |
การส่งคืน | |
---|---|
String | เส้นทางไปยังไฟล์ที่มีตัวกรอง |
ขว้าง | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
ลบPrependedFileName
protected void erasePrependedFileName (filters, String filename)
พารามิเตอร์ | |
---|---|
filters | |
filename | String |
getAllGTestFlags
protected String getAllGTestFlags (String path)
ตัวช่วยในการรับแฟล็ก Gtest ทั้งหมดเพื่อส่งผ่านไปยังคำสั่ง adb shell
พารามิเตอร์ | |
---|---|
path | String : เส้นทางแบบเต็มของไบนารีบนอุปกรณ์ |
การส่งคืน | |
---|---|
String | String ของแฟล็ก Gtest ทั้งหมดที่ควรส่งผ่านไปยัง GTest |
ขว้าง | |
---|---|
DeviceNotAvailableException |
รับการกำหนดค่า
protected IConfiguration getConfiguration ()
ส่งคืนการกำหนดค่าการทดสอบ
การส่งคืน | |
---|---|
IConfiguration | การกำหนดค่า I |
รับExceptionMessage
protected String getExceptionMessage (Exception e)
ใช้ความพยายามอย่างเต็มที่ในการดึงข้อความอธิบายสั้นๆ ที่มีความหมายสำหรับ Exception
ที่กำหนด
พารามิเตอร์ | |
---|---|
e | Exception : Exception |
การส่งคืน | |
---|---|
String | ข้อความสั้น ๆ |
getGTestCmdLine
protected String getGTestCmdLine (String fullPath, String flags)
วิธีการช่วยเหลือในการสร้างคำสั่ง gtest เพื่อรัน
พารามิเตอร์ | |
---|---|
fullPath | String : เส้นทางระบบไฟล์สัมบูรณ์ไปยัง gtest ไบนารี่บนอุปกรณ์ |
flags | String : ธงการดำเนินการ gtest |
การส่งคืน | |
---|---|
String | บรรทัดคำสั่งเชลล์เพื่อรันสำหรับ gtest |
getGTestCmdLineWrapper
protected String getGTestCmdLineWrapper (String fullPath, String flags)
ตัวช่วยเหลือที่อนุญาตให้คลาสที่ได้รับห่อคำสั่ง gtest ภายใต้เครื่องมืออื่น ๆ (chroot, strace, gdb และอื่น ๆ ที่คล้ายกัน)
พารามิเตอร์ | |
---|---|
fullPath | String |
flags | String |
การส่งคืน | |
---|---|
String |
getGTestFilters
protected String getGTestFilters (String path)
ตัวช่วยในการรับตัวกรอง g-test ของการทดสอบให้ทำงาน
โปรดทราบว่าตัวกรองกรองเฉพาะชื่อฟังก์ชันเท่านั้น (เช่น: Google Test "Test"); "กรณีทดสอบ" ของ Google Test ทั้งหมดจะได้รับการพิจารณา
พารามิเตอร์ | |
---|---|
path | String : เส้นทางแบบเต็มของไบนารีบนอุปกรณ์ |
การส่งคืน | |
---|---|
String | ค่าสถานะตัวกรองแบบเต็มที่จะส่งผ่านไปยัง g-test หรือสตริงว่างหากไม่มีการระบุ |
ขว้าง | |
---|---|
DeviceNotAvailableException |
getGTestListener
protected ITestInvocationListener getGTestListener (ITestInvocationListener listener)
ส่งคืน GTestListener ที่ให้ข้อมูลการดีบักเพิ่มเติม เช่น การตรวจจับและรายงานการทดสอบที่ซ้ำกัน หาก mDisabledDuplicateCheck เป็นเท็จ มิฉะนั้นจะส่งคืน Listener ที่ส่งผ่าน
พารามิเตอร์ | |
---|---|
listener | ITestInvocationListener |
การส่งคืน | |
---|---|
ITestInvocationListener |
โหลดฟิลเตอร์
protected abstract String loadFilter (String path)
กำหนดวิธีการกรองรับ
คลาสย่อยต้องใช้วิธีรับตัวกรองของตัวเอง
พารามิเตอร์ | |
---|---|
path | String : เส้นทางแบบเต็มของไฟล์ตัวกรอง |
การส่งคืน | |
---|---|
String | สตริงตัวกรอง |
ขว้าง | |
---|---|
DeviceNotAvailableException |
setRunDisabled
protected void setRunDisabled (boolean runDisabled)
ตั้งค่าว่า Gtest ควรทำการทดสอบที่ปิดใช้งานหรือไม่
พารามิเตอร์ | |
---|---|
runDisabled | boolean |