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 เพื่อหลีกเลี่ยงข้อจำกัดของระบบปฏิบัติการในขนาด args |
void | erasePrependedFileName ( filters, String filename) erasePrependedFileName ( filters, String filename) |
String | getAllGTestFlags (String path) ผู้ช่วยรับแฟล็ก GTest ทั้งหมดเพื่อส่งผ่านไปยังคำสั่งเชลล์ adb |
IConfiguration | getConfiguration () ส่งกลับการกำหนดค่าการทดสอบ |
String | getExceptionMessage (Exception e) พยายามอย่างเต็มที่เพื่อดึงข้อความอธิบายสั้นๆ ที่มีความหมายสำหรับ |
String | getGTestCmdLine (String fullPath, String flags) เมธอด Helper เพื่อสร้างคำสั่ง gtest ให้รัน |
String | getGTestCmdLineWrapper (String fullPath, String flags) Helper ซึ่งอนุญาตให้คลาสที่ได้รับมาห่อคำสั่ง 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 ()
วิธีการสาธารณะ
addAllExcludeFilters
public void addAllExcludeFilters (filters)
เพิ่ม ERROR(/Set)
ของตัวกรองที่ต้องการยกเว้นการทดสอบ
พารามิเตอร์ | |
---|---|
filters |
addAllรวมตัวกรอง
public void addAllIncludeFilters (filters)
เพิ่ม ERROR(/Set)
ของตัวกรองที่ต้องการรวมการทดสอบ
พารามิเตอร์ | |
---|---|
filters |
addExcludeFilter
public void addExcludeFilter (String filter)
เพิ่มตัวกรองที่ต้องการยกเว้นการทดสอบ
พารามิเตอร์ | |
---|---|
filter | String |
addIncludeFilter
public void addIncludeFilter (String filter)
เพิ่มตัวกรองที่จะรวมการทดสอบ
พารามิเตอร์ | |
---|---|
filter | String |
cleanFilter
public String cleanFilter (String filter)
พารามิเตอร์ | |
---|---|
filter | String |
คืนสินค้า | |
---|---|
String |
clearExcludeFilters
public void clearExcludeFilters ()
ลบตัวกรองการยกเว้นทั้งหมดที่ติดตามอยู่ในปัจจุบัน
clearIncludeFilters
public void clearIncludeFilters ()
ลบตัวกรองรวมทั้งหมดที่ติดตามอยู่ในปัจจุบัน
getAfterTestCmd
publicgetAfterTestCmd ()
รับคำสั่งเชลล์ให้รันหลังจาก GTest
คืนสินค้า | |
---|---|
getBeforeTestCmd
publicgetBeforeTestCmd ()
รับคำสั่งเชลล์ให้รันก่อน GTest
คืนสินค้า | |
---|---|
getExcludeFilters
publicgetExcludeFilters ()
ส่งกลับ ERROR(/Set)
ปัจจุบันของตัวกรองที่แยกออก
คืนสินค้า | |
---|---|
getFileExclusionFilterRegex
publicgetFileExclusionFilterRegex ()
รับ regex เพื่อแยกไฟล์บางไฟล์ออกจากการดำเนินการ
คืนสินค้า | |
---|---|
getGTestFlags
publicgetGTestFlags ()
รับค่าแฟล็กเพิ่มเติมเพื่อส่งผ่านไปยังคำสั่งเชลล์ของการทดสอบเนทีฟ
คืนสินค้า | |
---|---|
getMaxTestTimeMs
public long getMaxTestTimeMs ()
รับเวลาสูงสุดสำหรับการทดสอบ gtest
คืนสินค้า | |
---|---|
long |
getModuleName
public String getModuleName ()
รับโมดูลการทดสอบเนทีฟของ Android เพื่อเรียกใช้
คืนสินค้า | |
---|---|
String | ชื่อของโมดูลการทดสอบดั้งเดิมที่จะรัน หรือ null หากไม่ได้ตั้งค่า |
getRunDisabledTests
public boolean getRunDisabledTests ()
รับว่า GTest ควรเรียกใช้การทดสอบที่ปิดใช้งานหรือไม่
คืนสินค้า | |
---|---|
boolean | จริงหากควรทำการทดสอบที่ปิดใช้งาน มิฉะนั้น เท็จ |
getRuntimeHint
public long getRuntimeHint ()
ส่งคืนรันไทม์ที่คาดไว้ของการทดสอบในหน่วยมิลลิวินาที เวลาที่ใช้ในการโหลดบาลานซ์ชาร์ด Execution
คืนสินค้า | |
---|---|
long |
getShardCount
public int getShardCount ()
ส่งกลับจำนวนชาร์ดปัจจุบัน
คืนสินค้า | |
---|---|
int |
getShardIndex
public int getShardIndex ()
รับดัชนีชาร์ดของการทดสอบนี้
คืนสินค้า | |
---|---|
int |
getTestFilterKey
public String getTestFilterKey ()
รับคีย์ตัวกรองทดสอบ
คืนสินค้า | |
---|---|
String |
getTestModule
public String getTestModule ()
รับชื่อโมดูล
คืนสินค้า | |
---|---|
String |
isCollectTestsOnly
public boolean isCollectTestsOnly ()
รับเฉพาะไบนารีทดสอบเพื่อรวบรวมรายชื่อกรณีทดสอบที่เกี่ยวข้องหรือไม่
คืนสินค้า | |
---|---|
boolean |
isEnableXmlOutput
public boolean isEnableXmlOutput ()
รับใช้เอาต์พุต gtest xml สำหรับผลการทดสอบหรือไม่
คืนสินค้า | |
---|---|
boolean |
isShaded
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 หากปัจจุบันยังไม่สามารถแบ่งการทดสอบได้ |
วิธีการป้องกัน
createFlagFile
protected String createFlagFile (String filter)
สร้างไฟล์ที่มีตัวกรองที่จะใช้ผ่าน --gtest_flagfile เพื่อหลีกเลี่ยงข้อจำกัดของระบบปฏิบัติการในขนาด args
พารามิเตอร์ | |
---|---|
filter | String : สตริงตัวกรอง |
คืนสินค้า | |
---|---|
String | พาธไปยังไฟล์ที่มีตัวกรอง |
ขว้าง | |
---|---|
DeviceNotAvailableException |
ลบPrependedFileName
protected void erasePrependedFileName (filters, String filename)
พารามิเตอร์ | |
---|---|
filters | |
filename | String |
getAllGTestFlags
protected String getAllGTestFlags (String path)
ผู้ช่วยรับแฟล็ก GTest ทั้งหมดเพื่อส่งผ่านไปยังคำสั่งเชลล์ adb
พารามิเตอร์ | |
---|---|
path | String : เส้นทางแบบเต็มของไบนารีบนอุปกรณ์ |
คืนสินค้า | |
---|---|
String | String ของธง GTest ทั้งหมดที่ควรส่งผ่านไปยัง GTest |
ขว้าง | |
---|---|
DeviceNotAvailableException |
รับการกำหนดค่า
protected IConfiguration getConfiguration ()
ส่งกลับการกำหนดค่าการทดสอบ
คืนสินค้า | |
---|---|
IConfiguration | IConfiguration |
getExceptionMessage
protected String getExceptionMessage (Exception e)
พยายามอย่างเต็มที่เพื่อดึงข้อความอธิบายสั้นๆ ที่มีความหมายสำหรับ Exception
ที่กำหนด
พารามิเตอร์ | |
---|---|
e | Exception : Exception |
คืนสินค้า | |
---|---|
String | ข้อความสั้นๆ |
getGTestCmdLine
protected String getGTestCmdLine (String fullPath, String flags)
เมธอด Helper เพื่อสร้างคำสั่ง gtest ให้รัน
พารามิเตอร์ | |
---|---|
fullPath | String : เส้นทางระบบไฟล์แบบสัมบูรณ์ไปยัง gtest binary บนอุปกรณ์ |
flags | String : gtest การดำเนินการแฟล็ก |
คืนสินค้า | |
---|---|
String | บรรทัดคำสั่งเชลล์ที่จะรันสำหรับ gtest |
getGTestCmdLineWrapper
protected String getGTestCmdLineWrapper (String fullPath, String flags)
Helper ซึ่งอนุญาตให้คลาสที่ได้รับมาห่อคำสั่ง 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 |
loadFilter
protected abstract String loadFilter (String path)
กำหนดรับวิธีการกรอง
คลาสย่อยต้องใช้วิธีการรับตัวกรองของตัวเอง
พารามิเตอร์ | |
---|---|
path | String : เส้นทางแบบเต็มของไฟล์ตัวกรอง |
คืนสินค้า | |
---|---|
String | สตริงตัวกรอง |
ขว้าง | |
---|---|
DeviceNotAvailableException |
setRunDisabled
protected void setRunDisabled (boolean runDisabled)
ตั้งค่าว่า GTest ควรเรียกใช้การทดสอบที่ปิดใช้งานหรือไม่
พารามิเตอร์ | |
---|---|
runDisabled | boolean |