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.

HostTest

public class HostTest
extends Object implements IAbiReceiver, IBuildReceiver, IConfigurationReceiver, IDeviceTest, IDiscoverTestClasses, IRemoteTest, IRuntimeHintProvider, IShardableTest, ITestAnnotationFilterReceiver, ITestCollector, ITestFilterReceiver

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

Subclass langsung yang dikenal

JarHostTest

JarHostTest Test runner untuk pengujian JUnit sisi host.

Runner pengujian untuk pengujian berbasis host JUnit. Jika pengujian yang akan dijalankan menerapkan IDeviceTest peluncur ini akan meneruskan referensi ke perangkat.

Ringkasan

Konstanta
`String`	`SET_OPTION_DESC`
`String`	`SET_OPTION_NAME`

Konstruktor publik
`HostTest()`

Metode publik
`void`	`addAllExcludeAnnotation( notAnnotations)` Menambahkan `ERROR(/Set)` anotasi yang akan dikecualikan jika pengujian ditandai dengannya.
`void`	`addAllExcludeFilters( filters)` Menambahkan `ERROR(/Set)` filter yang pengujiannya akan dikecualikan.
`void`	`addAllIncludeAnnotation( annotations)` Menambahkan `ERROR(/Set)` anotasi yang akan disertakan jika pengujian ditandai dengannya.
`void`	`addAllIncludeFilters( filters)` Menambahkan `ERROR(/Set)` filter yang pengujiannya akan disertakan.
`void`	`addExcludeAnnotation(String notAnnotation)` Menambahkan anotasi untuk dikecualikan jika pengujian ditandai dengannya.
`void`	`addExcludeFilter(String filter)` Menambahkan filter pengujian mana yang akan dikecualikan.
`void`	`addIncludeAnnotation(String annotation)` Menambahkan anotasi untuk disertakan jika pengujian ditandai dengannya.
`void`	`addIncludeFilter(String filter)` Menambahkan filter pengujian yang akan disertakan.
`void`	`clearExcludeAnnotations()` Hapus semua anotasi pengecualian yang saat ini dilacak.
`void`	`clearExcludeFilters()` Menghapus semua filter pengecualian yang saat ini dilacak.
`void`	`clearIncludeAnnotations()` Hapus semua anotasi sertakan yang saat ini dilacak.
`void`	`clearIncludeFilters()` Hapus semua filter sertakan yang saat ini dilacak.
`int`	`countTestCases()` Menampilkan jumlah kasus pengujian di semua class yang merupakan bagian dari pengujian
`IAbi`	`getAbi()`
	`getClassNames()`
`ITestDevice`	`getDevice()` Dapatkan perangkat yang sedang diuji.
	`getExcludeAnnotations()` Menampilkan `ERROR(/Set)` anotasi saat ini yang akan dikecualikan.
	`getExcludeFilters()` Menampilkan `ERROR(/Set)` saat ini dari filter pengecualian.
	`getIncludeAnnotations()` Menampilkan `ERROR(/Set)` anotasi saat ini yang akan disertakan.
	`getIncludeFilters()` Menampilkan `ERROR(/Set)` saat ini dari filter sertakan.
`long`	`getRuntimeHint()` Menampilkan runtime yang diharapkan dari pengujian dalam milidetik.
`void`	`run(TestInformation testInfo, ITestInvocationListener listener)` Menjalankan pengujian, dan melaporkan hasilnya ke pendengar.
`void`	`setAbi(IAbi abi)`
`void`	`setBuild(IBuildInfo buildInfo)`
`void`	`setCollectTestsOnly(boolean shouldCollectTest)` Mengaktifkan atau menonaktifkan mode pengumpulan pengujian
`void`	`setConfiguration(IConfiguration configuration)` Menyisipkan `IConfiguration` yang sedang digunakan.
`void`	`setDevice(ITestDevice device)` Suntikkan perangkat yang sedang diuji.
`static void`	`setOptionToLoadedObject(Object testObj, keyValueOptions)` Helper untuk Runner Perangkat yang digunakan untuk menyetel opsi dengan cara yang sama seperti HostTest, dari set-option.
`void`	`setTestInformation(TestInformation testInfo)`
	`split(Integer shardCount, TestInformation testInfo)` Kita membagi menurut individu berdasarkan class atau metode pengujian.

Metode yang dilindungi
`HostTest`	`createHostTest(Class<?> classObj)` Helper untuk membuat instance HostTest saat melakukan sharding.
`IBuildInfo`	`getBuild()` Mendapatkan info build yang diterima oleh HostTest.
`ClassLoader`	`getClassLoader()` Menampilkan classloader default.
`final`	`getClasses()`
`File`	`getJarFile(String jarName, TestInformation testInfo)` Periksa beberapa lokasi tempat artefak biasanya berada untuk berbagai kasus penggunaan guna menemukan JAR kita.
`boolean`	`hasJUnit4Annotation(Class<?> classObj)` Helper untuk menentukan apakah kita berurusan dengan class Test dengan anotasi Junit4.
`Object`	`loadObject(Class<?> classObj)` memuat objek class dan menyetel info pengujian (perangkat, build).
`void`	`setClassName(String className)` Hapus, lalu tetapkan nama class yang akan dijalankan.
`boolean`	`shouldTestRun(AnnotatedElement annotatedElement)` Memeriksa apakah elemen yang memiliki anotasi lulus filter.

Konstanta

SET_OPTION_DESC

public static final String SET_OPTION_DESC

Nilai Konstan: "Opsi yang akan diteruskan ke class yang sedang diuji, kunci dan nilai harus dipisahkan dengan titik dua ":"; misalnya, jika class yang sedang diuji mendukung "--iteration 1" dari command line, class tersebut harus diteruskan sebagai "--set-option iteration:1" atau "--set-option iteration:key=value" untuk meneruskan opsi ke peta. Nilai yang berisi ":" atau "=" dapat dikonversikan dengan garis miring terbalik. Class tertentu dapat ditargetkan dengan menentukannya. " --set-option :

SET_OPTION_NAME

public static final String SET_OPTION_NAME

Nilai Konstanta: "set-option"

Konstruktor publik

HostTest

public HostTest ()

Metode publik

addAllExcludeAnnotation

public void addAllExcludeAnnotation ( notAnnotations)

Menambahkan ERROR(/Set) anotasi yang akan dikecualikan jika pengujian ditandai dengannya.

Parameter
`notAnnotations`

addAllExcludeFilters

public void addAllExcludeFilters ( filters)

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

Parameter
`filters`

addAllIncludeAnnotation

public void addAllIncludeAnnotation ( annotations)

Menambahkan ERROR(/Set) anotasi yang akan disertakan jika pengujian ditandai dengannya.

Parameter
`annotations`

addAllIncludeFilters

public void addAllIncludeFilters ( filters)

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

Parameter
`filters`

addExcludeAnnotation

public void addExcludeAnnotation (String notAnnotation)

Menambahkan anotasi untuk dikecualikan jika pengujian ditandai dengannya.

Parameter
`notAnnotation`	`String`

addExcludeFilter

public void addExcludeFilter (String filter)

Menambahkan filter pengujian mana yang akan dikecualikan.

Parameter
`filter`	`String`

addIncludeAnnotation

public void addIncludeAnnotation (String annotation)

Menambahkan anotasi untuk disertakan jika pengujian ditandai dengannya.

Parameter
`annotation`	`String`

addIncludeFilter

public void addIncludeFilter (String filter)

Menambahkan filter pengujian yang akan disertakan.

Parameter
`filter`	`String`

clearExcludeAnnotations

public void clearExcludeAnnotations ()

Hapus semua anotasi pengecualian yang saat ini dilacak.

clearExcludeFilters

public void clearExcludeFilters ()

Menghapus semua filter pengecualian yang saat ini dilacak.

clearIncludeAnnotations

public void clearIncludeAnnotations ()

Hapus semua anotasi sertakan yang saat ini dilacak.

clearIncludeFilters

public void clearIncludeFilters ()

Hapus semua filter sertakan yang saat ini dilacak.

countTestCases

public int countTestCases ()

Menampilkan jumlah kasus pengujian di semua class yang merupakan bagian dari pengujian

Hasil
`int`

getAbi

public IAbi getAbi ()

Hasil
`IAbi`

getClassNames

public  getClassNames ()

Hasil

getDevice

public ITestDevice getDevice ()

Dapatkan perangkat yang sedang diuji.

Hasil
`ITestDevice`	`ITestDevice`

getExcludeAnnotations

public  getExcludeAnnotations ()

Menampilkan ERROR(/Set) anotasi saat ini yang akan dikecualikan.

Hasil

getExcludeFilters

public  getExcludeFilters ()

Menampilkan ERROR(/Set) saat ini dari filter pengecualian.

Hasil

getIncludeAnnotations

public  getIncludeAnnotations ()

Menampilkan ERROR(/Set) anotasi saat ini yang akan disertakan.

Hasil

getIncludeFilters

public  getIncludeFilters ()

Menampilkan ERROR(/Set) saat ini dari filter sertakan.

Hasil

getRuntimeHint

public long getRuntimeHint ()

Menampilkan runtime yang diharapkan dari pengujian dalam milidetik. Waktu digunakan untuk menyeimbangkan beban eksekusi yang di-shard

Hasil
`long`

lari

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

Menjalankan pengujian, dan melaporkan hasilnya ke pendengar.

Parameter
`testInfo`	`TestInformation`: Objek `TestInformation` yang berisi informasi berguna untuk menjalankan pengujian.
`listener`	`ITestInvocationListener`: `ITestInvocationListener` hasil pengujian

Menampilkan
`DeviceNotAvailableException`

setAbi

public void setAbi (IAbi abi)

Parameter
`abi`	`IAbi`

setBuild

public void setBuild (IBuildInfo buildInfo)

Parameter
`buildInfo`	`IBuildInfo`

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`

setDevice

public void setDevice (ITestDevice device)

Suntikkan perangkat yang sedang diuji.

Parameter
`device`	`ITestDevice`: `ITestDevice` yang akan digunakan

setOptionToLoadedObject

public static void setOptionToLoadedObject (Object testObj, 
                 keyValueOptions)

Helper untuk Runner Perangkat yang digunakan untuk menyetel opsi dengan cara yang sama seperti HostTest, dari set-option.

Parameter
`testObj`	`Object`: objek yang akan menerima opsi.
`keyValueOptions`	: daftar opsi yang diformat seperti yang diperlukan set-option HostTest.

setTestInformation

public void setTestInformation (TestInformation testInfo)

Parameter
`testInfo`	`TestInformation`

pisahkan

public  split (Integer shardCount, 
                TestInformation testInfo)

Kita membagi menurut individu berdasarkan class atau metode pengujian.

Parameter
`shardCount`	`Integer`: jumlah shard yang dicoba.
`testInfo`	`TestInformation`: `TestInformation` induk

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

Metode yang dilindungi

createHostTest

protected HostTest createHostTest (Class<?> classObj)

Helper untuk membuat instance HostTest saat melakukan sharding. Ganti untuk menampilkan turunan apa pun dari HostTest.

Parameter
`classObj`	`Class`

Hasil
`HostTest`

getBuild

protected IBuildInfo getBuild ()

Mendapatkan info build yang diterima oleh HostTest.

Hasil
`IBuildInfo`	`IBuildInfo`

getClassLoader

protected ClassLoader getClassLoader ()

Menampilkan classloader default.

Hasil
`ClassLoader`

getClasses

protected final  getClasses ()

Hasil

getJarFile

protected File getJarFile (String jarName, 
                TestInformation testInfo)

Periksa beberapa lokasi tempat artefak biasanya berada untuk berbagai kasus penggunaan guna menemukan JAR kita.

Parameter
`jarName`	`String`
`testInfo`	`TestInformation`

Hasil
`File`

hasJUnit4Annotation

protected boolean hasJUnit4Annotation (Class<?> classObj)

Helper untuk menentukan apakah kita berurusan dengan class Test dengan anotasi Junit4.

Parameter
`classObj`	`Class`

Hasil
`boolean`

loadObject

protected Object loadObject (Class<?> classObj)

memuat objek class dan menyetel info pengujian (perangkat, build).

Parameter
`classObj`	`Class`

Hasil
`Object`

setClassName

protected void setClassName (String className)

Hapus, lalu tetapkan nama class yang akan dijalankan.

Parameter
`className`	`String`

shouldTestRun

protected boolean shouldTestRun (AnnotatedElement annotatedElement)

Memeriksa apakah elemen yang memiliki anotasi lulus filter. Diekspos untuk pengujian unit.

Hasil
`boolean`	false jika pengujian tidak boleh dijalankan.