GTestBase

public abstract class GTestBase
extends Object implements IAbiReceiver, IConfigurationReceiver, IRemoteTest, IRuntimeHintProvider, IShardableTest, ITestCollector, ITestFilterReceiver

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)

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

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

รับนิพจน์ทั่วไปเพื่อยกเว้นบางไฟล์ไม่ให้ดำเนินการ

getGTestFlags()

รับค่า Flag เพิ่มเติมเพื่อส่งไปยังคําสั่ง Shell ของทดสอบเนทีฟ

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

ใช้เอาต์พุต XML ของ gtest สำหรับผลการทดสอบหรือไม่

boolean isSharded()

รับ Flag isSharded

void 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 convertName(String gtestFlagName)
String createFlagFile(String filter)

สร้างไฟล์ที่มีตัวกรองที่จะใช้ผ่าน --gtest_flagfile เพื่อหลีกเลี่ยงข้อจำกัดด้านขนาดของอาร์กิวเมนต์ในระบบปฏิบัติการ

void erasePrependedFileName( filters, String filename)
String getAllGTestFlags(String path)

ตัวช่วยรับ Flag ทั้งหมดของ 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... listeners)

แสดงผล GTestListener ที่ให้ข้อมูลการแก้ไขข้อบกพร่องเพิ่มเติม เช่น ตรวจหาและรายงานการทดสอบที่ซ้ำกันหาก mDisabledDuplicateCheck เป็นเท็จ

abstract String loadFilter(String path)

กำหนดเมธอดตัวกรอง get

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

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

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

getAbi

public IAbi getAbi ()

คิกรีเทิร์น
IAbi

getAfterTestCmd

public  getAfterTestCmd ()

รับคําสั่งเชลล์ที่จะเรียกใช้หลังจาก GTest

คิกรีเทิร์น

getBeforeTestCmd

public  getBeforeTestCmd ()

รับคําสั่งเชลล์ที่จะเรียกใช้ก่อน GTest

คิกรีเทิร์น

getExcludeFilters

public  getExcludeFilters ()

แสดงผล ERROR(/Set) ของตัวกรองการยกเว้นปัจจุบัน

คิกรีเทิร์น

getFileExclusionFilterRegex

public  getFileExclusionFilterRegex ()

รับนิพจน์ทั่วไปเพื่อยกเว้นบางไฟล์ไม่ให้ทำงาน

คิกรีเทิร์น

getGTestFlags

public  getGTestFlags ()

รับค่า Flag เพิ่มเติมเพื่อส่งไปยังคําสั่ง Shell ของทดสอบเนทีฟ

คิกรีเทิร์น

getIncludeFilters

public  getIncludeFilters ()

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

คิกรีเทิร์น

getMaxTestTimeMs

public long getMaxTestTimeMs ()

รับเวลาสูงสุดที่ gtest จะทํางาน

คิกรีเทิร์น
long

getModuleName

public String getModuleName ()

เรียกใช้โมดูลทดสอบเนทีฟของ Android

คิกรีเทิร์น
String ชื่อของโมดูลการทดสอบแบบเนทีฟที่จะเรียกใช้ หรือเป็นค่าว่างหากไม่ได้ตั้งค่า

getRunDisabledTests

public boolean getRunDisabledTests ()

ดูว่า GTest ควรเรียกใช้การทดสอบที่ปิดใช้หรือไม่

คิกรีเทิร์น
boolean เป็นจริงหากควรเรียกใช้การทดสอบที่ปิดใช้ หรือไม่เช่นนั้นจะเป็นเท็จ

getRuntimeHint

public long getRuntimeHint ()

แสดงรันไทม์ที่คาดไว้ของการทดสอบเป็นมิลลิวินาที ระบบจะใช้เวลานี้เพื่อจัดสรรภาระงานให้กับการดำเนินการแบบแยกกลุ่ม

คิกรีเทิร์น
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

isSharded

public boolean isSharded ()

รับ Flag isSharded

คิกรีเทิร์น
boolean

notifyTestExecution

public void notifyTestExecution (boolean incompleteTestFound, 
                 failedTests)

แจ้งให้ผู้ปกครองทราบเกี่ยวกับการเรียกใช้การทดสอบเพื่อให้จัดการตัวกรองการรวม/การยกเว้นได้อย่างถูกต้องสำหรับการพยายามอีกครั้ง

พารามิเตอร์
incompleteTestFound boolean

failedTests

setAbi

public void setAbi (IAbi abi)

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

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

แยก

public  split (int shardCountHint)

split() เวอร์ชันอื่น ซึ่งระบุ shardCount ที่พยายามเรียกใช้ด้วย ซึ่งมีประโยชน์สำหรับโปรแกรมทดสอบบางรายการที่ตัดสินใจแบบตามอำเภอใจไม่ได้ในบางครั้ง

พารามิเตอร์
shardCountHint int: จํานวนชาร์ดที่พยายาม
คิกรีเทิร์น
ชุดการทดสอบย่อยที่จะเรียกใช้แยกกัน หรือ null หากการทดสอบไม่สามารถแบ่งกลุ่มได้ในขณะนี้

วิธีการที่มีการป้องกัน

convertName

protected String convertName (String gtestFlagName)

พารามิเตอร์
gtestFlagName String

คิกรีเทิร์น
String

createFlagFile

protected String createFlagFile (String filter)

สร้างไฟล์ที่มีตัวกรองที่จะใช้ผ่าน --gtest_flagfile เพื่อหลีกเลี่ยงข้อจำกัดด้านขนาดของอาร์กิวเมนต์ในระบบปฏิบัติการ

พารามิเตอร์
filter String: สตริงตัวกรอง
คิกรีเทิร์น
String เส้นทางไปยังไฟล์ที่มีตัวกรอง
การโยน
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

erasePrependedFileName

protected void erasePrependedFileName ( filters, 
                String filename)

พารามิเตอร์
filters

filename String

getAllGTestFlags

protected String getAllGTestFlags (String path)

ตัวช่วยรับ Flag ทั้งหมดของ GTest เพื่อส่งไปยังคำสั่ง adb shell

พารามิเตอร์
path String: เส้นทางแบบเต็มของไบนารีในอุปกรณ์
คิกรีเทิร์น
String String ของ Flag ทั้งหมดของ GTest ที่ควรส่งไปยัง GTest
การโยน
DeviceNotAvailableException

getConfiguration

protected IConfiguration getConfiguration ()

แสดงการกำหนดค่าการทดสอบ

คิกรีเทิร์น
IConfiguration IConfiguration

getExceptionMessage

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") ระบบจะพิจารณา "Test Case" ทั้งหมดของ Google Test

พารามิเตอร์
path String: เส้นทางแบบเต็มของไบนารีในอุปกรณ์
คิกรีเทิร์น
String Flag ตัวกรองแบบเต็มที่จะส่งไปยัง g-test หรือสตริงว่างหากไม่ได้ระบุ
การโยน
DeviceNotAvailableException

getGTestListener

protected ITestInvocationListener getGTestListener (ITestInvocationListener... listeners)

แสดงผล GTestListener ที่ให้ข้อมูลการแก้ไขข้อบกพร่องเพิ่มเติม เช่น ตรวจหาและรายงานการทดสอบที่ซ้ำกันหาก mDisabledDuplicateCheck เป็นเท็จ ไม่เช่นนั้น ระบบจะแสดงผล Listener ที่ส่งเข้ามา

พารามิเตอร์
listeners ITestInvocationListener

คิกรีเทิร์น
ITestInvocationListener

loadFilter

protected abstract String loadFilter (String path)

กำหนดเมธอดตัวกรอง get

คลาสย่อยต้องติดตั้งใช้งานวิธีรับตัวกรองของตัวเอง

พารามิเตอร์
path String: เส้นทางแบบเต็มของไฟล์ตัวกรอง
คิกรีเทิร์น
String สตริงตัวกรอง
การโยน
DeviceNotAvailableException

setRunDisabled

protected void setRunDisabled (boolean runDisabled)

ตั้งค่าว่า GTest ควรเรียกใช้การทดสอบที่ปิดใช้หรือไม่

พารามิเตอร์
runDisabled boolean