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(Set<String> filters)

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

void addAllIncludeFilters(Set<String> filters)

เพิ่ม Set ของตัวกรองที่ระบุการทดสอบที่จะรวม

void addExcludeFilter(String filter)

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

void addIncludeFilter(String filter)

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

String cleanFilter(String filter)
void clearExcludeFilters()

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

void clearIncludeFilters()

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

IAbi getAbi()
List<String> getAfterTestCmd()

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

List<String> getBeforeTestCmd()

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

Set<String> getExcludeFilters()

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

Set<String> getFileExclusionFilterRegex()

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

List<String> getGTestFlags()

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

Set<String> getIncludeFilters()

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

long getMaxTestTimeMs()

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

String getModuleName()

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

boolean getRunDisabledTests()

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

long getRuntimeHint()

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

int getShardCount()

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

int getShardIndex()

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

String getTestFilterKey()

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

String getTestModule()

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

boolean isCollectTestsOnly()

Gets only invoke the test binary to collect list of applicable test cases or not.

boolean isEnableXmlOutput()

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

boolean isSharded()

รับแฟล็ก isSharded

void notifyTestExecution(boolean incompleteTestFound, Set<String> 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 ของการทดสอบนี้

Collection<IRemoteTest> split(int shardCountHint)

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

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

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

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

void erasePrependedFileName(Set<String> 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 (Set<String> filters)

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

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

addAllIncludeFilters

public void addAllIncludeFilters (Set<String> filters)

เพิ่ม Set ของตัวกรองที่ระบุการทดสอบที่จะรวม

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

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 List<String> getAfterTestCmd ()

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

การคืนสินค้า
List<String>

getBeforeTestCmd

public List<String> getBeforeTestCmd ()

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

การคืนสินค้า
List<String>

getExcludeFilters

public Set<String> getExcludeFilters ()

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

การคืนสินค้า
Set<String>

getFileExclusionFilterRegex

public Set<String> getFileExclusionFilterRegex ()

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

การคืนสินค้า
Set<String>

getGTestFlags

public List<String> getGTestFlags ()

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

การคืนสินค้า
List<String>

getIncludeFilters

public Set<String> getIncludeFilters ()

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

การคืนสินค้า
Set<String>

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

Gets only invoke the test binary to collect list of applicable test cases or not.

การคืนสินค้า
boolean

isEnableXmlOutput

public boolean isEnableXmlOutput ()

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

การคืนสินค้า
boolean

isSharded

public boolean isSharded ()

รับแฟล็ก isSharded

การคืนสินค้า
boolean

notifyTestExecution

public void notifyTestExecution (boolean incompleteTestFound, 
                Set<String> failedTests)

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

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

failedTests Set

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 Collection<IRemoteTest> split (int shardCountHint)

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

พารามิเตอร์
shardCountHint int: จำนวนชาร์ดที่พยายาม
การคืนสินค้า
Collection<IRemoteTest> ชุดการทดสอบย่อยที่จะดำเนินการแยกกันหรือ 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 (Set<String> filters, 
                String filename)

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

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 บรรทัดคำสั่งของ Shell ที่จะเรียกใช้สำหรับ 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