Mulai tahun 2026, untuk menyelaraskan dengan model pengembangan stabil trunk kami dan memastikan stabilitas platform untuk ekosistem, kami akan memublikasikan kode sumber ke AOSP pada Kuartal 2 dan Kuartal 4. Untuk membangun dan berkontribusi ke AOSP, sebaiknya gunakan android-latest-release, bukan aosp-main. Cabang manifes android-latest-release akan selalu merujuk pada rilis terbaru yang di-push ke AOSP. Untuk mengetahui informasi selengkapnya, lihat Perubahan pada AOSP.

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

Konstanta
`String`	`FILTER_EXTENSION`
`String`	`GTEST_FLAG_FILE`
`String`	`GTEST_FLAG_FILTER`
`String`	`GTEST_FLAG_LIST_TESTS`
`String`	`GTEST_FLAG_PRINT_TIME`
`String`	`GTEST_FLAG_RUN_DISABLED_TESTS`
`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 mana 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 sertakan 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)` saat ini dari filter pengecualian.
	`getFileExclusionFilterRegex()` Mendapatkan regex untuk mengecualikan file tertentu agar tidak dieksekusi.
	`getGTestFlags()` Mendapatkan nilai flag Tambahan untuk diteruskan ke perintah shell pengujian native.
	`getIncludeFilters()` Menampilkan `ERROR(/Set)` saat ini dari filter sertakan.
`long`	`getMaxTestTimeMs()` Mendapatkan waktu maksimum untuk menjalankan gtest.
`String`	`getModuleName()` Dapatkan modul pengujian native Android untuk dijalankan.
`boolean`	`getRunDisabledTests()` Mendapatkan apakah GTest harus menjalankan pengujian yang dinonaktifkan.
`long`	`getRuntimeHint()` Menampilkan runtime yang diharapkan dari pengujian dalam milidetik.
`int`	`getShardCount()` Menampilkan jumlah partisi 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 tanda isSharded.
`void`	`notifyTestExecution(boolean incompleteTestFound, failedTests)` Memberi tahu induk tentang eksekusi pengujian, sehingga filter penyertaan/pengecualian dapat ditangani dengan benar untuk percobaan ulang.
`void`	`setAbi(IAbi abi)`
`void`	`setCollectTestsOnly(boolean shouldCollectTest)` Mengaktifkan atau menonaktifkan mode pengumpulan pengujian
`void`	`setConfiguration(IConfiguration configuration)` Menyisipkan `IConfiguration` yang sedang 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 untuk 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 tanda GTest yang akan diteruskan ke perintah shell adb.
`IConfiguration`	`getConfiguration()` Menampilkan konfigurasi pengujian.
`String`	`getExceptionMessage(Exception e)` Berupaya sebaik mungkin untuk mengambil pesan deskriptif singkat yang bermakna untuk `Exception`
`String`	`getGTestCmdLine(String fullPath, String flags)` Metode helper untuk membuat perintah gtest yang akan dijalankan.
`String`	`getGTestCmdLineWrapper(String fullPath, String flags)` Helper yang memungkinkan class turunan membungkus perintah gtest di bawah beberapa alat lain (chroot, strace, gdb, dan sejenisnya).
`String`	`getGTestFilters(String path)` Helper untuk mendapatkan filter g-test dari pengujian yang akan dijalankan.
`ITestInvocationListener`	`getGTestListener(ITestInvocationListener... listeners)` Menampilkan GTestListener yang memberikan info proses debug tambahan, seperti mendeteksi dan melaporkan pengujian duplikat jika mDisabledDuplicateCheck adalah false.
`abstract String`	`loadFilter(String path)` Menentukan metode filter get.
`void`	`setRunDisabled(boolean runDisabled)` Menetapkan apakah GTest harus menjalankan pengujian yang dinonaktifkan.

Konstanta

FILTER_EXTENSION

protected static final String FILTER_EXTENSION

Nilai Konstanta: ".filter"

GTEST_FLAG_FILE

protected static final String GTEST_FLAG_FILE

Nilai Konstanta: "--gtest_flagfile"

GTEST_FLAG_FILTER

protected static final String GTEST_FLAG_FILTER

Nilai Konstanta: "--gtest_filter"

GTEST_FLAG_LIST_TESTS

protected static final String GTEST_FLAG_LIST_TESTS

Nilai Konstanta: "--gtest_list_tests"

GTEST_FLAG_PRINT_TIME

protected static final String GTEST_FLAG_PRINT_TIME

Nilai Konstanta: "--gtest_print_time"

GTEST_FLAG_RUN_DISABLED_TESTS

protected static final String GTEST_FLAG_RUN_DISABLED_TESTS

Nilai Konstanta: "--gtest_also_run_disabled_tests"

GTEST_XML_OUTPUT

protected static final String GTEST_XML_OUTPUT

Nilai Konstanta: "--gtest_output=xml:%s"

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 mana 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 sertakan 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) saat ini dari filter pengecualian.

Hasil

getFileExclusionFilterRegex

public  getFileExclusionFilterRegex ()

Mendapatkan regex 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) saat ini dari filter sertakan.

Hasil

getMaxTestTimeMs

public long getMaxTestTimeMs ()

Mendapatkan waktu maksimum untuk menjalankan gtest.

Hasil
`long`

getModuleName

public String getModuleName ()

Dapatkan 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 yang diharapkan dari pengujian dalam milidetik. Waktu digunakan untuk menyeimbangkan beban eksekusi yang di-shard

Hasil
`long`

getShardCount

public int getShardCount ()

Menampilkan jumlah partisi 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 tanda 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 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)

Menyisipkan IConfiguration yang sedang 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 untuk dijalankan. Hal ini berguna untuk beberapa peluncur pengujian yang terkadang tidak dapat memutuskan secara sewenang-wenang.

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

Hasil
	kumpulan subtes yang akan dieksekusi secara terpisah atau `null` jika tes saat ini tidak dapat dibagi

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 tanda GTest yang akan diteruskan ke perintah shell adb.

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

Hasil
`String`	`String` 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)

Berupaya sebaik mungkin untuk mengambil pesan deskriptif singkat yang bermakna untuk Exception

Parameter
`e`	`Exception`: `Exception`

Hasil
`String`	pesan singkat

getGTestCmdLine

protected String getGTestCmdLine (String fullPath, 
                String flags)

Metode helper untuk membuat perintah gtest yang akan dijalankan.

Parameter
`fullPath`	`String`: jalur sistem file absolut ke biner gtest di perangkat
`flags`	`String`: tanda 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 membungkus 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 dari pengujian yang akan dijalankan.

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

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

Hasil
`String`	flag filter lengkap untuk 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 (false). Jika tidak, menampilkan 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`