اعتبارًا من عام 2026، ولضمان اتّساق نموذج التطوير الثابت الأساسي واستقرار المنصة في النظام المتكامل، سننشر رمز المصدر في مشروع Android مفتوح المصدر (AOSP) في الربعَين الثاني والرابع. لبناء مشروع Android مفتوح المصدر والمساهمة فيه، استخدِم android-latest-release. سيشير فرع بيان android-latest-release دائمًا إلى أحدث إصدار تم نشره في مشروع Android مفتوح المصدر. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في مشروع Android مفتوح المصدر.

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

Sl4aClient

public class Sl4aClient
extends Object implements AutoCloseable

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

عميل Sl4A للتفاعل عبر استدعاء إجراء عن بُعد (RPC) مع طبقة النصوص البرمجية في Sl4A

ملخّص

الثوابت
`String`	`IS_SL4A_RUNNING_CMD`
`String`	`IS_SL4A_RUNNING_CMD_OLD`
`String`	`SL4A_LAUNCH_CMD`
`String`	`STOP_SL4A_CMD`

طُرق وضع التصميم العامة
`Sl4aClient(ITestDevice device, int hostPort, int devicePort)` تنشئ هذه السمة عميل Sl4A.
`Sl4aClient(ITestDevice device, File sl4aApkFile)` تنشئ هذه السمة عميل Sl4A.

الإجراءات العامة
`void`	`close()` إغلاق اتصال sl4a بجانب الجهاز وإيقاف أي مثيل قيد التشغيل من sl4a
`Sl4aEventDispatcher`	`getEventDispatcher()` أعِد وحدة إرسال الأحداث لانتظار الأحداث.
`boolean`	`isSl4ARunning()` تعرض هذه الدالة القيمة "صحيح" إذا كان تطبيق sl4a على الجهاز قيد التشغيل.
`void`	`open()` فئة مساعدة لبدء اتصال المضيف بالجهاز في sl4a.
`Object`	`rpcCall(String methodName, Object... args)` تنفيذ طلب إجراء مكالمة RPC على طبقة sl4a
`static Sl4aClient`	`startSL4A(ITestDevice device, File sl4aApkFile)` طريقة ملائمة لإنشاء عميل جاهز للاستخدام وبدء استخدامه.
`void`	`startSl4A()` يبدأ برنامج sl4a على الجهاز.

طُرق محمية
`IRunUtil`	`getRunUtil()` إرجاع مثيل runutil التلقائي
`void`	`startEventDispatcher()` يبدأ أداة إرسال الأحداث.

الثوابت

IS_SL4A_RUNNING_CMD

public static final String IS_SL4A_RUNNING_CMD

القيمة الثابتة: "ps -e | grep "S com.googlecode.android_scripting""

IS_SL4A_RUNNING_CMD_OLD

public static final String IS_SL4A_RUNNING_CMD_OLD

القيمة الثابتة: "ps | grep "S com.googlecode.android_scripting""

SL4A_LAUNCH_CMD

public static final String SL4A_LAUNCH_CMD

القيمة الثابتة: "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

القيمة الثابتة: "am force-stop com.googlecode.android_scripting"

طُرق وضع التصميم العامة

Sl4aClient

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

تنشئ هذه السمة عميل Sl4A.

المعلَمات
`device`	‫`ITestDevice`: {ITestDevice} الذي سيتم استخدام العميل معه.
`hostPort`	`int`: المنفذ على الجهاز المضيف الذي سيتم الاتصال به من خلال عميل sl4a.
`devicePort`	‫`int`: منفذ الجهاز المستخدَم للتواصل

Sl4aClient

public Sl4aClient (ITestDevice device, 
                File sl4aApkFile)

تنشئ هذه السمة عميل Sl4A.

المعلَمات
`device`	‫`ITestDevice`: {ITestDevice} الذي سيتم استخدام العميل معه.
`sl4aApkFile`	‫`File`: مسار الملف إلى حزمة sl4a apk المطلوب تثبيتها، أو قيمة فارغة إذا تم تثبيتها من قبل.

عمليات الطرح
`DeviceNotAvailableException`

الإجراءات العامة

إغلاق

public void close ()

إغلاق اتصال sl4a بجانب الجهاز وإيقاف أي مثيل قيد التشغيل من sl4a إذا لم يكن هناك أي مثيل قيد التشغيل، لن يتم تنفيذ أي إجراء.

getEventDispatcher

public Sl4aEventDispatcher getEventDispatcher ()

أعِد وحدة إرسال الأحداث لانتظار الأحداث.

المرتجعات
`Sl4aEventDispatcher`

isSl4ARunning

public boolean isSl4ARunning ()

تعرض هذه الدالة القيمة "صحيح" إذا كان تطبيق sl4a على الجهاز قيد التشغيل.

المرتجعات
`boolean`

عمليات الطرح
`DeviceNotAvailableException`

فتح

public void open ()

فئة مساعدة لبدء اتصال المضيف بالجهاز في sl4a.

rpcCall

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

تنفيذ طلب إجراء مكالمة RPC على طبقة sl4a

المعلَمات
`methodName`	استبدِل `String` باسم الطريقة التي سيتم استدعاؤها على جانب الجهاز.
`args`	`Object`: قائمة الوسيطات التي سيتم استخدامها في الطريقة

المرتجعات
`Object`	نتيجة الطلب

عمليات الطرح
`IOException`	إذا لم تكن الطريقة المطلوبة متوفّرة

startSL4A

public static Sl4aClient startSL4A (ITestDevice device, 
                File sl4aApkFile)

طريقة ملائمة لإنشاء عميل جاهز للاستخدام وبدء استخدامه.

المعلَمات
`device`	‫`ITestDevice`: {ITestDevice} الذي سيتم استخدام العميل معه.
`sl4aApkFile`	‫`File`: مسار الملف إلى حزمة sl4a apk المطلوب تثبيتها، أو قيمة فارغة إذا تم تثبيتها من قبل.

المرتجعات
`Sl4aClient`	مثيل `Sl4aClient` تم بدء تشغيله

عمليات الطرح
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

startSl4A

public void startSl4A ()

يبدأ برنامج sl4a على الجهاز. افترِض أنّ حزمة APK الخاصة بـ sl4a مثبّتة.

عمليات الطرح
`DeviceNotAvailableException`

طُرق محمية

getRunUtil

protected IRunUtil getRunUtil ()

إرجاع مثيل runutil التلقائي يتم عرضها للاختبار.

المرتجعات
`IRunUtil`

startEventDispatcher

protected void startEventDispatcher ()

يبدأ أداة إرسال الأحداث. يتم عرضها للاختبار.

عمليات الطرح
`DeviceNotAvailableException`