از 27 مارس 2025، توصیه می کنیم از android-latest-release به جای aosp-main برای ساختن و کمک به AOSP استفاده کنید. برای اطلاعات بیشتر، به تغییرات AOSP مراجعه کنید.
از Trade Federation با لایه اسکریپت برای اندروید استفاده کنید
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
Scripting Layer for Android، SL4A، یک مجموعه ابزار اتوماسیون برای فراخوانی APIهای اندروید به روشی مستقل از پلتفرم است. هم از اتوماسیون از راه دور از طریق adb و هم از اجرای اسکریپت ها از روی دستگاه از طریق یک سری لایه های ترجمه سبک پشتیبانی می کند.
این پروژه در پلت فرم/external/sl4a واقع شده است.
استفاده کنید
می توانید SL4A README را برای ساخت و نصب دستی دنبال کنید. و هنگام اجرا از طریق Tradefed، می‌توانید از برخی از ابزارهای مهار برای سهولت استفاده استفاده کنید.
دانلود و نصب کنید
می‌توانید با مرور BT-discovery-sl4a.xml ، یک نمونه پیکربندی Tradefed که از دو دستگاه استفاده می‌کند، شروع کنید. SL4A.apk در اکثر بیلدهای دستگاه در پوشه tests آنها موجود است.
مثال Tradefed بالا به طور خودکار بیلدها را واکشی می کند، هر دو دستگاه را فلش می کند و SL4A.apk را روی هر دو دستگاه نصب می کند. شما می توانید آن را به این صورت اجرا کنید:
source build/envsetup.sh
lunch
make sl4a
tradefed.sh run google/example/BT-discovery-sl4a
یا یک بار ساخته شد:
./tradefed.sh run google/example/BT-discovery-sl4a
یک تست در Tradefed با استفاده از SL4A بنویسید
می توانید نمونه آزمایشی را که در بالا توضیح داده شده است دنبال کنید: Sl4aBluetoothDiscovery.java . این مثال خوبی از جریان استفاده از SL4A در تست Tradefed می دهد.
اسناد SL4A API
لیست کامل تماس های موجود از طریق SL4A قابل تولید است. از دایرکتوری منبع SL4A، platform/external/sl4a/ ، این دستور را اجرا کنید:
python Docs/generate_api_reference_md.py
در دایرکتوری Docs یک فایل ApiReference.md وجود خواهد داشت که حاوی توابع RPC موجود در SL4A و همچنین مستنداتی برای توابع RPC است.
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین بهروزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# Use Trade Federation with Scripting Layer for Android\n\nScripting Layer for Android, SL4A, is an\nautomation toolset for calling Android APIs in a platform-independent manner.\nIt supports both remote automation via `adb` and execution of scripts\nfrom on-device via a series of lightweight translation layers.\n\nThe project is located at [platform/external/sl4a](https://android.googlesource.com/platform/external/sl4a/).\n\nUse\n---\n\nYou can follow the [SL4A README](https://android.googlesource.com/platform/external/sl4a/+/refs/heads/android16-release/README.md)\nto build and install it manually. And when running through Tradefed, you\ncan take advantage of some of the harness utilities to make use easier.\n\n### Download and install\n\nYou can start by reviewing\n[BT-discovery-sl4a.xml](https://android.googlesource.com/platform/tools/tradefederation/contrib/+/refs/heads/android16-release/res/config/google/example/BT-discovery-sl4a.xml),\nan example Tradefed configuration that uses two devices. The `SL4A.apk` is\navailable in most device builds within their `tests` folder.\n\nThe Tradefed example above automatically fetches the builds, flashes both\ndevices and installs `SL4A.apk` on both devices. You can run it like so: \n\n source build/envsetup.sh\n lunch\n make sl4a\n tradefed.sh run google/example/BT-discovery-sl4a\n\nOr once built: \n\n ./tradefed.sh run google/example/BT-discovery-sl4a\n\n### Write a test in Tradefed using SL4A\n\nYou can follow the test sample describe above:\n[Sl4aBluetoothDiscovery.java](https://android.googlesource.com/platform/tools/tradefederation/contrib/+/refs/heads/android16-release/src/com/android/tradefed/Sl4aBluetoothDiscovery.java).\nThis gives a good example of the flow to use SL4A within a Tradefed test.\n\n### SL4A API documentation\n\nThe complete list of callbacks available through SL4A can be generated. From the\nSL4A source directory, `platform/external/sl4a/`, run this command: \n\n python Docs/generate_api_reference_md.py\n\nIn the Docs directory there will be an `ApiReference.md` file that contains\nthe RPC functions available in SL4A, as well as documentation for the RPC\nfunctions."]]
