通过 J2V8 在 Android 使用 V8 JavaScri

V8 引擎是由 Google 开源的 JavaScript 引擎，大名鼎鼎的 Chrome 就是基于 V8 开发，V8 是基于 C++ 开发，可以轻松移植到各种平台，当然也可以移植到 Android 使用。其中 J2V8 是最多人选择的框架，非常适合在 Android 上使用。

添加 Gradle 依赖

implementation 'com.eclipsesource.j2v8:j2v8:6.2.0@aar'

由于 V8 的 so 文件特别的大，每个平台都有 7MB 左右，建议在正式包只包含armeabi-v7a的 so 文件

    buildTypes {
        release {
                ...
            ndk {
                abiFilters  "armeabi-v7a"
            }
        }
    }

简单示例

由于V8运行属于耗时任务，执行复杂JS脚本的时候尽量不要在主线程执行，执行结束的需要也要释放，避免导致内存泄漏。

V8 v8 = V8.createV8Runtime();
Object result = v8.executeScript("var a = 1+2;\n a;");
Log.e("v8", result.toString());
v8.close();

executeScript（执行JavaScript脚本）

• Object executeScript(String script)
• int executeIntegerScript(String script)
• boolean executeBooleanScript(String script)
• String executeStringScript(String script)
• double executeDoubleScript(String script)
• void executeVoidScript(String script)
• ...

V8提供了各种类型的 execute 方法，executeIntegerScript 的意思是脚本的返回值是 int 类型 executeStringScript 的返回值是 String 类型，executeVoidScript 是没有返回值，以此类推。如果需要返回值只需要在脚本的最后填写相应的返回值即可。

V8 v8 = V8.createV8Runtime();
int result = v8.executeIntegerScript("var a = 1+2;\n a;");
Log.e("v8", String.valueOf(result));
v8.close();

add（注入对象）

V8 提供了 add 方法，可以往运行环境注入对象.

V8 v8 = V8.createV8Runtime();
v8.add("a", 1);
v8.add("b", 2);
int result = v8.executeIntegerScript("var c = a + b;\n c;");
Log.e("v8", String.valueOf(result));
v8.close();

registerJavaMethod（注入Java方法）

V8 v8 = V8.createV8Runtime();
v8.registerJavaMethod(new JavaCallback() {
    @Override
    public Object invoke(V8Object v8Object, V8Array v8Array) {
        return v8Array.getInteger(0) + v8Array.getInteger(1);
    }
}, "add");
int result = v8.executeIntegerScript("var a = add(1, 2);\n a;");
Log.e("v8", String.valueOf(result));
v8.close();

除了通过Callback的方式注入，还可以把Java对象通过反射的方式注入到 V8。

static class Helper {
    public int addInteger(int a, int b) {
        return a + b;
    }
}
void test() {
    V8 v8 = V8.createV8Runtime();
    Helper helper = new Helper();
    v8.registerJavaMethod(helper, "addInteger", "add", new Class[]{int.class, int.class});
    int result = v8.executeIntegerScript("var a = add(1, 2);\n a;");
    Log.e("v8", String.valueOf(result));
    v8.close();
}

实现Console

static class Console {
    public void log(final String message) {
        Log.e("Console", "[INFO] " + message);
    }

    public void error(final String message) {
        Log.e("Console", "[ERROR] " + message);
    }
}

void test() {
    V8 v8 = V8.createV8Runtime();
    Console console = new Console();
    V8Object v8Console = new V8Object(v8);
    v8.add("console", v8Console);
    v8Console.registerJavaMethod(console, "log", "log", new Class<?>[]{String.class});
    v8Console.registerJavaMethod(console, "error", "error", new Class<?>[]{String.class});
    v8.executeScript("console.log('Hello World')");
    v8Console.close();
    v8.close();
}

executeFunction（Java 调用 JavaScript 函数）

J2V8 也提供了 Java 调用 JavaScript 函数的方式，提供了各种入参方式。

• Object executeFunction(String name, V8Array parameters)
• Object executeJSFunction(String name)
• Object executeJSFunction(String name, Object... parameters)
• int executeIntegerFunction(String name, V8Array parameters)
• ...

V8 v8 = V8.createV8Runtime();
v8.executeScript("function add(a, b) {return a + b;}");
V8Array param = new V8Array(v8);
param.push(1);
param.push(2);
int result = v8.executeIntegerFunction("add", param);
// 等同于上面代码 Object result = v8.executeJSFunction("add", 1, 2);
Log.e("v8", String.valueOf(result));
// 创建的V8对象必须要手动销毁
param.close();
v8.close();

V8Executor（多线程）

J2V8也封装了多线程模型V8Executor，通过这个模型可以非常简单实现异步编程。

V8Executor executor = new V8Executor("log('V8Executor');") {
    @Override
    protected void setup(V8 runtime) {
        runtime.registerJavaMethod(new JavaVoidCallback() {
            @Override
            public void invoke(V8Object v8Object, V8Array v8Array) {
                Log.e("v8", v8Array.getString(0));
            }
        }, "log");
    }
};
executor.start();

多线程消息队列

除了基本的异步编程，V8Executor 还提供了消息队列，可以让 V8Executor 接收参数执行函数，接收消息的 messageHandler 函数可以自己定义，这里定义了一个叫做 postMessage 的函数来接收消息队列的信息。

V8Executor executor = new V8Executor("function postMessage(msg) {log(msg.toString())}", true, "postMessage") {
    @Override
    protected void setup(V8 runtime) {
        runtime.registerJavaMethod(new JavaVoidCallback() {
            @Override
            public void invoke(V8Object v8Object, V8Array v8Array) {
                Log.e("v8", v8Array.getString(0));
            }
        }, "log");
    }
};
executor.start();
executor.postMessage("Hello");
executor.postMessage("World");