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)

เพิ่ม ERROR(/Set) ของตัวกรองที่จะยกเว้นการทดสอบ

void addAllIncludeFilters ( filters) addAllIncludeFilters ( filters)

เพิ่ม ERROR(/Set) ของตัวกรองที่ต้องการรวมการทดสอบ

void addExcludeFilter (String filter)

เพิ่มตัวกรองว่าการทดสอบใดที่จะยกเว้น

void addIncludeFilter (String filter)

เพิ่มตัวกรองว่าจะรวมการทดสอบใดบ้าง

String cleanFilter (String filter)
void clearExcludeFilters ()

ลบตัวกรองยกเว้นทั้งหมดที่ติดตามอยู่ในปัจจุบัน

void clearIncludeFilters ()

ลบตัวกรองรวมทั้งหมดที่ติดตามอยู่ในปัจจุบัน

IAbi getAbi ()
getAfterTestCmd ()

รับคำสั่งเชลล์เพื่อทำงานหลังจาก Gtest

getBeforeTestCmd ()

รับคำสั่งเชลล์เพื่อทำงานก่อน Gtest

getExcludeFilters ()

ส่งกลับ ERROR(/Set) ปัจจุบันของตัวกรองที่แยกออก

getFileExclusionFilterRegex ()

รับ regex เพื่อแยกไฟล์บางไฟล์ออกจากการดำเนินการ

getGTestFlags ()

รับค่าแฟล็กเพิ่มเติมเพื่อส่งผ่านไปยังคำสั่งเชลล์ของการทดสอบเนทิฟ

getIncludeFilters ()

ส่งกลับ ERROR(/Set) ปัจจุบันของตัวกรองรวม

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)

แทรก IConfiguration ที่ใช้งานอยู่

void setModuleName (String moduleName)

ตั้งค่าโมดูลการทดสอบดั้งเดิมของ Android ให้ทำงาน

void setShardCount (int shardCount)

ตั้งค่าจำนวนชาร์ดของการทดสอบนี้

void setShardIndex (int shardIndex)

ตั้งค่าดัชนีชาร์ดของการทดสอบนี้

split (int shardCountHint)

เวอร์ชันทางเลือกของ split() ซึ่งจัดเตรียม shardCount ที่พยายามเรียกใช้ด้วย

วิธีการที่ได้รับการป้องกัน

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)

ใช้ความพยายามอย่างเต็มที่ในการดึงข้อความอธิบายสั้นๆ ที่มีความหมายสำหรับ Exception ที่กำหนด

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

ลบตัวกรองรวมทั้งหมดที่ติดตามอยู่ในปัจจุบัน

รับอาบี

public IAbi getAbi ()

การส่งคืน
IAbi

getAfterTestCmd

public  getAfterTestCmd ()

รับคำสั่งเชลล์เพื่อทำงานหลังจาก Gtest

การส่งคืน

getBeforeTestCmd

public  getBeforeTestCmd ()

รับคำสั่งเชลล์เพื่อทำงานก่อน Gtest

การส่งคืน

getExcludeFilters

public  getExcludeFilters ()

ส่งกลับ ERROR(/Set) ปัจจุบันของตัวกรองที่แยกออก

การส่งคืน

getFileExclusionFilterRegex.getFileExclusionFilterRegex

public  getFileExclusionFilterRegex ()

รับ regex เพื่อแยกไฟล์บางไฟล์ออกจากการดำเนินการ

การส่งคืน

getGTestFlags

public  getGTestFlags ()

รับค่าแฟล็กเพิ่มเติมเพื่อส่งผ่านไปยังคำสั่งเชลล์ของการทดสอบเนทิฟ

การส่งคืน

getIncludeFilters

public  getIncludeFilters ()

ส่งกลับ ERROR(/Set) ปัจจุบันของตัวกรองรวม

การส่งคืน

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

เซตอาบี

public void setAbi (IAbi abi)

พารามิเตอร์
abi IAbi

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

แยก

public  split (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