Basis GTest
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 pengujian mana yang akan dikecualikan. |
void | addIncludeFilter (String filter) Menambahkan filter pengujian mana yang akan disertakan. |
String | cleanFilter (String filter) |
void | clearExcludeFilters () Hapus semua filter pengecualian yang saat ini dilacak. |
void | clearIncludeFilters () Hapus semua filter penyertaan yang saat ini dilacak. |
IAbi | getAbi () |
getAfterTestCmd () Mendapatkan perintah shell untuk dijalankan setelah GTest. | |
getBeforeTestCmd () Mendapatkan perintah shell untuk dijalankan sebelum GTest. | |
getExcludeFilters () Mengembalikan | |
getFileExclusionFilterRegex () Mendapatkan regex untuk mengecualikan file tertentu agar tidak dieksekusi. | |
getGTestFlags () Mendapatkan nilai tanda tambahan untuk diteruskan ke perintah shell pengujian asli. | |
getIncludeFilters () Mengembalikan | |
long | getMaxTestTimeMs () Mendapatkan waktu maksimal untuk menjalankan gtest. |
String | getModuleName () Jalankan modul pengujian asli Android. |
boolean | getRunDisabledTests () Cari tahu apakah GTest harus menjalankan pengujian yang dinonaktifkan. |
long | getRuntimeHint () Menampilkan perkiraan waktu proses pengujian dalam milidetik. |
int | getShardCount () Mengembalikan jumlah pecahan saat ini. |
int | getShardIndex () Mendapatkan indeks pecahan dari pengujian ini. |
String | getTestFilterKey () Mendapatkan kunci filter uji. |
String | getTestModule () Mendapatkan nama modul. |
boolean | isCollectTestsOnly () Hanya akan memanggil biner pengujian untuk mengumpulkan daftar kasus pengujian yang berlaku atau tidak. |
boolean | isEnableXmlOutput () Dapat menggunakan keluaran gtest xml untuk hasil tes atau tidak. |
boolean | isSharded () Mendapat bendera isSharded. |
void | notifyTestExecution (boolean incompleteTestFound, failedTests) notifyTestExecution (boolean incompleteTestFound, failedTests) Beritahukan orang tua mengenai pelaksanaan pengujian, sehingga filter penyertaan/pengecualian dapat ditangani dengan benar untuk upaya percobaan ulang. |
void | setAbi ( IAbi abi) |
void | setCollectTestsOnly (boolean shouldCollectTest) Mengaktifkan atau menonaktifkan mode pengumpulan pengujian |
void | setConfiguration ( IConfiguration configuration) Menyuntikkan |
void | setModuleName (String moduleName) Atur modul pengujian asli Android untuk dijalankan. |
void | setShardCount (int shardCount) Menetapkan jumlah pecahan pengujian ini. |
void | setShardIndex (int shardIndex) Menetapkan indeks pecahan pengujian ini. |
split (int shardCountHint) Versi alternatif |
Metode yang dilindungi | |
---|---|
String | createFlagFile (String filter) Buat file yang berisi filter yang akan digunakan melalui --gtest_flagfile untuk menghindari batasan OS dalam ukuran argumen. |
void | erasePrependedFileName ( filters, String filename) erasePrependedFileName ( filters, String filename) |
String | getAllGTestFlags (String path) Pembantu untuk mendapatkan semua tanda 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 membuat perintah gtest untuk dijalankan. |
String | getGTestCmdLineWrapper (String fullPath, String flags) Helper yang memungkinkan kelas turunan untuk menggabungkan perintah gtest di bawah beberapa alat lain (chroot, strace, gdb, dan sejenisnya). |
String | getGTestFilters (String path) Pembantu untuk menjalankan filter uji g-test. |
ITestInvocationListener | getGTestListener ( ITestInvocationListener listener) Mengembalikan GTestListener yang memberikan info debug tambahan, seperti mendeteksi dan melaporkan pengujian duplikat jika mDisabledDuplicationCheck salah. |
abstract String | loadFilter (String path) Tentukan metode dapatkan filter. |
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
Basis GTest
public GTestBase ()
Metode publik
tambahkanAllExcludeFilters
public void addAllExcludeFilters (filters)
Menambahkan ERROR(/Set)
filter yang pengujiannya akan dikecualikan.
Parameter | |
---|---|
filters |
addAllIncludeFilters
public void addAllIncludeFilters (filters)
Menambahkan ERROR(/Set)
filter yang pengujiannya akan disertakan.
Parameter | |
---|---|
filters |
tambahkanExcludeFilter
public void addExcludeFilter (String filter)
Menambahkan filter pengujian mana yang akan dikecualikan.
Parameter | |
---|---|
filter | String |
tambahkanIncludeFilter
public void addIncludeFilter (String filter)
Menambahkan filter pengujian mana yang akan disertakan.
Parameter | |
---|---|
filter | String |
filter bersih
public String cleanFilter (String filter)
Parameter | |
---|---|
filter | String |
Kembali | |
---|---|
String |
hapusExcludeFilters
public void clearExcludeFilters ()
Hapus semua filter pengecualian yang saat ini dilacak.
clearIncludeFilters
public void clearIncludeFilters ()
Hapus semua filter penyertaan yang saat ini dilacak.
dapatkanAfterTestCmd
publicgetAfterTestCmd ()
Mendapatkan perintah shell untuk dijalankan setelah GTest.
Kembali | |
---|---|
dapatkanBeforeTestCmd
publicgetBeforeTestCmd ()
Mendapatkan perintah shell untuk dijalankan sebelum GTest.
Kembali | |
---|---|
dapatkanExcludeFilters
publicgetExcludeFilters ()
Mengembalikan ERROR(/Set)
filter pengecualian saat ini.
Kembali | |
---|---|
getFileExclusionFilterRegex
publicgetFileExclusionFilterRegex ()
Mendapatkan regex untuk mengecualikan file tertentu agar tidak dieksekusi.
Kembali | |
---|---|
dapatkanGTestFlags
publicgetGTestFlags ()
Mendapatkan nilai tanda tambahan untuk diteruskan ke perintah shell pengujian asli.
Kembali | |
---|---|
dapatkanIncludeFilters
publicgetIncludeFilters ()
Mengembalikan ERROR(/Set)
filter penyertaan saat ini.
Kembali | |
---|---|
dapatkanMaxTestTimeMs
public long getMaxTestTimeMs ()
Mendapatkan waktu maksimal untuk menjalankan gtest.
Kembali | |
---|---|
long |
dapatkanModuleName
public String getModuleName ()
Jalankan modul pengujian asli Android.
Kembali | |
---|---|
String | nama modul pengujian asli yang akan dijalankan, atau null jika tidak disetel |
getRunDisabledTests
public boolean getRunDisabledTests ()
Cari tahu apakah GTest harus menjalankan pengujian yang dinonaktifkan.
Kembali | |
---|---|
boolean | Benar jika pengujian yang dinonaktifkan harus dijalankan, salah jika sebaliknya |
dapatkan RuntimeHint
public long getRuntimeHint ()
Menampilkan perkiraan waktu proses pengujian dalam milidetik. Waktu digunakan untuk memuat keseimbangan eksekusi sharded
Kembali | |
---|---|
long |
dapatkanShardCount
public int getShardCount ()
Mengembalikan jumlah pecahan saat ini.
Kembali | |
---|---|
int |
dapatkanShardIndex
public int getShardIndex ()
Mendapatkan indeks pecahan dari pengujian ini.
Kembali | |
---|---|
int |
dapatkanTestFilterKey
public String getTestFilterKey ()
Mendapatkan kunci filter uji.
Kembali | |
---|---|
String |
dapatkanTestModule
public String getTestModule ()
Mendapatkan nama modul.
Kembali | |
---|---|
String |
isCollectTestsOnly
public boolean isCollectTestsOnly ()
Hanya akan memanggil biner pengujian untuk mengumpulkan daftar kasus pengujian yang berlaku atau tidak.
Kembali | |
---|---|
boolean |
adalahEnableXmlOutput
public boolean isEnableXmlOutput ()
Dapat menggunakan keluaran gtest xml untuk hasil tes atau tidak.
Kembali | |
---|---|
boolean |
adalahSharded
public boolean isSharded ()
Mendapat bendera isSharded.
Kembali | |
---|---|
boolean |
beri tahuTestExecution
public void notifyTestExecution (boolean incompleteTestFound,failedTests)
Beritahukan orang tua mengenai pelaksanaan pengujian, sehingga filter penyertaan/pengecualian dapat ditangani dengan benar untuk upaya percobaan ulang.
Parameter | |
---|---|
incompleteTestFound | boolean |
failedTests |
setCollectTestsOnly
public void setCollectTestsOnly (boolean shouldCollectTest)
Mengaktifkan atau menonaktifkan mode pengumpulan pengujian
setKonfigurasi
public void setConfiguration (IConfiguration configuration)
Menyuntikkan IConfiguration
yang digunakan.
Parameter | |
---|---|
configuration | IConfiguration |
setModulNama
public void setModuleName (String moduleName)
Atur 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 pengujian ini.
Parameter | |
---|---|
shardCount | int |
setShardIndex
public void setShardIndex (int shardIndex)
Menetapkan indeks pecahan pengujian ini.
Parameter | |
---|---|
shardIndex | int |
membelah
publicsplit (int shardCountHint)
Versi alternatif split()
yang juga menyediakan shardCount yang dicoba dijalankan. Hal ini berguna untuk beberapa pelari tes yang terkadang tidak bisa mengambil keputusan secara sembarangan.
Parameter | |
---|---|
shardCountHint | int : jumlah pecahan yang dicoba. |
Kembali | |
---|---|
kumpulan subtes yang akan dieksekusi secara terpisah atau null jika tes saat ini tidak dapat di-sharding |
Metode yang dilindungi
buat File Bendera
protected String createFlagFile (String filter)
Buat file yang berisi filter yang akan digunakan melalui --gtest_flagfile untuk menghindari batasan OS dalam ukuran argumen.
Parameter | |
---|---|
filter | String : Rangkaian filter |
Kembali | |
---|---|
String | Jalur ke file yang berisi filter. |
Melempar | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
hapusPrependedFileName
protected void erasePrependedFileName (filters, String filename)
Parameter | |
---|---|
filters | |
filename | String |
dapatkanAllGTestFlags
protected String getAllGTestFlags (String path)
Pembantu untuk mendapatkan semua tanda GTest untuk diteruskan ke perintah adb shell.
Parameter | |
---|---|
path | String : jalur lengkap biner pada perangkat. |
Kembali | |
---|---|
String | String dari semua flag GTest yang harus diteruskan ke GTest |
Melempar | |
---|---|
DeviceNotAvailableException |
dapatkan Konfigurasi
protected IConfiguration getConfiguration ()
Mengembalikan konfigurasi pengujian.
Kembali | |
---|---|
IConfiguration | sebuah konfigurasi I |
getExceptionMessage
protected String getExceptionMessage (Exception e)
Lakukan upaya terbaik untuk mengambil pesan deskriptif singkat yang bermakna untuk Exception
yang diberikan
Parameter | |
---|---|
e | Exception : Exception |
Kembali | |
---|---|
String | sebuah pesan singkat |
dapatkanGTestCmdLine
protected String getGTestCmdLine (String fullPath, String flags)
Metode pembantu untuk membuat perintah gtest untuk dijalankan.
Parameter | |
---|---|
fullPath | String : jalur sistem file absolut ke biner gtest pada perangkat |
flags | String : tanda eksekusi gtest |
Kembali | |
---|---|
String | baris perintah shell untuk dijalankan untuk gtest |
dapatkanGTestCmdLineWrapper
protected String getGTestCmdLineWrapper (String fullPath, String flags)
Helper yang memungkinkan kelas turunan untuk menggabungkan perintah gtest di bawah beberapa alat lain (chroot, strace, gdb, dan sejenisnya).
Parameter | |
---|---|
fullPath | String |
flags | String |
Kembali | |
---|---|
String |
dapatkanGTestFilters
protected String getGTestFilters (String path)
Pembantu untuk menjalankan filter uji g-test.
Perhatikan bahwa filter memfilter berdasarkan nama fungsi saja (misalnya: Google Test "Test"); semua "Kasus Uji" Uji Google akan dipertimbangkan.
Parameter | |
---|---|
path | String : jalur lengkap biner pada perangkat. |
Kembali | |
---|---|
String | tanda filter lengkap untuk diteruskan ke uji-g, atau string kosong jika tidak ada yang ditentukan |
Melempar | |
---|---|
DeviceNotAvailableException |
dapatkanGTestListener
protected ITestInvocationListener getGTestListener (ITestInvocationListener listener)
Mengembalikan GTestListener yang memberikan info debug tambahan, seperti mendeteksi dan melaporkan pengujian duplikat jika mDisabledDuplicationCheck salah. Jika tidak, kembalikan pendengar yang diteruskan.
Parameter | |
---|---|
listener | ITestInvocationListener |
Kembali | |
---|---|
ITestInvocationListener |
filter beban
protected abstract String loadFilter (String path)
Tentukan metode dapatkan filter.
Sub kelas harus mengimplementasikan cara mendapatkan filternya sendiri.
Parameter | |
---|---|
path | String : path lengkap dari file filter. |
Kembali | |
---|---|
String | rangkaian penyaring. |
Melempar | |
---|---|
DeviceNotAvailableException |
setRunDisabled
protected void setRunDisabled (boolean runDisabled)
Setel apakah GTest harus menjalankan pengujian yang dinonaktifkan.
Parameter | |
---|---|
runDisabled | boolean |