Aby zachować zgodność z naszym modelem rozwoju gałęzi głównej i zapewnić stabilność platformy w ekosystemie, w II i IV kwartale 2026 r. opublikujemy kod źródłowy w AOSP. Do tworzenia i współtworzenia AOSP zalecamy używanie android-latest-release zamiast aosp-main. Gałąź android-latest-release manifestu zawsze będzie odnosić się do najnowszej wersji przesłanej do AOSP. Więcej informacji znajdziesz w sekcji Zmiany w AOSP.

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 `InvocationExecution`, która steruje zdalnym wykonaniem.
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`

Publiczne konstruktory
`InvocationExecution()`

Metody publiczne
`void`	`cleanUpBuilds(IInvocationContext context, IConfiguration config)` Wykonaj krok czyszczenia 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 zamykania funkcji 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)` Raportowanie niektórych logów 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 ma być 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.
	`getLabPreparersToRun(IConfiguration config, String deviceName)` Pobierz listę preparatów laboratoryjnych do uruchomienia na tym urządzeniu.
	`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, preparersToRun, 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

Stała wartość: „adb_version”

JAVA_CLASSPATH_KEY

public static final String JAVA_CLASSPATH_KEY

Constant Value: "java_classpath"

JAVA_VERSION_KEY

public static final String JAVA_VERSION_KEY

Stała wartość: "java_version"

Publiczne konstruktory

InvocationExecution

public InvocationExecution ()

Metody publiczne

cleanUpBuilds

public void cleanUpBuilds (IInvocationContext context, 
                IConfiguration config)

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

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

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` tego testu.
`exception`	`Throwable`: pierwotny 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` tego testu.
`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 zamykania funkcji target_preparer i multi_target_preparer. Czy urządzenia są demontowane po zakończeniu konfiguracji.

Parametry
`testInfo`	`TestInformation`: `TestInformation` wywołania.
`config`	`IConfiguration`: `IConfiguration` tego testu.
`logger`	`ITestLogger`: `ITestLogger` do raportowania logów.
`exception`	`Throwable`: pierwotny wyjątek zgłoszony przez uruchomiony 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 zaplanować ponownie części wywołania do wykonania na innych zasobach;
`listener`	`ITestInvocationListener`: `ITestInvocation`, aby zgłaszać błędy pobierania kompilacji.

Zwroty
`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)

Raportowanie niektórych logów 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` tego testu.
`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` tego testu.
`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 przeprowadzić 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 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,zostanie użyta wartość domyślna IShardHelper.shardConfig.

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

Zwroty
`boolean`	Wartość „true”, jeśli test został podzielony na części. W przeciwnym razie zwróć wartość `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 ma być używany.

Zwroty
`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.

Zwroty
`String`

getLabPreparersToRun

protected  getLabPreparersToRun (IConfiguration config, 
                String deviceName)

Pobierz listę osób przygotowujących moduły, które można uruchomić na tym urządzeniu.

Zastąpione w klasach piaskownicy, aby uniemożliwić uruchamianie preparatów w piaskownicy podrzędnej.

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

Zwroty

getTargetPreparersToRun

protected  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 preparatów 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 $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)

Obsługa ustawiania tagu testowego w informacjach o kompilacji.

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