W 2026 r., aby dostosować się do naszego modelu stabilnego rozwoju trunk i zapewnić stabilność platformy w ekosystemie, będziemy publikować kod źródłowy w AOSP w drugim i czwartym kwartale. Do tworzenia i współtworzenia AOSP używaj gałęzi android-latest-release. Gałąź manifestu android-latest-release będzie zawsze odwoływać się do najnowszej wersji przesłanej do AOSP. Więcej informacji znajdziesz w artykule Zmiany w AOSP.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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 przekazują wykonanie do innego pliku binarnego Tradefed.
ParentSandboxInvocationExecution	Wersja `InvocationExecution` dla specjalnych działań wywołania nadrzędnego podczas uruchamiania piaskownicy.
RemoteInvocationExecution	Implementacja interfejsu `InvocationExecution`, która umożliwia zdalne wykonanie.
SandboxedInvocationExecution	Specjalne wykonanie wywołania w piaskownicy: jest to InvocationExecution, gdy wykonujemy polecenie w piaskownicy.

Klasa opisująca wszystkie etapy wywołania: pobieranie kompilacji, przygotowanie urządzenia docelowego, uruchamianie testów i czyszczenie. Można go rozszerzyć, aby zastąpić domyślne działanie niektórych kroków. Kolejność kroków zależy od TestInvocation.

Podsumowanie

Stałe
`String`	`ADB_VERSION_KEY`
`String`	`JAVA_CLASSPATH_KEY`
`String`	`JAVA_VERSION_KEY`

Konstruktory publiczne
`InvocationExecution()`

Metody publiczne
`void`	`cleanUpBuilds(IInvocationContext context, IConfiguration config)` Wykonaj krok zwalniania miejsca build_provider.
`void`	`doCleanUp(IInvocationContext context, IConfiguration config, Throwable exception)` Wykonaj krok czyszczenia target_preparer i multi_target_preparer.
`void`	`doSetup(TestInformation testInfo, IConfiguration config, ITestLogger listener)` Wykonaj krok konfiguracji target_preparer i multi_target_preparer.
`void`	`doTeardown(TestInformation testInfo, IConfiguration config, ITestLogger logger, Throwable exception)` Wykonaj krok zamykający target_preparer i multi_target_preparer.
`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)` Zgłaszanie niektórych logów z urządzenia na różnych etapach wywołania.
`void`	`runDevicePostInvocationTearDown(IInvocationContext context, IConfiguration config, Throwable exception)` Wywołaj `ITestDevice.postInvocationTearDown(Throwable)` dla każdej części urządzenia w ramach 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żdej części urządzenia w ramach 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 uruchomienia na wielu zasobach równolegle.

Metody chronione
`void`	`collectAutoInfo(IConfiguration config, TestInformation info)` Automatycznie zbierać niektóre informacje o głównym testowanym urządzeniu.
`IShardHelper`	`createShardHelper()` Utwórz i zwróć obiekt `IShardHelper`, który będzie używany.
`void`	`customizeDevicePreInvocation(IConfiguration config, IInvocationContext context)` Umożliwia dostosowanie niektórych ustawień urządzenia przed wywołaniem funkcji preInvocationSetup.
`String`	`getAdbVersion()` Zwraca wersję adb używaną w wywołaniu.
`List<ITargetPreparer>`	`getLabPreparersToRun(IConfiguration config, String deviceName)` Pobierz listę osób przygotowujących testy, które mają być przeprowadzane na tym urządzeniu.
`List<ITargetPreparer>`	`getTargetPreparersToRun(IConfiguration config, String deviceName)` Pobierz listę preparatów docelowych do uruchomienia na tym urządzeniu.
`void`	`linkExternalDirs(IBuildInfo info, TestInformation testInfo)`
`void`	`logHostAdb(IConfiguration config, ITestLogger logger)` Zbierz logi z $TMPDIR/adb.$UID.log.
`Throwable`	`runPreparersTearDown(TestInformation testInfo, ITestDevice device, String deviceName, int deviceIndex, ITestLogger logger, Throwable exception, List<ITargetPreparer> preparersToRun, Map<String, Set<ITargetPreparer>> trackPreparersMap)`
`void`	`setTestTag(IBuildInfo info, IConfiguration config)` Obsługa ustawiania tagu testowego w informacjach o kompilacji.

Stałe

ADB_VERSION_KEY

public static final String ADB_VERSION_KEY

Wartość stała: "adb_version"

JAVA_CLASSPATH_KEY

public static final String JAVA_CLASSPATH_KEY

Wartość stała: "java_classpath"

JAVA_VERSION_KEY

public static final String JAVA_VERSION_KEY

Wartość stała: "java_version"

Konstruktory publiczne

InvocationExecution

public InvocationExecution ()

Metody publiczne

cleanUpBuilds

public void cleanUpBuilds (IInvocationContext context, 
                IConfiguration config)

Wykonaj krok zwalniania miejsca build_provider. Powiązane z pobieraniem kompilacji.

Parametry
`context`	`IInvocationContext`: `IInvocationContext` wywołania.
`config`	`IConfiguration`: `IConfiguration` tej sesji testowej.

doCleanUp

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

Wykonaj krok czyszczenia target_preparer i multi_target_preparer. Czy urządzenia są czyszczone.

Parametry
`context`	`IInvocationContext`: `IInvocationContext` wywołania.
`config`	`IConfiguration`: `IConfiguration` tej sesji testowej.
`exception`	`Throwable`: oryginalny wyjątek zgłoszony przez uruchomiony test.

doSetup

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

Wykonaj krok konfiguracji target_preparer i multi_target_preparer. Konfiguruje wszystkie urządzenia wymagane do przeprowadzenia testu.

Parametry
`testInfo`	`TestInformation`: `TestInformation` wywołania.
`config`	`IConfiguration`: `IConfiguration` tej sesji testowej.
`listener`	`ITestLogger`: `ITestLogger` do raportowania błędów konfiguracji.

Zgłasza
`BuildError`
`DeviceNotAvailableException`
`TargetSetupError`

doTeardown

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

Wykonaj krok zamykający target_preparer i multi_target_preparer. Czy urządzenia są rozbierane w ramach konfiguracji.

Parametry
`testInfo`	`TestInformation`: `TestInformation` wywołania.
`config`	`IConfiguration`: `IConfiguration` tej sesji testowej.
`logger`	`ITestLogger`: `ITestLogger` do raportowania logów.
`exception`	`Throwable`: oryginalny wyjątek zgłoszony przez uruchomiony test.

Zgłasza
`Throwable`

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` tej sesji testowej.
`rescheduler`	`IRescheduler`: `IRescheduler`, aby zaplanować ponownie części wywołania do wykonania na innych zasobach.
`listener`	`ITestInvocationListener`: `ITestInvocation`, aby zgłaszać niepowodzenia pobierania kompilacji.

Zwraca
`boolean`	Wartość true, jeśli udało nam się pobrać kompilację. W przeciwnym razie wartość false.

Zgłasza
`BuildRetrievalError`
`DeviceNotAvailableException`

reportLogs

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

Zgłaszanie niektórych logów z urządzenia na różnych etapach wywołania. Na przykład: logcat.

Parametry
`device`	`ITestDevice`: Urządzenie, z którego mają być przesyłane logi.
`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żdej części urządzenia w ramach wywołania.

Parametry
`context`	`IInvocationContext`: `IInvocationContext` wywołania.
`config`	`IConfiguration`: `IConfiguration` tej sesji testowej.
`exception`	`Throwable`: pierwotny wyjątek zgłoszony przez uruchomiony test (jeśli wystąpił).

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żdej części urządzenia w ramach wywołania.

Parametry
`context`	`IInvocationContext`: `IInvocationContext` wywołania.
`config`	`IConfiguration`: `IConfiguration` tej sesji testowej.
`logger`	`ITestLogger`: `ITestLogger` do raportowania logów.

Zgłasza
`DeviceNotAvailableException`
`TargetSetupError`

runTests

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

Uruchamia test.

Parametry
`info`	`TestInformation`: `TestInformation`, za pomocą którego chcesz uruchomić testy.
`config`	`IConfiguration`: `IConfiguration` do uruchomienia
`listener`	`ITestInvocationListener`: `ITestInvocationListener` wyników testu

Zgłasza
`Throwable`

shardConfig

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

Spróbuj podzielić konfigurację na podkonfiguracje, które zostaną ponownie zaplanowane do uruchomienia na wielu zasobach równolegle.

Jeśli liczba fragmentów jest większa niż 1, utworzy konfiguracje dla każdego fragmentu, ustawiając indeksy fragmentów i ponownie je zaplanuje. Jeśli liczba fragmentów nie jest ustawiona,domyślnie będzie to IShardHelper.shardConfig.

Parametry
`config`	`IConfiguration`: bieżący `IConfiguration`.
`testInfo`	`TestInformation`: `TestInformation` zawierający informacje o testach.
`rescheduler`	`IRescheduler`: `IRescheduler`.
`logger`	`ITestLogger`: `ITestLogger` używany do logowania pliku podczas dzielenia na fragmenty.

Zwraca
`boolean`	Wartość „true”, jeśli test został podzielony na części. W przeciwnym razie zwróć `false`

Metody chronione

collectAutoInfo

protected void collectAutoInfo (IConfiguration config, 
                TestInformation info)

Automatycznie zbierać niektóre informacje o głównym testowanym urządzeniu.

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

Zgłasza
`DeviceNotAvailableException`

createShardHelper

protected IShardHelper createShardHelper ()

Utwórz i zwróć obiekt IShardHelper, który będzie używany.

Zwraca
`IShardHelper`

customizeDevicePreInvocation

protected void customizeDevicePreInvocation (IConfiguration config, 
                IInvocationContext context)

Umożliwia dostosowanie niektórych ustawień urządzenia przed wywołaniem funkcji preInvocationSetup.

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

getAdbVersion

protected String getAdbVersion ()

Zwraca wersję adb używaną w wywołaniu.

Zwraca
`String`

getLabPreparersToRun

protected List<ITargetPreparer> getLabPreparersToRun (IConfiguration config, 
                String deviceName)

Pobierz listę osób przygotowujących testy, które mają być przeprowadzane na tym urządzeniu.

Zastąpione w klasach piaskownicy, aby uniemożliwić uruchamianie w piaskownicy podrzędnej narzędzi do przygotowywania modułów

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

Zwraca
`List<ITargetPreparer>`

getTargetPreparersToRun

protected List<ITargetPreparer> getTargetPreparersToRun (IConfiguration config, 
                String deviceName)

Pobierz listę preparatów docelowych do uruchomienia na tym urządzeniu.

Zastąpione w klasach piaskownicy, aby uniemożliwić uruchamianie w piaskownicy podrzędnej narzędzi do przygotowywania modułów

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

Zwraca
`List<ITargetPreparer>`

linkExternalDirs

protected void linkExternalDirs (IBuildInfo info, 
                TestInformation testInfo)

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

logHostAdb

protected void logHostAdb (IConfiguration config, 
                ITestLogger logger)

Zbierz logi z $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, 
                List<ITargetPreparer> preparersToRun, 
                Map<String, Set<ITargetPreparer>> trackPreparersMap)

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

Zwraca
`Throwable`

setTestTag

protected void setTestTag (IBuildInfo info, 
                IConfiguration config)

Obsługa ustawiania tagu testowego w informacjach o kompilacji.

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