Ab 2026 werden wir den Quellcode im 2. und 4. Quartal in AOSP veröffentlichen, um unser trunk-stable-Entwicklungsmodell zu unterstützen und die Plattformstabilität für das Ökosystem zu gewährleisten. Für die Entwicklung und das Beitragen zu AOSP empfehlen wir die Verwendung von android-latest-release anstelle von aosp-main. Der Manifestzweig android-latest-release verweist immer auf das neueste Release, das an AOSP übertragen wurde. Weitere Informationen finden Sie unter Änderungen an AOSP.

Sl4aClient

public class Sl4aClient
extends Object

java.lang.Object
↳	com.android.tradefed.util.sl4a.Sl4aClient

Sl4A-Client für die Interaktion über RPC mit der SL4A-Scripting-Ebene.

Zusammenfassung

Konstanten
`String`	`IS_SL4A_RUNNING_CMD`
`String`	`IS_SL4A_RUNNING_CMD_OLD`
`String`	`SL4A_LAUNCH_CMD`
`String`	`STOP_SL4A_CMD`

Öffentliche Konstruktoren
`Sl4aClient(ITestDevice device, File sl4aApkFile)` Erstellt den Sl4A-Client.
`Sl4aClient(ITestDevice device, int hostPort, int devicePort)` Erstellt den Sl4A-Client.

Öffentliche Methoden
`void`	`close()` Schließt die sl4a-Verbindung zur Geräteseite und beendet alle laufenden Instanzen von sl4a.
`Sl4aEventDispatcher`	`getEventDispatcher()` Geben Sie den Ereignis-Dispatcher zurück, um auf Ereignisse zu warten.
`boolean`	`isSl4ARunning()` Gibt „true“ zurück, wenn der SL4A-Client auf dem Gerät ausgeführt wird.
`void`	`open()` Helfer, der die Verbindung zwischen Host und Gerät für SL4A startet.
`Object`	`rpcCall(String methodName, Object... args)` Führen Sie einen RPC-Aufruf auf der SL4A-Ebene aus.
`static Sl4aClient`	`startSL4A(ITestDevice device, File sl4aApkFile)` Praktische Methode zum Erstellen und Starten eines einsatzbereiten Clients.
`void`	`startSl4A()` Startet den sl4a-Client auf dem Gerät.

Geschützte Methoden
`IRunUtil`	`getRunUtil()` Gibt die Standard-runutil-Instanz zurück.
`void`	`startEventDispatcher()` Startet den Ereignis-Dispatcher.

Konstanten

IS_SL4A_RUNNING_CMD

public static final String IS_SL4A_RUNNING_CMD

Constant Value: "ps -e | grep "S com.googlecode.android_scripting""

IS_SL4A_RUNNING_CMD_OLD

public static final String IS_SL4A_RUNNING_CMD_OLD

Constant Value: "ps | grep "S com.googlecode.android_scripting""

SL4A_LAUNCH_CMD

public static final String SL4A_LAUNCH_CMD

Konstanter Wert: "am start -a com.googlecode.android_scripting.action.LAUNCH_SERVER --ei com.googlecode.android_scripting.extra.USE_SERVICE_PORT %s com.googlecode.android_scripting/.activity.ScriptingLayerServiceLauncher"

STOP_SL4A_CMD

public static final String STOP_SL4A_CMD

Konstanter Wert: "am force-stop com.googlecode.android_scripting"

Öffentliche Konstruktoren

Sl4aClient

public Sl4aClient (ITestDevice device, 
                File sl4aApkFile)

Erstellt den Sl4A-Client.

Parameter
`device`	`ITestDevice`: das {ITestDevice}, für das der Client bestimmt ist.
`sl4aApkFile`	`File`: Dateipfad zur zu installierenden SL4A-APK oder „null“, wenn sie bereits installiert ist.

Ausgabe
`DeviceNotAvailableException`

Sl4aClient

public Sl4aClient (ITestDevice device, 
                int hostPort, 
                int devicePort)

Erstellt den Sl4A-Client.

Parameter
`device`	`ITestDevice`: das {ITestDevice}, für das der Client bestimmt ist.
`hostPort`	`int`: Der Port auf dem Hostcomputer, mit dem eine Verbindung zum SL4A-Client hergestellt werden soll.
`devicePort`	`int`: Der Geräteport, der für die Kommunikation verwendet wird.

Öffentliche Methoden

Schließen

public void close ()

Schließt die sl4a-Verbindung zur Geräteseite und beendet alle laufenden Instanzen von sl4a. Wenn keine Instanz ausgeführt wird, geschieht nichts.

getEventDispatcher

public Sl4aEventDispatcher getEventDispatcher ()

Geben Sie den Ereignis-Dispatcher zurück, um auf Ereignisse zu warten.

Returns
`Sl4aEventDispatcher`

isSl4ARunning

public boolean isSl4ARunning ()

Gibt „true“ zurück, wenn der SL4A-Client auf dem Gerät ausgeführt wird.

Returns
`boolean`

Ausgabe
`DeviceNotAvailableException`

Öffnen

public void open ()

Helfer, der die Verbindung zwischen Host und Gerät für SL4A startet.

rpcCall

public Object rpcCall (String methodName, 
                Object... args)

Führen Sie einen RPC-Aufruf auf der SL4A-Ebene aus.

Parameter
`methodName`	`String`: der Name der Methode, die auf der Geräteseite aufgerufen werden soll.
`args`	`Object`: Die Argumentliste, die für die Methode verwendet werden soll.

Returns
`Object`	Das Ergebnis der Anfrage.

Ausgabe
	wenn die angeforderte Methode nicht vorhanden ist.

startSL4A

public static Sl4aClient startSL4A (ITestDevice device, 
                File sl4aApkFile)

Praktische Methode zum Erstellen und Starten eines einsatzbereiten Clients.

Parameter
`device`	`ITestDevice`: das {ITestDevice}, für das der Client bestimmt ist.
`sl4aApkFile`	`File`: Dateipfad zur zu installierenden SL4A-APK oder „null“, wenn sie bereits installiert ist.

Returns
`Sl4aClient`	eine gestartete `Sl4aClient`-Instanz.

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

startSl4A

public void startSl4A ()

Startet den SL4A-Client auf dem Gerät. Angenommen, die SL4A-APK ist installiert.

Ausgabe
`DeviceNotAvailableException`

Geschützte Methoden

getRunUtil

protected IRunUtil getRunUtil ()

Gibt die Standard-Runutil-Instanz zurück. Für Tests verfügbar gemacht.

Returns
`IRunUtil`

startEventDispatcher

protected void startEventDispatcher ()

Startet den Ereignis-Dispatcher. Für Tests verfügbar gemacht.

Ausgabe
`DeviceNotAvailableException`