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 | 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 เพื่อหลีกเลี่ยงข้อจำกัดของระบบปฏิบัติการในขนาดอาร์กิวเมนต์ |
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) ส่งกลับ |
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 ()
วิธีการสาธารณะ
เพิ่มตัวกรองที่ไม่รวมทั้งหมด
public void addAllExcludeFilters (filters)
เพิ่ม ERROR(/Set)
ของตัวกรองที่จะไม่รวมการทดสอบ
พารามิเตอร์ | |
---|---|
filters |
เพิ่มตัวกรองรวมทั้งหมด
public void addAllIncludeFilters (filters)
เพิ่ม ERROR(/Set)
ของตัวกรองที่จะรวมการทดสอบ
พารามิเตอร์ | |
---|---|
filters |
เพิ่ม ExcludeFilter
public void addExcludeFilter (String filter)
เพิ่มตัวกรองที่จะไม่รวมการทดสอบ
พารามิเตอร์ | |
---|---|
filter | String |
เพิ่มรวมตัวกรอง
public void addIncludeFilter (String filter)
เพิ่มตัวกรองที่จะรวมการทดสอบ
พารามิเตอร์ | |
---|---|
filter | String |
ตัวกรองที่สะอาด
public String cleanFilter (String filter)
พารามิเตอร์ | |
---|---|
filter | String |
ส่งคืน | |
---|---|
String |
clearExcludeFilter
public void clearExcludeFilters ()
ลบตัวกรองแยกทั้งหมดที่ติดตามอยู่ในปัจจุบัน
ล้างรวมตัวกรอง
public void clearIncludeFilters ()
ลบตัวกรองรวมทั้งหมดที่ติดตามอยู่ในปัจจุบัน
รับ AfterTestCmd
publicgetAfterTestCmd ()
รับคำสั่งเชลล์เพื่อรันหลังจาก GTest
ส่งคืน | |
---|---|
รับก่อนTestCmd
publicgetBeforeTestCmd ()
รับคำสั่งเชลล์เพื่อรันก่อน GTest
ส่งคืน | |
---|---|
getFileExclusionFilterRegex
publicgetFileExclusionFilterRegex ()
รับ regex เพื่อแยกบางไฟล์ออกจากการดำเนินการ
ส่งคืน | |
---|---|
getGTestFlags
publicgetGTestFlags ()
รับค่าแฟล็กเพิ่มเติมเพื่อส่งไปยังคำสั่งเชลล์ของการทดสอบเนทีฟ
ส่งคืน | |
---|---|
getMaxTestTimeMs
public long getMaxTestTimeMs ()
รับเวลาสูงสุดสำหรับการเรียกใช้ gtest
ส่งคืน | |
---|---|
long |
getModuleName
public String getModuleName ()
รับโมดูลทดสอบดั้งเดิมของ Android เพื่อเรียกใช้
ส่งคืน | |
---|---|
String | ชื่อของโมดูลทดสอบเนทีฟที่จะรัน หรือ null หากไม่ได้ตั้งค่า |
getRunDisabledTests
public boolean getRunDisabledTests ()
รับว่า GTest ควรเรียกใช้การทดสอบที่ปิดใช้งานหรือไม่
ส่งคืน | |
---|---|
boolean | จริงหากควรรันการทดสอบที่ปิดใช้งาน มิฉะนั้นจะเป็นเท็จ |
รับคำแนะนำรันไทม์
public long getRuntimeHint ()
ส่งคืนรันไทม์ที่คาดไว้ของการทดสอบเป็นมิลลิวินาที เวลาที่ใช้ในการโหลดบาลานซ์การดำเนินการชาร์ด
ส่งคืน | |
---|---|
long |
รับ ShardCount
public int getShardCount ()
ส่งกลับจำนวนเศษปัจจุบัน
ส่งคืน | |
---|---|
int |
รับ ShardIndex
public int getShardIndex ()
รับดัชนีเศษของการทดสอบนี้
ส่งคืน | |
---|---|
int |
getTestFilterKey
public String getTestFilterKey ()
รับคีย์ตัวกรองการทดสอบ
ส่งคืน | |
---|---|
String |
รับการทดสอบโมดูล
public String getTestModule ()
รับชื่อโมดูล
ส่งคืน | |
---|---|
String |
คือรวบรวมการทดสอบเท่านั้น
public boolean isCollectTestsOnly ()
รับเพียงเรียกใช้ไบนารีทดสอบเพื่อรวบรวมรายการกรณีทดสอบที่เกี่ยวข้องหรือไม่
ส่งคืน | |
---|---|
boolean |
isEnableXmlOutput
public boolean isEnableXmlOutput ()
ใช้เอาต์พุต gtest xml สำหรับผลการทดสอบหรือไม่
ส่งคืน | |
---|---|
boolean |
เป็นเศษ
public boolean isSharded ()
รับค่าสถานะ isSharded
ส่งคืน | |
---|---|
boolean |
setCollectTestsOnly
public void setCollectTestsOnly (boolean shouldCollectTest)
เปิดหรือปิดโหมดรวบรวมการทดสอบ
setConfiguration
public void setConfiguration (IConfiguration configuration)
ใส่ IConfiguration
ที่ใช้งานอยู่
พารามิเตอร์ | |
---|---|
configuration | IConfiguration |
setModuleName
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 หากการทดสอบไม่สามารถแบ่งย่อยได้ในขณะนี้ |
วิธีการป้องกัน
สร้างแฟล็กไฟล์
protected String createFlagFile (String filter)
สร้างไฟล์ที่มีตัวกรองที่จะใช้ผ่าน --gtest_flagfile เพื่อหลีกเลี่ยงข้อจำกัดของระบบปฏิบัติการในขนาดอาร์กิวเมนต์
พารามิเตอร์ | |
---|---|
filter | String : สตริงตัวกรอง |
ส่งคืน | |
---|---|
String | เส้นทางไปยังไฟล์ที่มีตัวกรอง |
พ่น | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
ลบ PrependedFileName
protected void erasePrependedFileName (filters, String filename)
พารามิเตอร์ | |
---|---|
filters | |
filename | String |
รับ AllGTestFlags
protected String getAllGTestFlags (String path)
ตัวช่วยในการรับค่าสถานะ GTest ทั้งหมดเพื่อส่งผ่านไปยังคำสั่ง adb shell
พารามิเตอร์ | |
---|---|
path | String : เส้นทางแบบเต็มของไบนารีบนอุปกรณ์ |
ส่งคืน | |
---|---|
String | ERROR(/String) ของแฟล็ก GTest ทั้งหมดที่ควรส่งผ่านไปยัง GTest |
พ่น | |
---|---|
DeviceNotAvailableException |
รับการกำหนดค่า
protected IConfiguration getConfiguration ()
ส่งกลับการกำหนดค่าการทดสอบ
ส่งคืน | |
---|---|
IConfiguration | IConconfiguration |
getExceptionMessage
protected String getExceptionMessage (Exception e)
พยายามอย่างดีที่สุดเพื่อดึงข้อความอธิบายสั้นๆ ที่มีความหมายสำหรับ ERROR(/Exception)
ที่ระบุ
พารามิเตอร์ | |
---|---|
e | Exception : ERROR(/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 |
getGTestFilter
protected String getGTestFilters (String path)
ผู้ช่วยในการรับตัวกรอง g-test ของการทดสอบให้ทำงาน
โปรดทราบว่าตัวกรองจะกรองเฉพาะชื่อฟังก์ชันเท่านั้น (เช่น Google Test "Test"); การทดสอบ "กรณีทดสอบ" ของ Google ทั้งหมดจะได้รับการพิจารณา
พารามิเตอร์ | |
---|---|
path | String : เส้นทางแบบเต็มของไบนารีบนอุปกรณ์ |
ส่งคืน | |
---|---|
String | แฟล็กตัวกรองแบบเต็มเพื่อส่งไปยังการทดสอบ g หรือสตริงว่างหากไม่ได้ระบุ |
พ่น | |
---|---|
DeviceNotAvailableException |
getGTestListener
protected ITestInvocationListener getGTestListener (ITestInvocationListener listener)
ส่งกลับ GTestListener
ที่ให้ข้อมูลการดีบักเพิ่มเติม เช่น ตรวจจับและรายงานการทดสอบที่ซ้ำกัน หาก mDisabledDuplicateCheck เป็นเท็จ มิฉะนั้น จะส่งคืนผู้ฟังที่ผ่านเข้ามา
พารามิเตอร์ | |
---|---|
listener | ITestInvocationListener |
ส่งคืน | |
---|---|
ITestInvocationListener |
ตัวกรองโหลด
protected abstract String loadFilter (String path)
กำหนดวิธีการกรองรับ
คลาสย่อยต้องใช้วิธีการรับตัวกรองของตัวเอง
พารามิเตอร์ | |
---|---|
path | String : เส้นทางแบบเต็มของไฟล์ตัวกรอง |
ส่งคืน | |
---|---|
String | สตริงตัวกรอง |
พ่น | |
---|---|
DeviceNotAvailableException |
setRunDisabled
protected void setRunDisabled (boolean runDisabled)
ตั้งค่าว่า GTest ควรเรียกใช้การทดสอบที่ปิดใช้งานหรือไม่
พารามิเตอร์ | |
---|---|
runDisabled | boolean |