目录

JSVM-API简介

场景介绍

HarmonyOS JSVM-API基于标准JS引擎提供了一套稳定的API,支持创建和销毁引擎、执行JS代码、JS与C++的交互等关键功能。

HarmonyOS JSVM-API是C语言接口,遵循C99标准。

HarmonyOS JSVM-API是并发不安全接口,开发者需保障JSVM-API的并发安全性。

通过JSVM-API,可以在应用运行期间直接执行动态加载的JS代码。此外,可以将对性能和底层系统调用有较高要求的核心功能用C/C++实现,并将C++方法注册到JS侧,从而在JS代码中直接调用,提高应用执行效率。

本文中如无特别说明,后续均使用JSVM-API指代HarmonyOS JSVM-API能力。

JSVM-API仅支持JS与C/C++的交互,如果需要实现ArkTS与C/C++的交互,请参考Node-API简介。

JSVM-API的组成架构

图1 JSVM-API的组成架构

JSVM-API的关键交互流程

图2 JSVM-API的关键交互流程

JSVM-API与Native模块之间的交互流程主要分为以下两步:

  1. 初始化阶段:在Native模块上初始化JSVM和JS上下文,并完成Native函数的注册。Native方法将被挂载到JS执行环境的全局上下文即GlobalThis。

  2. 调用阶段:当JS侧调用通过JSVM-API注册到JS全局上下文的方法时,JS引擎会找到并调用对应的C/C++方法。