在 Android 使用 QuickJS JavaScript 引擎教程

• 2021 年 6 月 1 日
• 笔记
• Android

quickjs-android 是 QuickJS JavaScript 引擎的 Android 接口框架，整体基于面向对象设计，提供了自动GC功能，使用简单。armeabi-v7a 的大小仅 350KB，是 Google V8 不错的替代品，启动速度比 V8 快，内存占用更低，支持 ES2020。

使用教程

//github.com/taoweiji/quickjs-android

引入依赖

implementation 'io.github.taoweiji.quickjs:quickjs-android:1.1.3'

简单示例

QuickJS quickJS = QuickJS.createRuntime();
JSContext context = quickJS.createContext();
int result = context.executeIntegerScript("var a = 2+10;\n a;", "file.js");
context.close();
quickJS.close();

对象介绍

QuickJS

运行环境，可以创建多个运行时环境，不同的环境之间不能共享对象，不使用的时候需要销毁。

QuickJS quickJS = QuickJS.createRuntime();

JSContext

由 QuickJS 创建，一个 QuickJS 可以创建多个 JSContext，不使用的时候需要销毁。

JSContext context = quickJS.createContext();
int result = context.executeIntegerScript("var a = 2+10;\n a;", "file.js");
String result = context.executeStringScript("'Hello World';", "file.js");

JSObject

JSObject user = new JSObject(context).set("name", "Wiki").set("age", 18);
Log.e("QuickJS", String.valueOf(user.getString("name")));
Log.e("QuickJS", String.valueOf(user.getInteger("age")));

user.registerJavaMethod(new JavaVoidCallback() {
    @Override
    public void invoke(JSObject receiver, JSArray args) {
        Log.e("QuickJS", args.getString(0));
    }
}, "log");
user.executeVoidFunction("log", new JSArray(context).push("Hello World"));

JSArray

JSArray array = new JSArray(context).push(1).push(3.14).push(true).push("Hello World");
Log.e("QuickJS", String.valueOf(array.getInteger(0)));
Log.e("QuickJS", String.valueOf(array.getDouble(1)));

JSFunction

JSFunction log = new JSFunction(context, new JavaVoidCallback() {
    @Override
    public void invoke(JSObject receiver, JSArray args) {
        Log.e("QuickJS", args.getString(0));
    }
});
JSFunction message = new JSFunction(context, new JavaCallback() {
    @Override
    public Object invoke(JSObject receiver, JSArray array) {
        return "Hello World";
    }
});
context.set("console", new JSObject(context).set("log", log).set("message", message));
context.executeVoidScript("console.log(console.message())", null);

QuickJS

JSValue

对象会自动回收，开发者无需手动close()

JSObject

继承JSValue

JSArray

继承JSObject

JSFunction

继承JSObject

JSContext

继承JSObject，拥有JSObject全部方法，对象本身是全局对象