GTestBase
public abstract class GTestBase
extends Object
implements IRemoteTest , IConfigurationReceiver , ITestFilterReceiver , IRuntimeHintProvider , ITestCollector , IShardableTest , IAbiReceiver
java.lang.Objek | |
↳ | com.android.tradefed.testtype.GTestBase |
Kelas dasar gTest
Ringkasan
Bidang | |
---|---|
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
|
Konstruktor publik | |
---|---|
GTestBase () |
Metode publik | |
---|---|
void | addAllExcludeFilters ( filters) addAllExcludeFilters ( filters) Menambahkan |
void | addAllIncludeFilters ( filters) addAllIncludeFilters ( filters) Menambahkan |
void | addExcludeFilter (String filter) Menambahkan filter yang pengujiannya akan dikecualikan. |
void | addIncludeFilter (String filter) Menambahkan filter yang akan menyertakan pengujian. |
String | cleanFilter (String filter) |
void | clearExcludeFilters () Hapus semua filter kecualikan yang saat ini dilacak. |
void | clearIncludeFilters () Hapus semua filter sertakan yang saat ini dilacak. |
IAbi | getAbi () |
getAfterTestCmd () Mendapat perintah shell untuk dijalankan setelah GTest. | |
getBeforeTestCmd () Mendapat perintah shell untuk dijalankan sebelum GTest. | |
getExcludeFilters () Mengembalikan | |
getFileExclusionFilterRegex () Mendapat regex untuk mengecualikan file tertentu dari eksekusi. | |
getGTestFlags () Mendapat nilai bendera tambahan untuk diteruskan ke perintah shell pengujian asli. | |
getIncludeFilters () Mengembalikan | |
long | getMaxTestTimeMs () Mendapat waktu maksimal untuk menjalankan gtest. |
String | getModuleName () Jalankan modul pengujian asli Android. |
boolean | getRunDisabledTests () Dapatkan apakah GTest harus menjalankan tes yang dinonaktifkan. |
long | getRuntimeHint () Kembalikan runtime pengujian yang diharapkan dalam milidetik. |
int | getShardCount () Mengembalikan hitungan pecahan saat ini. |
int | getShardIndex () Mendapat indeks pecahan dari pengujian ini. |
String | getTestFilterKey () Mendapat kunci filter pengujian. |
String | getTestModule () Mendapat nama modul. |
boolean | isCollectTestsOnly () Mendapat hanya memanggil biner uji untuk mengumpulkan daftar kasus uji yang berlaku atau tidak. |
boolean | isEnableXmlOutput () Dapatkan gunakan gtest xml output untuk hasil tes atau tidak. |
boolean | isSharded () Mendapat bendera isSharded. |
void | setAbi ( IAbi abi) |
void | setCollectTestsOnly (boolean shouldCollectTest) Mengaktifkan atau menonaktifkan mode pengumpulan pengujian |
void | setConfiguration ( IConfiguration configuration) Menyuntikkan |
void | setModuleName (String moduleName) Setel modul pengujian asli Android untuk dijalankan. |
void | setShardCount (int shardCount) Menetapkan jumlah pecahan dari pengujian ini. |
void | setShardIndex (int shardIndex) Menetapkan indeks pecahan dari pengujian ini. |
split (int shardCountHint) Versi alternatif dari |
Metode yang dilindungi | |
---|---|
String | createFlagFile (String filter) Buat file yang berisi filter yang akan digunakan melalui --gtest_flagfile untuk menghindari batasan OS dalam ukuran args. |
void | erasePrependedFileName ( filters, String filename) erasePrependedFileName ( filters, String filename) |
String | getAllGTestFlags (String path) Helper untuk mendapatkan semua flag GTest untuk diteruskan ke perintah adb shell. |
IConfiguration | getConfiguration () Mengembalikan konfigurasi pengujian. |
String | getExceptionMessage (Exception e) Lakukan upaya terbaik untuk mengambil pesan deskriptif singkat yang bermakna untuk |
String | getGTestCmdLine (String fullPath, String flags) Metode pembantu untuk membangun perintah gtest untuk dijalankan. |
String | getGTestCmdLineWrapper (String fullPath, String flags) Pembantu yang memungkinkan kelas turunan untuk membungkus perintah gtest di bawah beberapa alat lain (chroot, strace, gdb, dan sejenisnya). |
String | getGTestFilters (String path) Helper untuk menjalankan filter uji-g dari pengujian. |
ITestInvocationListener | getGTestListener ( ITestInvocationListener listener) Mengembalikan |
abstract String | loadFilter (String path) Tentukan metode filter get. |
void | setRunDisabled (boolean runDisabled) Setel apakah GTest harus menjalankan pengujian yang dinonaktifkan. |
Bidang
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
Konstruktor publik
GTestBase
public GTestBase ()
Metode publik
addAllExcludeFilters
public void addAllExcludeFilters (filters)
Menambahkan ERROR(/Set)
filter yang akan dikecualikan dari pengujian.
Parameter | |
---|---|
filters |
addAllIncludeFilters
public void addAllIncludeFilters (filters)
Menambahkan ERROR(/Set)
filter yang akan disertakan pengujiannya.
Parameter | |
---|---|
filters |
addExcludeFilter
public void addExcludeFilter (String filter)
Menambahkan filter yang pengujiannya akan dikecualikan.
Parameter | |
---|---|
filter | String |
addIncludeFilter
public void addIncludeFilter (String filter)
Menambahkan filter yang akan menyertakan pengujian.
Parameter | |
---|---|
filter | String |
cleanFilter
public String cleanFilter (String filter)
Parameter | |
---|---|
filter | String |
Pengembalian | |
---|---|
String |
clearExcludeFilters
public void clearExcludeFilters ()
Hapus semua filter kecualikan yang saat ini dilacak.
clearIncludeFilters
public void clearIncludeFilters ()
Hapus semua filter sertakan yang saat ini dilacak.
getAfterTestCmd
publicgetAfterTestCmd ()
Mendapat perintah shell untuk dijalankan setelah GTest.
Pengembalian | |
---|---|
getBeforeTestCmd
publicgetBeforeTestCmd ()
Mendapat perintah shell untuk dijalankan sebelum GTest.
Pengembalian | |
---|---|
getExcludeFilters
publicgetExcludeFilters ()
Mengembalikan ERROR(/Set)
filter pengecualian saat ini.
Pengembalian | |
---|---|
getFileExclusionFilterRegex
publicgetFileExclusionFilterRegex ()
Mendapat regex untuk mengecualikan file tertentu dari eksekusi.
Pengembalian | |
---|---|
getGTestFlags
publicgetGTestFlags ()
Mendapat nilai bendera tambahan untuk diteruskan ke perintah shell pengujian asli.
Pengembalian | |
---|---|
getIncludeFilters
publicgetIncludeFilters ()
Mengembalikan ERROR(/Set)
filter penyertaan saat ini.
Pengembalian | |
---|---|
getMaxTestTimeMs
public long getMaxTestTimeMs ()
Mendapat waktu maksimal untuk menjalankan gtest.
Pengembalian | |
---|---|
long |
getModuleName
public String getModuleName ()
Jalankan modul pengujian asli Android.
Pengembalian | |
---|---|
String | nama modul pengujian asli yang akan dijalankan, atau null jika tidak disetel |
getRunDisabledTests
public boolean getRunDisabledTests ()
Dapatkan apakah GTest harus menjalankan tes yang dinonaktifkan.
Pengembalian | |
---|---|
boolean | Benar jika pengujian yang dinonaktifkan harus dijalankan, salah jika sebaliknya |
getRuntimeHint
public long getRuntimeHint ()
Kembalikan runtime pengujian yang diharapkan dalam milidetik. Waktu digunakan untuk memuat eksekusi balance sharded
Pengembalian | |
---|---|
long |
getShardCount
public int getShardCount ()
Mengembalikan hitungan pecahan saat ini.
Pengembalian | |
---|---|
int |
getShardIndex
public int getShardIndex ()
Mendapat indeks pecahan dari pengujian ini.
Pengembalian | |
---|---|
int |
getTestFilterKey
public String getTestFilterKey ()
Mendapat kunci filter pengujian.
Pengembalian | |
---|---|
String |
getTestModule
public String getTestModule ()
Mendapat nama modul.
Pengembalian | |
---|---|
String |
isCollectTestsOnly
public boolean isCollectTestsOnly ()
Mendapat hanya memanggil biner uji untuk mengumpulkan daftar kasus uji yang berlaku atau tidak.
Pengembalian | |
---|---|
boolean |
isEnableXmlOutput
public boolean isEnableXmlOutput ()
Dapatkan gunakan gtest xml output untuk hasil tes atau tidak.
Pengembalian | |
---|---|
boolean |
isSharded
public boolean isSharded ()
Mendapat bendera isSharded.
Pengembalian | |
---|---|
boolean |
setCollectTestsOnly
public void setCollectTestsOnly (boolean shouldCollectTest)
Mengaktifkan atau menonaktifkan mode pengumpulan pengujian
setConfiguration
public void setConfiguration (IConfiguration configuration)
Menyuntikkan IConfiguration
yang sedang digunakan.
Parameter | |
---|---|
configuration | IConfiguration |
setModuleName
public void setModuleName (String moduleName)
Setel modul pengujian asli Android untuk dijalankan.
Parameter | |
---|---|
moduleName | String : Nama modul pengujian asli yang akan dijalankan |
setShardCount
public void setShardCount (int shardCount)
Menetapkan jumlah pecahan dari pengujian ini.
Parameter | |
---|---|
shardCount | int |
setShardIndex
public void setShardIndex (int shardIndex)
Menetapkan indeks pecahan dari pengujian ini.
Parameter | |
---|---|
shardIndex | int |
membelah
publicsplit (int shardCountHint)
Versi alternatif dari split()
yang juga menyediakan shardCount yang dicoba untuk dijalankan. Ini berguna untuk beberapa pelari uji yang terkadang tidak dapat memutuskan secara sewenang-wenang.
Parameter | |
---|---|
shardCountHint | int : jumlah shard yang dicoba. |
Pengembalian | |
---|---|
kumpulan subtes yang akan dieksekusi secara terpisah atau null jika tes saat ini tidak dapat di-shardable |
Metode yang dilindungi
buatFlagFile
protected String createFlagFile (String filter)
Buat file yang berisi filter yang akan digunakan melalui --gtest_flagfile untuk menghindari batasan OS dalam ukuran args.
Parameter | |
---|---|
filter | String : String filter |
Pengembalian | |
---|---|
String | Jalur ke file yang berisi filter. |
Melempar | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
hapusNamaBerkas yang Disiapkan
protected void erasePrependedFileName (filters, String filename)
Parameter | |
---|---|
filters | |
filename | String |
getAllGTestFlags
protected String getAllGTestFlags (String path)
Helper untuk mendapatkan semua flag GTest untuk diteruskan ke perintah adb shell.
Parameter | |
---|---|
path | String : path lengkap dari biner pada perangkat. |
Pengembalian | |
---|---|
String | ERROR(/String) dari semua flag GTest yang harus diteruskan ke GTest |
Melempar | |
---|---|
DeviceNotAvailableException |
getConfiguration
protected IConfiguration getConfiguration ()
Mengembalikan konfigurasi pengujian.
Pengembalian | |
---|---|
IConfiguration | konfigurasi I |
getExceptionMessage
protected String getExceptionMessage (Exception e)
Lakukan upaya terbaik untuk mengambil pesan deskriptif singkat yang bermakna untuk ERROR(/Exception)
yang diberikan
Parameter | |
---|---|
e | Exception : ERROR(/Exception) |
Pengembalian | |
---|---|
String | sebuah pesan singkat |
getGTestCmdLine
protected String getGTestCmdLine (String fullPath, String flags)
Metode pembantu untuk membangun perintah gtest untuk dijalankan.
Parameter | |
---|---|
fullPath | String : jalur sistem file absolut ke biner gtest pada perangkat |
flags | String : flag eksekusi gtest |
Pengembalian | |
---|---|
String | baris perintah shell untuk dijalankan untuk gtest |
getGTestCmdLineWrapper
protected String getGTestCmdLineWrapper (String fullPath, String flags)
Pembantu yang memungkinkan kelas turunan untuk membungkus perintah gtest di bawah beberapa alat lain (chroot, strace, gdb, dan sejenisnya).
Parameter | |
---|---|
fullPath | String |
flags | String |
Pengembalian | |
---|---|
String |
getGTestFilters
protected String getGTestFilters (String path)
Helper untuk menjalankan filter uji-g dari pengujian.
Perhatikan bahwa filter memfilter hanya pada nama fungsi (mis: Google Test "Test"); semua "Uji Kasus" Uji Google akan dipertimbangkan.
Parameter | |
---|---|
path | String : path lengkap dari biner pada perangkat. |
Pengembalian | |
---|---|
String | flag filter lengkap untuk lolos ke uji-g, atau string kosong jika tidak ada yang ditentukan |
Melempar | |
---|---|
DeviceNotAvailableException |
getGTestListener
protected ITestInvocationListener getGTestListener (ITestInvocationListener listener)
Mengembalikan GTestListener
yang menyediakan info debug tambahan, seperti mendeteksi dan melaporkan pengujian duplikat jika mDisabledDuplicateCheck salah. Jika tidak, kembalikan pendengar yang diteruskan.
Parameter | |
---|---|
listener | ITestInvocationListener |
Pengembalian | |
---|---|
ITestInvocationListener |
loadFilter
protected abstract String loadFilter (String path)
Tentukan metode filter get.
Sub kelas harus menerapkan cara mendapatkan filternya sendiri.
Parameter | |
---|---|
path | String : path lengkap dari file filter. |
Pengembalian | |
---|---|
String | rangkaian saringan. |
Melempar | |
---|---|
DeviceNotAvailableException |
setRunDisabled
protected void setRunDisabled (boolean runDisabled)
Setel apakah GTest harus menjalankan pengujian yang dinonaktifkan.
Parameter | |
---|---|
runDisabled | boolean |