Google Git
Sign in
android / platform / external / sl4a / 9260b052896327fe981e6407b8c75908300a89f9
commit9260b052896327fe981e6407b8c75908300a89f9[log] [tgz]
authorSarah Boechat <monikermine@google.com>Fri Sep 27 15:01:15 2019 -0700
committerandroid-build-merger <android-build-merger@google.com>Fri Sep 27 15:01:15 2019 -0700
treef616da320acf8302bf7ef465f62976bedd31d76d
parentddeb027907a71c7a8e9e59a260b963af2a0d8006 [diff]
parent31d2cac239992dd1fea2524fb7ce09a21708aa55 [diff]
Adding facade for ImsMmTelManager so that multi sim devices can have multiple sim cards set for Enabling/Disabling VoLTE. am: 04eaf57526 am: 79044df54c am: 793cd5f75b
am: 31d2cac239

Change-Id: I24ab0c0220e8a24c127643ced4e0dbdea56e655b
tree: f616da320acf8302bf7ef465f62976bedd31d76d
  1. Common/
  2. Docs/
  3. InterpreterForAndroid/
  4. ScriptingLayer/
  5. ScriptingLayerForAndroid/
  6. Utils/
  7. MODULE_LICENSE_APACHE2
  8. NOTICE
  9. OWNERS
  10. PREUPLOAD.cfg
  11. README.md
README.md

Scripting Layer For Android

Introduction

Originally authored by Damon Kohler, Scripting Layer for Android, SL4A, is an automation toolset for calling Android APIs in a platform-independent manner. It supports both remote automation via ADB as well as execution of scripts from on-device via a series of lightweight translation layers.

Build Instructions

Due to its inclusion in AOSP as a privileged app, building SL4A requires a system build.

For the initial build of Android:

cd <ANDROID_SOURCE_ROOT>
source build/envsetup.sh
lunch aosp_<TARGET>
make [-j15]

where <ANDROID_SOURCE_ROOT> is the root directory of the android tree and <TARGET> is the lunch target name

Then Build SL4A:

cd <ANDROID_SOURCE_ROOT>/external/sl4a
mm [-j15]

Adding SL4A Builds to Android Builds by Default

  1. If you are not using a custom buildspec, create one as follows:

     cp <ANDROID_SOURCE_ROOT>/build/buildspec.mk.default <ANDROID_SOURCE_ROOT>/buildspec.mk

  2. Modify the buildspec to build SL4A as a custom module by editing the line ‘#CUSTOM_MODULES:=’ to ‘CUSTOM_MODULES:=sl4a’:

     sed -i 's/#CUSTOM_MODULES:=/CUSTOM_MODULES:=sl4a/' <ANDROID_SOURCE_ROOT>/buildspec.mk

Install Instructions

Run the following command:

adb install -r <ANDROID_SOURCE_ROOT>/out/target/product/<TARGET>/data/app/sl4a/sl4a.apk

Run Instructions

a) SL4A may be launched from Android as a normal App; or
b) To enable RPC access from the command prompt:

adb forward tcp:<HOST_PORT_NUM> tcp:<DEVICE_PORT_NUM>
adb shell "am start -a com.googlecode.android_scripting.action.LAUNCH_SERVER \
           --ei com.googlecode.android_scripting.extra.USE_SERVICE_PORT <DEVICE_PORT_NUM> \
           com.googlecode.android_scripting/.activity.ScriptingLayerServiceLauncher"

where <HOST_PORT_NUM> and <DEVICE_PORT_NUM> are the tcp ports on the host computer and device.

Generate the API Documentation

From SL4A source directory run this command:

    python Docs/generate_api_reference_md.py

In the Docs directory there should now be an ApiReference.md file that contains which RPC functions are available in SL4A as well as documentation for the RPC functions.