GTestBase

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

java.lang.Object
   ↳ com.android.tradefed.testtype.GTestBase

คลาสพื้นฐานของ gTest

สรุป

ค่าคงที่

String FILTER_EXTENSION

String GTEST_FLAG_FILE

String GTEST_FLAG_FILTER

String GTEST_FLAG_LIST_TESTS

String GTEST_FLAG_PRINT_TIME

String GTEST_FLAG_RUN_DISABLED_TESTS

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

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

getIncludeFilters()

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

long getMaxTestTimeMs()

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

String getModuleName()

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

boolean getRunDisabledTests()

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

long getRuntimeHint()

แสดงระยะเวลาการทำงานที่คาดไว้ของการทดสอบเป็นมิลลิวินาที

int getShardCount()

แสดงผลจำนวน Shard ปัจจุบัน

int getShardIndex()

รับดัชนี Shard ของการทดสอบนี้

String getTestFilterKey()

รับคีย์ตัวกรองการทดสอบ

String getTestModule()

รับชื่อโมดูล

boolean isCollectTestsOnly()

รับเฉพาะการเรียกใช้ไบนารีทดสอบเพื่อรวบรวมรายการกรณีทดสอบที่เกี่ยวข้องหรือไม่

boolean isEnableXmlOutput()

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

boolean isSharded()

รับแฟล็ก 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)

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

void setShardIndex(int shardIndex)

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

split(int shardCountHint)

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

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

String convertName(String gtestFlagName)
String createFlagFile(String filter)

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

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

ฟังก์ชันช่วยในการรับแฟล็ก GTest ทั้งหมดเพื่อส่งไปยังคำสั่ง adb shell

IConfiguration getConfiguration()

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

String getExceptionMessage(Exception e)

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

String getGTestCmdLine(String fullPath, String flags)

เมธอด Helper เพื่อสร้างคำสั่ง gtest ที่จะเรียกใช้

String getGTestCmdLineWrapper(String fullPath, String flags)

Helper ซึ่งช่วยให้คลาสที่ได้มาสามารถห่อหุ้มคำสั่ง gtest ไว้ภายใต้เครื่องมืออื่นๆ (chroot, strace, gdb และอื่นๆ ที่คล้ายกัน)

String getGTestFilters(String path)

Helper to get the g-test filter of test to run.

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

ค่าคงที่: ".filter"

GTEST_FLAG_FILE

protected static final String GTEST_FLAG_FILE

ค่าคงที่ "--gtest_flagfile"

GTEST_FLAG_FILTER

protected static final String GTEST_FLAG_FILTER

ค่าคงที่ "--gtest_filter"

GTEST_FLAG_LIST_TESTS

protected static final String GTEST_FLAG_LIST_TESTS

ค่าคงที่ "--gtest_list_tests"

GTEST_FLAG_PRINT_TIME

protected static final String GTEST_FLAG_PRINT_TIME

ค่าคงที่ "--gtest_print_time"

GTEST_FLAG_RUN_DISABLED_TESTS

protected static final String GTEST_FLAG_RUN_DISABLED_TESTS

ค่าคงที่: "--gtest_also_run_disabled_tests"

GTEST_XML_OUTPUT

protected static final String GTEST_XML_OUTPUT

ค่าคงที่: "--gtest_output=xml:%s"

เครื่องมือสร้างสาธารณะ

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

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

คิกรีเทิร์น

getIncludeFilters

public  getIncludeFilters ()

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

คิกรีเทิร์น

getMaxTestTimeMs

public long getMaxTestTimeMs ()

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

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

getModuleName

public String getModuleName ()

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

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

getRunDisabledTests

public boolean getRunDisabledTests ()

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

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

getRuntimeHint

public long getRuntimeHint ()

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

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

getShardCount

public int getShardCount ()

แสดงผลจำนวน Shard ปัจจุบัน

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

getShardIndex

public int getShardIndex ()

รับดัชนี Shard ของการทดสอบนี้

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

getTestFilterKey

public String getTestFilterKey ()

รับคีย์ตัวกรองการทดสอบ

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

getTestModule

public String getTestModule ()

รับชื่อโมดูล

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

isCollectTestsOnly

public boolean isCollectTestsOnly ()

รับเฉพาะการเรียกใช้ไบนารีทดสอบเพื่อรวบรวมรายการกรณีทดสอบที่เกี่ยวข้องหรือไม่

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

isEnableXmlOutput

public boolean isEnableXmlOutput ()

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

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

isSharded

public boolean isSharded ()

รับค่าสถานะ 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)

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

พารามิเตอร์
shardCount int

setShardIndex

public void setShardIndex (int shardIndex)

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

พารามิเตอร์
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)

ฟังก์ชันช่วยในการรับแฟล็ก GTest ทั้งหมดเพื่อส่งไปยังคำสั่ง adb shell

พารามิเตอร์
path String: เส้นทางแบบเต็มของไบนารีในอุปกรณ์
คิกรีเทิร์น
String Stringของแฟล็ก 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)

เมธอด Helper เพื่อสร้างคำสั่ง gtest ที่จะเรียกใช้

พารามิเตอร์
fullPath String: เส้นทางระบบไฟล์แบบสัมบูรณ์ไปยังไบนารี gtest ในอุปกรณ์
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)

Helper to get the g-test filter of test to run.

โปรดทราบว่าตัวกรองจะกรองเฉพาะชื่อฟังก์ชัน (เช่น Google Test "Test") ระบบจะพิจารณา Google Test "Test Cases" ทั้งหมด

พารามิเตอร์
path String: เส้นทางแบบเต็มของไบนารีในอุปกรณ์
คิกรีเทิร์น
String แฟล็กตัวกรองแบบเต็มเพื่อส่งไปยัง 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