The description of LL script APIs can be found here
net.pierrox.lightning_launcher.script.api. The LL objet is the entry point for most things.
Some Android classes can be directly used through scripting (creation of new instances, access to static fields - aka constants - and method calls). The list of supported classes are:
LL.bindClass(String name)will conveniently suppress the need for explicit package naming (
Sensor.TYPE_ACCELEROMETERwould be enough if
LL.bindClass("android.hardware.Sensor");has been called previously.
Use the new Script Editor icon (in your app drawer) to quickly edit scripts. No need to configure events and select run a script: just launch the script editor and it will open on the last edited script.
API calls are expensive, and you never know what is hidden behind. It is a good idea to keep return values in local variables to minimize API calls. For instance:
alert(LL.getEvent().getTouchX()+" / "+LL.getEvent().getTouchY()); /* BAD */ var e = LL.getEvent(); alert(e.getTouchX()+" / "+e.getTouchY()); /* BETTER */
While it is possible to move, rotate or change items configuration, performances may not be enough to sustain a 60Hz animation rate.
It is possible to set timers using setTimeout. Pay special attention to clear these timers when needed, LL won't do this for you. If you don't clear timers, you may severly increase CPU use and battery consumption.
Avoid keeping references to objects returned by LL APIs in the script side, otherwise you may leak data. It is possible to use
selfto store data that are kept between two script execution (and can be shared between scripts), but try to avoid this as much as possible.