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

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)

ตัวช่วยรับตัวกรอง 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

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

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

getAbi

public IAbi getAbi ()

คืนสินค้า
IAbi

getAfterTestCmd

public  getAfterTestCmd ()

รับคำสั่งเชลล์ให้รันหลังจาก GTest

คืนสินค้า

getBeforeTestCmd

public  getBeforeTestCmd ()

รับคำสั่งเชลล์ให้รันก่อน GTest

คืนสินค้า

getExcludeFilters

public  getExcludeFilters ()

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

คืนสินค้า

getFileExclusionFilterRegex

public  getFileExclusionFilterRegex ()

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

คืนสินค้า

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

ส่งคืนรันไทม์ที่คาดไว้ของการทดสอบในหน่วยมิลลิวินาที เวลาที่ใช้ในการโหลดบาลานซ์ชาร์ด 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

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 หากปัจจุบันยังไม่สามารถแบ่งการทดสอบได้

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

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