A partire dal 2026, per allinearci al nostro modello di sviluppo stabile del trunk e garantire la stabilità della piattaforma per l'ecosistema, pubblicheremo il codice sorgente su AOSP nel secondo e nel quarto trimestre. Per la creazione e il contributo ad AOSP, consigliamo di utilizzare android-latest-release anziché aosp-main. Il ramo del manifest android-latest-release farà sempre riferimento alla release più recente inviata ad AOSP. Per saperne di più, vedi Modifiche ad AOSP.

Sl4aClient

public class Sl4aClient
extends Object

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

Client Sl4A per interagire tramite RPC con il livello di scripting Sl4A.

Riepilogo

Costanti
`String`	`IS_SL4A_RUNNING_CMD`
`String`	`IS_SL4A_RUNNING_CMD_OLD`
`String`	`SL4A_LAUNCH_CMD`
`String`	`STOP_SL4A_CMD`

Costruttori pubblici
`Sl4aClient(ITestDevice device, File sl4aApkFile)` Crea il client Sl4A.
`Sl4aClient(ITestDevice device, int hostPort, int devicePort)` Crea il client Sl4A.

Metodi pubblici
`void`	`close()` Chiude la connessione sl4a al lato dispositivo ed elimina qualsiasi istanza di sl4a in esecuzione.
`Sl4aEventDispatcher`	`getEventDispatcher()` Restituisci il dispatcher di eventi per attendere gli eventi.
`boolean`	`isSl4ARunning()` Restituisce true se il client lato dispositivo sl4a è in esecuzione.
`void`	`open()` Helper per avviare effettivamente la connessione host-dispositivo per sl4a.
`Object`	`rpcCall(String methodName, Object... args)` Esegui una chiamata RPC sul livello sl4a.
`static Sl4aClient`	`startSL4A(ITestDevice device, File sl4aApkFile)` Metodo pratico per creare e avviare un client pronto all'uso.
`void`	`startSl4A()` Avvia il client sl4a sul lato dispositivo.

Metodi protetti
`IRunUtil`	`getRunUtil()` Restituisce l'istanza runutil predefinita.
`void`	`startEventDispatcher()` Avvia il dispatcher di eventi.

Costanti

IS_SL4A_RUNNING_CMD

public static final String IS_SL4A_RUNNING_CMD

Valore costante: "ps -e | grep "S com.googlecode.android_scripting""

IS_SL4A_RUNNING_CMD_OLD

public static final String IS_SL4A_RUNNING_CMD_OLD

Valore costante: "ps | grep "S com.googlecode.android_scripting""

SL4A_LAUNCH_CMD

public static final String SL4A_LAUNCH_CMD

Constant Value: "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

Valore costante: "am force-stop com.googlecode.android_scripting"

Costruttori pubblici

Sl4aClient

public Sl4aClient (ITestDevice device, 
                File sl4aApkFile)

Crea il client Sl4A.

Parametri
`device`	`ITestDevice`: il {ITestDevice} per cui verrà creato il client.
`sl4aApkFile`	`File`: percorso del file dell'APK sl4a da installare o null se è già installato.

Lanci
`DeviceNotAvailableException`

Sl4aClient

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

Crea il client Sl4A.

Parametri
`device`	`ITestDevice`: il {ITestDevice} per cui verrà creato il client.
`hostPort`	`int`: la porta sulla macchina host a cui connettersi al client sl4a.
`devicePort`	`int`: la porta del dispositivo utilizzata per comunicare.

Metodi pubblici

chiudi

public void close ()

Chiude la connessione sl4a al lato dispositivo ed elimina qualsiasi istanza di sl4a in esecuzione. Se non è in esecuzione alcuna istanza, non viene eseguita alcuna operazione.

getEventDispatcher

public Sl4aEventDispatcher getEventDispatcher ()

Restituisci il dispatcher di eventi per attendere gli eventi.

Ritorni
`Sl4aEventDispatcher`

isSl4ARunning

public boolean isSl4ARunning ()

Restituisce true se il client lato dispositivo sl4a è in esecuzione.

Ritorni
`boolean`

Lanci
`DeviceNotAvailableException`

apri

public void open ()

Helper per avviare effettivamente la connessione host-dispositivo per sl4a.

rpcCall

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

Esegui una chiamata RPC sul livello sl4a.

Parametri
`methodName`	`String`: il nome del metodo da chiamare sul lato dispositivo.
`args`	`Object`: l'elenco degli argomenti da utilizzare nel metodo.

Ritorni
`Object`	il risultato della richiesta.

Lanci
	se il metodo richiesto non esiste.

startSL4A

public static Sl4aClient startSL4A (ITestDevice device, 
                File sl4aApkFile)

Metodo pratico per creare e avviare un client pronto all'uso.

Parametri
`device`	`ITestDevice`: il {ITestDevice} per cui verrà creato il client.
`sl4aApkFile`	`File`: percorso del file dell'APK sl4a da installare o null se è già installato.

Ritorni
`Sl4aClient`	un'istanza `Sl4aClient` che è stata avviata.

Lanci
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

startSl4A

public void startSl4A ()

Avvia il client sl4a sul lato dispositivo. Supponiamo che l'APK sl4a sia installato.

Lanci
`DeviceNotAvailableException`

Metodi protetti

getRunUtil

protected IRunUtil getRunUtil ()

Restituisce l'istanza runutil predefinita. Esposto per i test.

Ritorni
`IRunUtil`

startEventDispatcher

protected void startEventDispatcher ()

Avvia il dispatcher di eventi. Esposto per i test.

Lanci
`DeviceNotAvailableException`