InvocationExecution

public class InvocationExecution
extends Object implements IInvocationExecution

java.lang.Object
↳	com.android.tradefed.invoker.InvocationExecution

Subclass langsung yang dikenal DelegatedInvocationExecution, ParentSandboxInvocationExecution, RemoteInvocationExecution, SandboxedInvocationExecution DelegatedInvocationExecution InvocationExecution yang mendelegasikan eksekusi ke biner Tradefed lain.  ParentSandboxInvocationExecution Versi InvocationExecution untuk tindakan khusus pemanggilan induk saat menjalankan sandbox.  RemoteInvocationExecution Implementasi InvocationExecution yang mendorong eksekusi jarak jauh.  SandboxedInvocationExecution Eksekusi sandbox khusus pemanggilan: Ini adalah InvocationExection saat kita berada di dalam sandbox yang menjalankan perintah.

---

Class yang menjelaskan semua langkah pemanggilan: download build, target_prep, jalankan pengujian, hapus. Dapat diperluas untuk mengganti perilaku default beberapa langkah. Urutan langkah-langkah didasarkan pada TestInvocation.

Ringkasan

Konstanta
String	ADB_VERSION_KEY
String	JAVA_CLASSPATH_KEY
String	JAVA_VERSION_KEY

Konstruktor publik
InvocationExecution()

Metode publik
void	cleanUpBuilds(IInvocationContext context, IConfiguration config) Jalankan langkah pembersihan build_provider.
void	doCleanUp(IInvocationContext context, IConfiguration config, Throwable exception) Jalankan langkah cleanUp target_preparer dan multi_target_preparer.
void	doSetup(TestInformation testInfo, IConfiguration config, ITestLogger listener) Jalankan langkah penyiapan target_preparer dan multi_target_preparer.
void	doTeardown(TestInformation testInfo, IConfiguration config, ITestLogger logger, Throwable exception) Jalankan langkah penonaktifan target_preparer dan multi_target_preparer.
boolean	fetchBuild(TestInformation testInfo, IConfiguration config, IRescheduler rescheduler, ITestInvocationListener listener) Jalankan langkah build_provider dari pemanggilan.
void	reportLogs(ITestDevice device, ITestLogger listener, TestInvocation.Stage stage) Laporkan beberapa log perangkat pada tahap pemanggilan yang berbeda.
void	runDevicePostInvocationTearDown(IInvocationContext context, IConfiguration config, Throwable exception) Panggil ITestDevice.postInvocationTearDown(Throwable) untuk setiap bagian perangkat dari pemanggilan.
void	runDevicePreInvocationSetup(IInvocationContext context, IConfiguration config, ITestLogger logger) Panggil ERROR(ITestDevice.preInvocationSetup(IBuildInfo)/com.android.tradefed.device.ITestDevice#preInvocationSetup(com.android.tradefed.build.IBuildInfo) ITestDevice.preInvocationSetup(IBuildInfo)) untuk setiap bagian perangkat dari pemanggilan.
void	runTests(TestInformation info, IConfiguration config, ITestInvocationListener listener) Menjalankan pengujian.
boolean	shardConfig(IConfiguration config, TestInformation testInfo, IRescheduler rescheduler, ITestLogger logger) Mencoba membagi konfigurasi menjadi sub-konfigurasi, untuk dijadwalkan ulang agar berjalan di beberapa resource secara paralel.

Metode yang dilindungi
void	collectAutoInfo(IConfiguration config, TestInformation info) Mengumpulkan beberapa informasi secara otomatis di perangkat utama yang sedang diuji.
IShardHelper	createShardHelper() Buat dan tampilkan IShardHelper yang akan digunakan.
void	customizeDevicePreInvocation(IConfiguration config, IInvocationContext context) Memberikan kesempatan untuk menyesuaikan beberapa perangkat sebelum preInvocationSetup.
String	getAdbVersion() Menampilkan versi adb yang digunakan untuk pemanggilan.
	getLabPreparersToRun(IConfiguration config, String deviceName) Mengambil daftar penyiapan lab untuk dijalankan di perangkat ini.
	getTargetPreparersToRun(IConfiguration config, String deviceName) Mengambil daftar penyiap target untuk dijalankan di perangkat ini.
void	linkExternalDirs(IBuildInfo info, TestInformation testInfo)
void	logHostAdb(IConfiguration config, ITestLogger logger) Kumpulkan log dari $TMPDIR/adb.$UID.log.
Throwable	runPreparersTearDown(TestInformation testInfo, ITestDevice device, String deviceName, int deviceIndex, ITestLogger logger, Throwable exception, preparersToRun, trackPreparersMap)
void	setTestTag(IBuildInfo info, IConfiguration config) Menangani penetapan tag pengujian pada info build.

Konstanta

ADB_VERSION_KEY

public static final String ADB_VERSION_KEY

Nilai Konstanta: "adb_version"

JAVA_CLASSPATH_KEY

public static final String JAVA_CLASSPATH_KEY

Nilai Konstanta: "java_classpath"

JAVA_VERSION_KEY

public static final String JAVA_VERSION_KEY

Nilai Konstanta: "java_version"

Konstruktor publik

InvocationExecution

public InvocationExecution ()

Metode publik

cleanUpBuilds

public void cleanUpBuilds (IInvocationContext context, 
                IConfiguration config)

Jalankan langkah pembersihan build_provider. Terkait dengan pengambilan build.

Parameter
context	IInvocationContext: IInvocationContext pemanggilan.
config	IConfiguration: IConfiguration operasi pengujian ini.

doCleanUp

public void doCleanUp (IInvocationContext context, 
                IConfiguration config, 
                Throwable exception)

Jalankan langkah cleanUp target_preparer dan multi_target_preparer. Apakah perangkat membersihkan diri.

Parameter
context	IInvocationContext: IInvocationContext pemanggilan.
config	IConfiguration: IConfiguration operasi pengujian ini.
exception	Throwable: pengecualian asli yang ditampilkan oleh pengujian yang sedang berjalan.

doSetup

public void doSetup (TestInformation testInfo, 
                IConfiguration config, 
                ITestLogger listener)

Jalankan langkah penyiapan target_preparer dan multi_target_preparer. Menyiapkan semua perangkat yang diperlukan agar pengujian dapat berjalan.

Parameter
testInfo	TestInformation: TestInformation pemanggilan.
config	IConfiguration: IConfiguration operasi pengujian ini.
listener	ITestLogger: ITestLogger untuk melaporkan log kegagalan penyiapan.

Menampilkan
BuildError
DeviceNotAvailableException
TargetSetupError

doTeardown

public void doTeardown (TestInformation testInfo, 
                IConfiguration config, 
                ITestLogger logger, 
                Throwable exception)

Jalankan langkah penonaktifan target_preparer dan multi_target_preparer. Membongkar perangkat yang terkait dengan penyiapan.

Parameter
testInfo	TestInformation: TestInformation pemanggilan.
config	IConfiguration: IConfiguration operasi pengujian ini.
logger	ITestLogger: ITestLogger untuk melaporkan log.
exception	Throwable: pengecualian asli yang ditampilkan oleh pengujian yang sedang berjalan.

fetchBuild

public boolean fetchBuild (TestInformation testInfo, 
                IConfiguration config, 
                IRescheduler rescheduler, 
                ITestInvocationListener listener)

Jalankan langkah build_provider dari pemanggilan.

Parameter
testInfo	TestInformation: TestInformation pemanggilan.
config	IConfiguration: IConfiguration operasi pengujian ini.
rescheduler	IRescheduler: IRescheduler, untuk menjadwalkan ulang sebagian pemanggilan untuk dieksekusi di resource lain
listener	ITestInvocationListener: ITestInvocation untuk melaporkan kegagalan download build.

Hasil
boolean	Benar jika kita berhasil mendownload build, salah jika tidak.

Menampilkan
BuildRetrievalError
DeviceNotAvailableException

reportLogs

public void reportLogs (ITestDevice device, 
                ITestLogger listener, 
                TestInvocation.Stage stage)

Laporkan beberapa log perangkat pada tahap pemanggilan yang berbeda. Misalnya: logcat.

Parameter
device	ITestDevice: Perangkat yang akan melaporkan log.
listener	ITestLogger: Logger untuk log.
stage	TestInvocation.Stage: Tahap pemanggilan yang sedang kita lakukan.

runDevicePostInvocationTearDown

public void runDevicePostInvocationTearDown (IInvocationContext context, 
                IConfiguration config, 
                Throwable exception)

Panggil ITestDevice.postInvocationTearDown(Throwable) untuk setiap bagian perangkat dari pemanggilan.

Parameter
context	IInvocationContext: IInvocationContext pemanggilan.
config	IConfiguration: IConfiguration operasi pengujian ini.
exception	Throwable: pengecualian asli yang ditampilkan oleh pengujian yang sedang berjalan, jika ada.

runDevicePreInvocationSetup

public void runDevicePreInvocationSetup (IInvocationContext context, 
                IConfiguration config, 
                ITestLogger logger)

Panggil ERROR(ITestDevice.preInvocationSetup(IBuildInfo)/com.android.tradefed.device.ITestDevice#preInvocationSetup(com.android.tradefed.build.IBuildInfo) ITestDevice.preInvocationSetup(IBuildInfo)) untuk setiap bagian perangkat dari pemanggilan.

Parameter
context	IInvocationContext: IInvocationContext pemanggilan.
config	IConfiguration: IConfiguration operasi pengujian ini.
logger	ITestLogger: ITestLogger untuk melaporkan log.

Menampilkan
DeviceNotAvailableException
TargetSetupError

runTests

public void runTests (TestInformation info, 
                IConfiguration config, 
                ITestInvocationListener listener)

Menjalankan pengujian.

Parameter
info	TestInformation: TestInformation untuk menjalankan pengujian.
config	IConfiguration: IConfiguration yang akan dijalankan
listener	ITestInvocationListener: ITestInvocationListener hasil pengujian

shardConfig

public boolean shardConfig (IConfiguration config, 
                TestInformation testInfo, 
                IRescheduler rescheduler, 
                ITestLogger logger)

Mencoba membagi konfigurasi menjadi sub-konfigurasi, untuk dijadwalkan ulang agar berjalan di beberapa resource secara paralel.

Jika jumlah shard lebih besar dari 1, konfigurasi untuk setiap shard akan dibuat dengan menetapkan indeks shard dan menjadwalkannya ulang. Jika jumlah shard tidak ditetapkan,jumlah tersebut akan kembali ke IShardHelper.shardConfig.

Parameter
config	IConfiguration: IConfiguration saat ini.
testInfo	TestInformation: TestInformation yang menyimpan info pengujian.
rescheduler	IRescheduler: IRescheduler.
logger	ITestLogger: ITestLogger yang digunakan untuk mencatat file selama sharding.

Hasil
boolean	benar jika pengujian di-shard. Jika tidak, tampilkan false

Metode yang dilindungi

collectAutoInfo

protected void collectAutoInfo (IConfiguration config, 
                TestInformation info)

Mengumpulkan beberapa informasi secara otomatis di perangkat utama yang sedang diuji.

Parameter
config	IConfiguration
info	TestInformation

Menampilkan
DeviceNotAvailableException

createShardHelper

protected IShardHelper createShardHelper ()

Buat dan tampilkan IShardHelper yang akan digunakan.

Hasil
IShardHelper

customizeDevicePreInvocation

protected void customizeDevicePreInvocation (IConfiguration config, 
                IInvocationContext context)

Memberikan kesempatan untuk menyesuaikan beberapa perangkat sebelum preInvocationSetup.

Parameter
config	IConfiguration: Konfigurasi pemanggilan.
context	IInvocationContext: Konteks pemanggilan saat ini.

getAdbVersion

protected String getAdbVersion ()

Menampilkan versi adb yang digunakan untuk pemanggilan.

Hasil
String

getLabPreparersToRun

protected  getLabPreparersToRun (IConfiguration config, 
                String deviceName)

Mengambil daftar penyiapan lab untuk dijalankan di perangkat ini.

Diganti di class sandbox untuk membatasi agar penyiapan lab tidak dijalankan di dalam turunan sandbox

Parameter
config	IConfiguration
deviceName	String

Hasil

getTargetPreparersToRun

protected  getTargetPreparersToRun (IConfiguration config, 
                String deviceName)

Mengambil daftar penyiap target untuk dijalankan di perangkat ini.

Diganti di class sandbox untuk membatasi agar penyiapan lab tidak dijalankan di dalam turunan sandbox

Parameter
config	IConfiguration
deviceName	String

Hasil

linkExternalDirs

protected void linkExternalDirs (IBuildInfo info, 
                TestInformation testInfo)

Parameter
info	IBuildInfo
testInfo	TestInformation

logHostAdb

protected void logHostAdb (IConfiguration config, 
                ITestLogger logger)

Kumpulkan log dari $TMPDIR/adb.$UID.log.

Parameter
config	IConfiguration
logger	ITestLogger

runPreparersTearDown

protected Throwable runPreparersTearDown (TestInformation testInfo, 
                ITestDevice device, 
                String deviceName, 
                int deviceIndex, 
                ITestLogger logger, 
                Throwable exception, 
                 preparersToRun, 
                 trackPreparersMap)

Parameter
testInfo	TestInformation
device	ITestDevice
deviceName	String
deviceIndex	int
logger	ITestLogger
exception	Throwable
preparersToRun
trackPreparersMap

Hasil
Throwable

setTestTag

protected void setTestTag (IBuildInfo info, 
                IConfiguration config)

Menangani penetapan tag pengujian pada info build.

Parameter
info	IBuildInfo
config	IConfiguration