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

รับคำสั่ง Shell เพื่อเรียกใช้หลังจาก GTest

getBeforeTestCmd()

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

getExcludeFilters()

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

getFileExclusionFilterRegex()

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

getGTestFlags()

รับค่าแฟล็กเพิ่มเติมเพื่อส่งไปยังคำสั่ง 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()

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

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)

กำหนดจำนวนชาร์ดของการทดสอบนี้

void setShardIndex(int shardIndex)

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

split(int shardCountHint)

เวอร์ชันทางเลือกของ split() ที่มี ShardCount ที่มีความพยายามด้วยเช่นกัน ที่จะเรียกใช้

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

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)

ตัวช่วยในการรับตัวกรอง 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 ()

วิธีการสาธารณะ

เพิ่มตัวกรองยกเว้น

public void addAllExcludeFilters ( filters)

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

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

addAllIncludeFilter

public void addAllIncludeFilters ( filters)

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

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

เพิ่มตัวกรองยกเว้น

public void addExcludeFilter (String filter)

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

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

เพิ่มIncludeFilter

public void addIncludeFilter (String filter)

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

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

ตัวกรองสะอาด

public String cleanFilter (String filter)

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

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

ล้างตัวกรองยกเว้น

public void clearExcludeFilters ()

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

ล้างตัวกรองรวม

public void clearIncludeFilters ()

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

GetAbi

public IAbi getAbi ()

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

getAfterTestCmd

public  getAfterTestCmd ()

รับคำสั่ง Shell เพื่อเรียกใช้หลังจาก GTest

คิกรีเทิร์น

getbeforeTestCmd

public  getBeforeTestCmd ()

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

คิกรีเทิร์น

รับตัวกรองยกเว้น

public  getExcludeFilters ()

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

คิกรีเทิร์น

getFileExclusionFilterRegex

public  getFileExclusionFilterRegex ()

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

คิกรีเทิร์น

getGTestFlags

public  getGTestFlags ()

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

คิกรีเทิร์น

รับตัวกรองรวม

public  getIncludeFilters ()

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

คิกรีเทิร์น

getMaxTestTimeMs

public long getMaxTestTimeMs ()

รับเวลาสูงสุดในการเรียกใช้ gtest

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

ชื่อโมดูล

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

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

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

เป็นเปิดใช้เอาต์พุต XML

public boolean isEnableXmlOutput ()

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

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

ชาร์ด

public boolean isSharded ()

รับแฟล็ก isSharded

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

AlertTestExecution

public void notifyTestExecution (boolean incompleteTestFound, 
                 failedTests)

แจ้งระดับบนสุดของการดำเนินการทดสอบเพื่อให้จัดการตัวกรองการรวม/การยกเว้นได้อย่างเหมาะสม สำหรับการลองใหม่

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

failedTests

SetAbi

public void setAbi (IAbi abi)

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

ตั้งค่า CollectTestsOnly

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

ตั้งค่าShardIndex

public void setShardIndex (int shardIndex)

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

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

แยก

public  split (int shardCountHint)

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

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

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

createFlagFile

protected String createFlagFile (String filter)

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

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

ลบชื่อไฟล์ที่แทรกไว้ล่วงหน้า

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

getGTestCmdLineWrapper

protected String getGTestCmdLineWrapper (String fullPath, 
                String flags)

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

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

flags String

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

ตัวกรอง getGTest

protected String getGTestFilters (String path)

ตัวช่วยในการรับตัวกรอง g-test ของการทดสอบเพื่อทำงาน

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

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