Mulai 27 Maret 2025, sebaiknya gunakan android-latest-release, bukan aosp-main, untuk mem-build dan berkontribusi pada AOSP. Untuk mengetahui informasi selengkapnya, lihat Perubahan pada AOSP.

Halaman ini diterjemahkan oleh Cloud Translation API.

GTestBase

public abstract class GTestBase
extends Object implements IAbiReceiver, IConfigurationReceiver, IRemoteTest, IRuntimeHintProvider, IShardableTest, ITestCollector, ITestFilterReceiver

java.lang.Object
↳	com.android.tradefed.testtype.GTestBase

Subclass langsung yang dikenal

GTest, HostGTest

GTest	Pengujian yang menjalankan paket pengujian native di perangkat tertentu.
HostGTest	Pengujian yang menjalankan paket pengujian native.

Subclass tidak langsung yang umum

ArtGTest

Class dasar gTest

Ringkasan

Kolom
`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)` Menambahkan `ERROR(/Set)` filter yang pengujiannya akan dikecualikan.
`void`	`addAllIncludeFilters( filters)` Menambahkan `ERROR(/Set)` filter yang pengujiannya akan disertakan.
`void`	`addExcludeFilter(String filter)` Menambahkan filter pengujian yang akan dikecualikan.
`void`	`addIncludeFilter(String filter)` Menambahkan filter pengujian yang akan disertakan.
`String`	`cleanFilter(String filter)`
`void`	`clearExcludeFilters()` Menghapus semua filter pengecualian yang saat ini dilacak.
`void`	`clearIncludeFilters()` Hapus semua filter yang disertakan yang saat ini dilacak.
`IAbi`	`getAbi()`
	`getAfterTestCmd()` Mendapatkan perintah shell untuk dijalankan setelah GTest.
	`getBeforeTestCmd()` Mendapatkan perintah shell untuk dijalankan sebelum GTest.
	`getExcludeFilters()` Menampilkan `ERROR(/Set)` filter pengecualian saat ini.
	`getFileExclusionFilterRegex()` Mendapatkan ekspresi reguler untuk mengecualikan file tertentu agar tidak dieksekusi.
	`getGTestFlags()` Mendapatkan nilai flag tambahan untuk diteruskan ke perintah shell pengujian native.
	`getIncludeFilters()` Menampilkan `ERROR(/Set)` filter sertakan saat ini.
`long`	`getMaxTestTimeMs()` Mendapatkan waktu maksimum untuk menjalankan gtest.
`String`	`getModuleName()` Mendapatkan modul pengujian native Android untuk dijalankan.
`boolean`	`getRunDisabledTests()` Mendapatkan apakah GTest harus menjalankan pengujian yang dinonaktifkan.
`long`	`getRuntimeHint()` Menampilkan runtime pengujian yang diharapkan dalam milidetik.
`int`	`getShardCount()` Menampilkan jumlah shard saat ini.
`int`	`getShardIndex()` Mendapatkan indeks shard pengujian ini.
`String`	`getTestFilterKey()` Mendapatkan kunci filter pengujian.
`String`	`getTestModule()` Mendapatkan nama modul.
`boolean`	`isCollectTestsOnly()` Hanya memanggil biner pengujian untuk mengumpulkan daftar kasus pengujian yang berlaku atau tidak.
`boolean`	`isEnableXmlOutput()` Mendapatkan output xml gtest untuk hasil pengujian atau tidak.
`boolean`	`isSharded()` Mendapatkan flag isSharded.
`void`	`notifyTestExecution(boolean incompleteTestFound, failedTests)` Memberi tahu induk tentang eksekusi 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)` Memasukkan `IConfiguration` yang digunakan.
`void`	`setModuleName(String moduleName)` Tetapkan modul pengujian native Android untuk dijalankan.
`void`	`setShardCount(int shardCount)` Menetapkan jumlah shard pengujian ini.
`void`	`setShardIndex(int shardIndex)` Menetapkan indeks shard pengujian ini.
	`split(int shardCountHint)` Versi alternatif `split()` yang juga menyediakan shardCount yang dicoba dijalankan.

Metode yang dilindungi
`String`	`convertName(String gtestFlagName)`
`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)`
`String`	`getAllGTestFlags(String path)` Helper untuk mendapatkan semua flag GTest yang akan diteruskan ke perintah shell adb.
`IConfiguration`	`getConfiguration()` Menampilkan konfigurasi pengujian.
`String`	`getExceptionMessage(Exception e)` Lakukan upaya terbaik untuk mengambil pesan deskriptif singkat yang bermakna untuk `Exception` tertentu
`String`	`getGTestCmdLine(String fullPath, String flags)` Metode helper untuk mem-build perintah gtest yang akan dijalankan.
`String`	`getGTestCmdLineWrapper(String fullPath, String flags)` Helper yang memungkinkan class turunan menggabungkan perintah gtest di bawah beberapa alat lain (chroot, strace, gdb, dan sejenisnya).
`String`	`getGTestFilters(String path)` Helper untuk mendapatkan filter g-test pengujian yang akan dijalankan.
`ITestInvocationListener`	`getGTestListener(ITestInvocationListener... listeners)` Menampilkan GTestListener yang memberikan info proses debug tambahan, seperti mendeteksi dan melaporkan pengujian duplikat jika mDisabledDuplicateCheck bernilai salah.
`abstract String`	`loadFilter(String path)` Menentukan metode filter get.
`void`	`setRunDisabled(boolean runDisabled)` Menetapkan apakah GTest harus menjalankan pengujian yang dinonaktifkan.

Kolom

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 pengujiannya akan dikecualikan.

Parameter
`filters`

addAllIncludeFilters

public void addAllIncludeFilters ( filters)

Menambahkan ERROR(/Set) filter yang pengujiannya akan disertakan.

Parameter
`filters`

addExcludeFilter

public void addExcludeFilter (String filter)

Menambahkan filter pengujian yang akan dikecualikan.

Parameter
`filter`	`String`

addIncludeFilter

public void addIncludeFilter (String filter)

Menambahkan filter pengujian yang akan disertakan.

Parameter
`filter`	`String`

cleanFilter

public String cleanFilter (String filter)

Parameter
`filter`	`String`

Hasil
`String`

clearExcludeFilters

public void clearExcludeFilters ()

Menghapus semua filter pengecualian yang saat ini dilacak.

clearIncludeFilters

public void clearIncludeFilters ()

Hapus semua filter yang disertakan yang saat ini dilacak.

getAbi

public IAbi getAbi ()

Hasil
`IAbi`

getAfterTestCmd

public  getAfterTestCmd ()

Mendapatkan perintah shell untuk dijalankan setelah GTest.

Hasil

getBeforeTestCmd

public  getBeforeTestCmd ()

Mendapatkan perintah shell untuk dijalankan sebelum GTest.

Hasil

getExcludeFilters

public  getExcludeFilters ()

Menampilkan ERROR(/Set) filter pengecualian saat ini.

Hasil

getFileExclusionFilterRegex

public  getFileExclusionFilterRegex ()

Mendapatkan ekspresi reguler untuk mengecualikan file tertentu agar tidak dieksekusi.

Hasil

getGTestFlags

public  getGTestFlags ()

Mendapatkan nilai flag tambahan untuk diteruskan ke perintah shell pengujian native.

Hasil

getIncludeFilters

public  getIncludeFilters ()

Menampilkan ERROR(/Set) filter sertakan saat ini.

Hasil

getMaxTestTimeMs

public long getMaxTestTimeMs ()

Mendapatkan waktu maksimum untuk menjalankan gtest.

Hasil
`long`

getModuleName

public String getModuleName ()

Mendapatkan modul pengujian native Android untuk dijalankan.

Hasil
`String`	nama modul pengujian native yang akan dijalankan, atau null jika tidak ditetapkan

getRunDisabledTests

public boolean getRunDisabledTests ()

Mendapatkan apakah GTest harus menjalankan pengujian yang dinonaktifkan.

Hasil
`boolean`	Benar jika pengujian yang dinonaktifkan harus dijalankan, salah jika tidak

getRuntimeHint

public long getRuntimeHint ()

Menampilkan runtime pengujian yang diharapkan dalam milidetik. Waktu ini digunakan untuk melakukan load balancing pada eksekusi yang di-shard

Hasil
`long`

getShardCount

public int getShardCount ()

Menampilkan jumlah shard saat ini.

Hasil
`int`

getShardIndex

public int getShardIndex ()

Mendapatkan indeks shard pengujian ini.

Hasil
`int`

getTestFilterKey

public String getTestFilterKey ()

Mendapatkan kunci filter pengujian.

Hasil
`String`

getTestModule

public String getTestModule ()

Mendapatkan nama modul.

Hasil
`String`

isCollectTestsOnly

public boolean isCollectTestsOnly ()

Hanya memanggil biner pengujian untuk mengumpulkan daftar kasus pengujian yang berlaku atau tidak.

Hasil
`boolean`

isEnableXmlOutput

public boolean isEnableXmlOutput ()

Mendapatkan output xml gtest untuk hasil pengujian atau tidak.

Hasil
`boolean`

isSharded

public boolean isSharded ()

Mendapatkan flag isSharded.

Hasil
`boolean`

notifyTestExecution

public void notifyTestExecution (boolean incompleteTestFound, 
                 failedTests)

Memberi tahu induk tentang eksekusi pengujian, sehingga filter penyertaan/pengecualian dapat ditangani dengan benar untuk upaya percobaan ulang.

Parameter
`incompleteTestFound`	`boolean`
`failedTests`

setAbi

public void setAbi (IAbi abi)

Parameter
`abi`	`IAbi`

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

Mengaktifkan atau menonaktifkan mode pengumpulan pengujian

setConfiguration

public void setConfiguration (IConfiguration configuration)

Memasukkan IConfiguration yang digunakan.

Parameter
`configuration`	`IConfiguration`

setModuleName

public void setModuleName (String moduleName)

Tetapkan modul pengujian native Android untuk dijalankan.

Parameter
`moduleName`	`String`: Nama modul pengujian native yang akan dijalankan

setShardCount

public void setShardCount (int shardCount)

Menetapkan jumlah shard pengujian ini.

Parameter
`shardCount`	`int`

setShardIndex

public void setShardIndex (int shardIndex)

Menetapkan indeks shard pengujian ini.

Parameter
`shardIndex`	`int`

pisahkan

public  split (int shardCountHint)

Versi alternatif split() yang juga menyediakan shardCount yang dicoba dijalankan. Hal ini berguna untuk beberapa runner pengujian yang terkadang tidak dapat memutuskan secara sewenang-wenang.

Parameter
`shardCountHint`	`int`: jumlah shard yang dicoba.

Hasil
	kumpulan subpengujian yang akan dijalankan secara terpisah atau `null` jika pengujian saat ini tidak dapat di-shard

Metode yang dilindungi

convertName

protected String convertName (String gtestFlagName)

Parameter
`gtestFlagName`	`String`

Hasil
`String`

createFlagFile

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`: String filter

Hasil
`String`	Jalur ke file yang berisi filter.

Menampilkan
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

erasePrependedFileName

protected void erasePrependedFileName ( filters, 
                String filename)

Parameter
`filters`
`filename`	`String`

getAllGTestFlags

protected String getAllGTestFlags (String path)

Helper untuk mendapatkan semua flag GTest yang akan diteruskan ke perintah shell adb.

Parameter
`path`	`String`: jalur lengkap biner di perangkat.

Hasil
`String`	`String` dari semua flag GTest yang harus diteruskan ke GTest

Menampilkan
`DeviceNotAvailableException`

getConfiguration

protected IConfiguration getConfiguration ()

Menampilkan konfigurasi pengujian.

Hasil
`IConfiguration`	IConfiguration

getExceptionMessage

protected String getExceptionMessage (Exception e)

Lakukan upaya terbaik untuk mengambil pesan deskriptif singkat yang bermakna untuk Exception tertentu

Parameter
`e`	`Exception`: `Exception`

Hasil
`String`	pesan singkat

getGTestCmdLine

protected String getGTestCmdLine (String fullPath, 
                String flags)

Metode helper untuk mem-build perintah gtest yang akan dijalankan.

Parameter
`fullPath`	`String`: jalur sistem file absolut ke biner gtest di perangkat
`flags`	`String`: flag eksekusi gtest

Hasil
`String`	command line shell yang akan dijalankan untuk gtest

getGTestCmdLineWrapper

protected String getGTestCmdLineWrapper (String fullPath, 
                String flags)

Helper yang memungkinkan class turunan menggabungkan perintah gtest di bawah beberapa alat lain (chroot, strace, gdb, dan sejenisnya).

Parameter
`fullPath`	`String`
`flags`	`String`

Hasil
`String`

getGTestFilters

protected String getGTestFilters (String path)

Helper untuk mendapatkan filter g-test pengujian yang akan dijalankan.

Perhatikan bahwa filter hanya memfilter nama fungsi (misalnya: Pengujian Google "Pengujian"); semua "Kasus Pengujian" Pengujian Google akan dipertimbangkan.

Parameter
`path`	`String`: jalur lengkap biner di perangkat.

Hasil
`String`	tanda filter lengkap yang akan diteruskan ke g-test, atau string kosong jika tidak ada yang ditentukan

Menampilkan
`DeviceNotAvailableException`

getGTestListener

protected ITestInvocationListener getGTestListener (ITestInvocationListener... listeners)

Menampilkan GTestListener yang memberikan info proses debug tambahan, seperti mendeteksi dan melaporkan pengujian duplikat jika mDisabledDuplicateCheck bernilai salah. Jika tidak, tampilkan pemroses yang diteruskan.

Parameter
`listeners`	`ITestInvocationListener`

Hasil
`ITestInvocationListener`

loadFilter

protected abstract String loadFilter (String path)

Menentukan metode filter get.

Subclass harus mengimplementasikan cara mendapatkan filternya sendiri.

Parameter
`path`	`String`: jalur lengkap file filter.

Hasil
`String`	string filter.

Menampilkan
`DeviceNotAvailableException`

setRunDisabled

protected void setRunDisabled (boolean runDisabled)

Menetapkan apakah GTest harus menjalankan pengujian yang dinonaktifkan.

Parameter
`runDisabled`	`boolean`