Od 27 marca 2025 r. zalecamy używanie android-latest-release zamiast aosp-main do kompilowania i wspołtworzenia AOSP. Więcej informacji znajdziesz w artykule o zmianach w AOSP.

Ta strona została przetłumaczona przez Cloud Translation API.

InvocationExecution

public class InvocationExecution
extends Object implements IInvocationExecution

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

Znane bezpośrednie podklasy

DelegatedInvocationExecution, ParentSandboxInvocationExecution, RemoteInvocationExecution, SandboxedInvocationExecution

DelegatedInvocationExecution	`InvocationExecution`, które zlecają wykonanie innemu binarowi Tradefed.
ParentSandboxInvocationExecution	Wersja `InvocationExecution` dla działań specjalnych wywołania nadrzędnego podczas uruchamiania piaskownicy.
RemoteInvocationExecution	Implementacja usługi `InvocationExecution`, która umożliwia zdalne wykonywanie.
Wykonywanie wywołania w piaskownicy	Specjalne wykonanie wywołania w piaskownicy: to wywołanie jest wykonywane w piaskownicy.

Klasa, która opisuje wszystkie kroki wywołania: pobieranie kompilacji, przygotowanie docelowe, uruchamianie testów i sprzątanie. Można je rozszerzyć, aby zastąpić domyślne działanie niektórych kroków. Kolejność kroków zależy od TestInvocation.

Podsumowanie

Fieldsem
`public static final String`	`ADB_VERSION_KEY`
`public static final String`	`JAVA_CLASSPATH_KEY`
`public static final String`	`JAVA_VERSION_KEY`

Konstruktory publiczne
`InvocationExecution()`

Metody publiczne
`void`	`cleanUpBuilds(IInvocationContext context, IConfiguration config)` Wykonaj krok czyszczenia build_provider.
`void`	`doCleanUp(IInvocationContext context, IConfiguration config, Throwable exception)` Wykonaj czyszczenie w procedurach target_preparer i multi_target_preparer.
`void`	`doSetup(TestInformation testInfo, IConfiguration config, ITestLogger listener)` Wykonaj krok target_preparer i multi_target_preparer.
`void`	`doTeardown(TestInformation testInfo, IConfiguration config, ITestLogger logger, Throwable exception)` Wykonaj kroki target_preparer i multi_target_preparer teardown.
`boolean`	`fetchBuild(TestInformation testInfo, IConfiguration config, IRescheduler rescheduler, ITestInvocationListener listener)` Wykonaj krok build_provider wywołania.
`void`	`reportLogs(ITestDevice device, ITestLogger listener, TestInvocation.Stage stage)` raportować niektóre dzienniki urządzeń na różnych etapach wywołania;
`void`	`runDevicePostInvocationTearDown(IInvocationContext context, IConfiguration config, Throwable exception)` Wywołaj `ITestDevice.postInvocationTearDown(Throwable)` dla każdego urządzenia, które jest częścią wywołania.
`void`	`runDevicePreInvocationSetup(IInvocationContext context, IConfiguration config, ITestLogger logger)` Wywołaj `ERROR(ITestDevice.preInvocationSetup(IBuildInfo)/com.android.tradefed.device.ITestDevice#preInvocationSetup(com.android.tradefed.build.IBuildInfo) ITestDevice.preInvocationSetup(IBuildInfo))` dla każdego urządzenia, które jest częścią wywołania.
`void`	`runTests(TestInformation info, IConfiguration config, ITestInvocationListener listener)` Uruchamia test.
`boolean`	`shardConfig(IConfiguration config, TestInformation testInfo, IRescheduler rescheduler, ITestLogger logger)` Spróbuj podzielić konfigurację na podkonfiguracje, które zostaną ponownie zaplanowane do równoległego działania na wielu zasobach.

Chronione metody
`void`	`collectAutoInfo(IConfiguration config, TestInformation info)` automatycznie zbierać niektóre informacje o głównym urządzeniu testowanym przez użytkownika;
`IShardHelper`	`createShardHelper()` Utwórz `IShardHelper`, który ma być użyty.
`void`	`customizeDevicePreInvocation(IConfiguration config, IInvocationContext context)` Daj użytkownikowi możliwość dostosowania niektórych ustawień urządzenia przed wywołaniem.
`String`	`getAdbVersion()` Zwraca wersję adb używaną do wywołania.
	`getLabPreparersToRun(IConfiguration config, String deviceName)` Pobierz listę przygotowań do zajęć do uruchomienia na tym urządzeniu.
	`getTargetPreparersToRun(IConfiguration config, String deviceName)` Pobierz listę docelowych usług przygotowywania do uruchomienia na tym urządzeniu.
`void`	`linkExternalDirs(IBuildInfo info, TestInformation testInfo)`
`void`	`logHostAdb(IConfiguration config, ITestLogger logger)` Zbierz logi z katalogu $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)` Zarządzanie tagiem testowym w informacjach o kompilacji.

Fieldsem

ADB_VERSION_KEY

public static final String ADB_VERSION_KEY

JAVA_CLASSPATH_KEY

public static final String JAVA_CLASSPATH_KEY

JAVA_VERSION_KEY

public static final String JAVA_VERSION_KEY

Konstruktory publiczne

InvocationExecution

public InvocationExecution ()

Metody publiczne

cleanUpBuilds

public void cleanUpBuilds (IInvocationContext context, 
                IConfiguration config)

Wykonaj krok czyszczenia build_provider. Powiązane z pobieraniem wersji.

Parametry
`context`	`IInvocationContext`: `IInvocationContext` wywołania.
`config`	`IConfiguration`: `IConfiguration` tego testu.

doCleanUp

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

Wykonaj czyszczenie w procedurach target_preparer i multi_target_preparer. Czy urządzenia są czyszczone.

Parametry
`context`	`IInvocationContext`: `IInvocationContext` wywołania.
`config`	`IConfiguration`: `IConfiguration` tego testu.
`exception`	`Throwable`: pierwotne wyjątek rzucony przez test.

doSetup

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

Wykonaj krok target_preparer i multi_target_preparer. Czy wszystkie urządzenia są skonfigurowane do przeprowadzenia testu.

Parametry
`testInfo`	`TestInformation`: `TestInformation` wywołania.
`config`	`IConfiguration`: `IConfiguration` tego testu.
`listener`	`ITestLogger`: `ITestLogger`, aby zgłosić logi niepowodzeń konfiguracji.

Rzuty
`BuildError`
`DeviceNotAvailableException`
`TargetSetupError`

doTeardown

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

Wykonaj kroki target_preparer i multi_target_preparer teardown. Czy urządzenia są rozłożone w układzie?

Parametry
`testInfo`	`TestInformation`: `TestInformation` wywołania.
`config`	`IConfiguration`: `IConfiguration` tego testu.
`logger`	`ITestLogger`: `ITestLogger` do raportowania logów.
`exception`	`Throwable`: pierwotne wyjątek rzucony przez test.

fetchBuild

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

Wykonaj krok build_provider wywołania.

Parametry
`testInfo`	`TestInformation`: `TestInformation` wywołania.
`config`	`IConfiguration`: `IConfiguration` tego testu.
`rescheduler`	`IRescheduler`: `IRescheduler`, aby ponownie zaplanować części wywołania do wykonania na innych zasobach
`listener`	`ITestInvocationListener`: `ITestInvocation`, aby zgłosić niepowodzenia pobierania kompilacji.

Zwroty
`boolean`	Wartość true (prawda), jeśli udało się pobrać wersję, a w przeciwnym razie – wartość false (fałsz).

Rzuty
`BuildRetrievalError`
`DeviceNotAvailableException`

reportLogs

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

raportować niektóre dzienniki urządzeń na różnych etapach wywołania; Na przykład: logcat.

Parametry
`device`	`ITestDevice`: urządzenie, z którego mają być wysyłane dzienniki.
`listener`	`ITestLogger`: rejestrator logów.
`stage`	`TestInvocation.Stage`: etap wywołania, na którym się znajdujemy.

runDevicePostInvocationTearDown

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

Wywołaj ITestDevice.postInvocationTearDown(Throwable) dla każdego urządzenia, które jest częścią wywołania.

Parametry
`context`	`IInvocationContext`: `IInvocationContext` wywołania.
`config`	`IConfiguration`: `IConfiguration` tego testu.
`exception`	`Throwable`: pierwotne wyjątek rzucony przez test, jeśli występuje.

runDevicePreInvocationSetup

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

Wywołaj ERROR(ITestDevice.preInvocationSetup(IBuildInfo)/com.android.tradefed.device.ITestDevice#preInvocationSetup(com.android.tradefed.build.IBuildInfo) ITestDevice.preInvocationSetup(IBuildInfo)) dla każdego urządzenia, które jest częścią wywołania.

Parametry
`context`	`IInvocationContext`: `IInvocationContext` wywołania.
`config`	`IConfiguration`: `IConfiguration` tego testu.
`logger`	`ITestLogger`: `ITestLogger` do raportowania logów.

Rzuty
`DeviceNotAvailableException`
`TargetSetupError`

runTests

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

Uruchamia test.

Parametry
`info`	`TestInformation`: `TestInformation`, z którym mają być wykonywane testy.
`config`	`IConfiguration`: `IConfiguration` do uruchomienia
`listener`	`ITestInvocationListener`: `ITestInvocationListener` wyników testu

shardConfig

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

Spróbuj podzielić konfigurację na podkonfiguracje, które zostaną ponownie zaplanowane do równoległego działania na wielu zasobach.

Jeśli liczba fragmentów jest większa niż 1, usługa utworzy konfiguracje dla każdego z nich, ustawiając indeksy fragmentów i przeplanowując je. Jeśli liczba fragmentów nie jest ustawiona,zostanie użyta wartość IShardHelper.shardConfig.

Parametry
`config`	`IConfiguration`: bieżąca `IConfiguration`.
`testInfo`	`TestInformation`: `TestInformation` zawierający informacje o testach.
`rescheduler`	`IRescheduler`: `IRescheduler`.
`logger`	`ITestLogger`: `ITestLogger` służy do rejestrowania pliku podczas dzielenia na fragmenty.

Zwroty
`boolean`	Prawda, jeśli test został podzielony na fragmenty. W przeciwnym razie zwraca `false`

Chronione metody

collectAutoInfo

protected void collectAutoInfo (IConfiguration config, 
                TestInformation info)

automatycznie zbierać niektóre informacje o głównym urządzeniu testowanym przez użytkownika;

Parametry
`config`	`IConfiguration`
`info`	`TestInformation`

Rzuty
`DeviceNotAvailableException`

createShardHelper

protected IShardHelper createShardHelper ()

Utwórz IShardHelper, który ma być użyty.

Zwroty
`IShardHelper`

customizeDevicePreInvocation

protected void customizeDevicePreInvocation (IConfiguration config, 
                IInvocationContext context)

Daj użytkownikowi możliwość dostosowania niektórych ustawień urządzenia przed wywołaniem.

Parametry
`config`	`IConfiguration`: konfiguracja wywołania.
`context`	`IInvocationContext`: bieżący kontekst wywołania.

getAdbVersion

protected String getAdbVersion ()

Zwraca wersję adb używaną do wywołania.

Zwroty
`String`

getLabPreparersToRun

protected  getLabPreparersToRun (IConfiguration config, 
                String deviceName)

Pobierz listę przygotowań do zajęć do uruchomienia na tym urządzeniu.

Zastąpione w klasach piaskownicy, aby ograniczyć możliwość uruchamiania modułów przygotowujących w piaskownicy podrzędnej

Parametry
`config`	`IConfiguration`
`deviceName`	`String`

Zwroty

getTargetPreparersToRun

protected  getTargetPreparersToRun (IConfiguration config, 
                String deviceName)

Pobierz listę docelowych usług przygotowywania do uruchomienia na tym urządzeniu.

Zastąpione w klasach piaskownicy, aby ograniczyć uruchamianie modułów przygotowujących w piaskownicy podrzędnej

Parametry
`config`	`IConfiguration`
`deviceName`	`String`

Zwroty

linkExternalDirs

protected void linkExternalDirs (IBuildInfo info, 
                TestInformation testInfo)

Parametry
`info`	`IBuildInfo`
`testInfo`	`TestInformation`

logHostAdb

protected void logHostAdb (IConfiguration config, 
                ITestLogger logger)

Zbierz logi z katalogu $TMPDIR/adb.$UID.log.

Parametry
`config`	`IConfiguration`
`logger`	`ITestLogger`

runPreparersTearDown

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

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

Zwroty
`Throwable`

setTestTag

protected void setTestTag (IBuildInfo info, 
                IConfiguration config)

Zarządzanie tagiem testowym w informacjach o kompilacji.

Parametry
`info`	`IBuildInfo`
`config`	`IConfiguration`