鸿蒙5.0开发进阶:NDK开发-使用JSVM-API实现JS与C/C++语言交互开发流程

鸿蒙HarmonyOS实战:创建NDK工程、毕昇编译器 为顺利进行NDK开发,开发者需要先掌握必要的基本概念及基础知识。 阅读详情

往期鸿蒙全套实战文章必看:


使用JSVM-API实现JS与C/C++语言交互开发流程

使用JSVM-API实现跨语言交互,首先需要按照JSVM-API的机制实现模块的注册和加载等相关动作。

  • ArkTS/JS侧:实现C++方法的调用。代码比较简单,import一个对应的so库后,即可调用C++方法。

  • Native侧:.cpp文件,实现模块的注册。需要提供注册lib库的名称,并在注册回调方法中定义接口的映射关系,即Native方法及对应的JS/ArkTS接口名称等。

此处以在ArkTS/JS侧实现RunJsVm()接口、在Native侧实现RunJsVm()接口,从而实现跨语言交互为例,呈现使用JSVM-API进行跨语言交互的流程。

创建Native C++工程

Native侧方法的实现

  • 设置模块注册信息

  • 模块初始化

    实现ArkTS接口与C++接口的绑定和映射。

    // entry/src/main/cpp/hello.cpp
    EXTERN_C_START
    // 模块初始化
    static napi_value Init(napi_env env, napi_value exports)
    {
        // ArkTS接口与C++接口的绑定和映射
        napi_property_descriptor desc[] = {
            {"runJsVm", nullptr, RunJsVm, nullptr, nullptr, nullptr, napi_default, nullptr},
        };
        // 在exports对象上挂载RunJsVm的Native方法
        napi_define_properties(env, exports, sizeof(desc) / sizeof(desc[0]), desc);
        return exports;
    }
    EXTERN_C_END
  • 在index.d.ts文件中,提供JS侧的接口方法。

    // entry/src/main/cpp/types/libentry/index.d.ts
    export const runJsVm: (jsCode: string) => void;
  • 在oh-package.json5文件中将index.d.ts与cpp文件关联起来。

    {
      "name": "libentry.so",
      "types": "./index.d.ts",
      "version": "",
      "description": "Please describe the basic information."
    }
  • 在CMakeLists.txt文件中配置CMake打包参数。

    # entry/src/main/cpp/CMakeLists.txt
    cmake_minimum_required(VERSION 3.4.1)
    project(JSVMDemo)
    
    set(NATIVERENDER_ROOT_PATH ${CMAKE_CURRENT_SOURCE_DIR})
    # 日志打印配置
    add_definitions( "-DLOG_DOMAIN=0xd0d0" )
    add_definitions( "-DLOG_TAG=\"testTag\"" )
    include_directories(${NATIVERENDER_ROOT_PATH}
                        ${NATIVERENDER_ROOT_PATH}/include)
    
    # 添加名为entry的库
    add_library(entry SHARED hello.cpp)
    # 构建此可执行文件需要链接的库
    target_link_libraries(entry PUBLIC libace_napi.z.so libjsvm.so libhilog_ndk.z.so)
  • 实现Native侧的RunJsVm接口。具体代码如下:

    // entry/src/main/cpp/hello.cpp
    #include "napi/native_api.h"
    #include "ark_runtime/jsvm.h"
    #include <sys/stat.h>
    #include <thread>
    #include <unistd.h>
    #include <bits/alltypes.h>
    #include <hilog/log.h>
    static int g_aa = 0;
    static JSVM_Value Assert(JSVM_Env env, JSVM_CallbackInfo info)
    {
      size_t argc = 2;
      JSVM_Value args[2] = {nullptr};
      OH_JSVM_GetCbInfo(env, info, &argc, args, nullptr, nullptr);
      bool isStrictEquals;
      if (argc > 1) {
          OH_JSVM_StrictEquals(env, args[0], args[1], &isStrictEquals);
      } else {
          JSVM_Value valTrue;
          OH_JSVM_GetBoolean(env, true, &valTrue);
          OH_JSVM_StrictEquals(env, args[0], valTrue, &isStrictEquals);
      }
      if (isStrictEquals) {
          OH_LOG_INFO(LOG_APP, "JSVM API TEST RESULT: PASS");
      } else {
          OH_LOG_ERROR(LOG_APP, "JSVM API TEST RESULT: FAILED");
      }
      JSVM_Value result;
      OH_JSVM_GetBoolean(env, isStrictEquals, &result);
      return result;
    }
    
    // Assert方法注册回调
    static JSVM_CallbackStruct param[] = {
        {.data = nullptr, .callback = Assert},
    };
    static JSVM_CallbackStruct *method = param;
    // Assert方法别名,TS侧调用
    static JSVM_PropertyDescriptor descriptor[] = {
        {"assert", nullptr, method++, nullptr, nullptr, nullptr, JSVM_DEFAULT},
    };
    
    // 获取JavaScript代码字符串
    static std::string getCodeString(napi_env nEnv, napi_callback_info nInfo) {
        size_t argc = 1;
        napi_value argv[1] = {nullptr};
        napi_get_cb_info(nEnv, nInfo, &argc, argv, nullptr, nullptr);
        std::string jsCodeStr;
        size_t result = 0;
        napi_get_value_string_utf8(nEnv, argv[0], nullptr, NAPI_AUTO_LENGTH, &result);
        const size_t bufSize = result + 1;
        char *buf = new char[bufSize];
        napi_status status = napi_get_value_string_utf8(nEnv, argv[0], buf, bufSize, &result);
        if (status == napi_ok) {
            jsCodeStr = buf;
        }
        free(buf);
        return jsCodeStr;
    }
    
    // javascript代码执行失败的处理
    void RunScriptFail(napi_env &nEnv, JSVM_Env &env, JSVM_Status &res) {
        JSVM_Value exceptionValue;
        JSVM_Status status = OH_JSVM_GetAndClearLastException(env, &exceptionValue);
        if (status == JSVM_OK) {
            JSVM_Value message;
            OH_JSVM_GetNamedProperty(env, exceptionValue, "message", &message);
            size_t length;
            OH_JSVM_GetValueStringUtf8(env, message, nullptr, 0, &length);
            char *buffer = new char[length + 1];
            OH_JSVM_GetValueStringUtf8(env, message, buffer, length + 1, nullptr);
            napi_throw_error(nEnv, std::to_string(static_cast<int>(status)).c_str(), buffer);
            delete[] buffer;
        } else {
            napi_throw_error(nEnv, std::to_string(static_cast<int>(status)).c_str(), nullptr);
            OH_LOG_INFO(LOG_APP, "JSVM RunJsVm failed Error code:  %{public}d", static_cast<int>(res));
        }
    }
    // RunJsVm函数创建JavaScript VM,创建JS执行的上下文环境来执行JS代码获取JSVM_Value。
    static napi_value RunJsVm(napi_env nEnv, napi_callback_info nInfo) {
        std::string jsCodeStr = getCodeString(nEnv, nInfo);
        JSVM_InitOptions initOptions;
        memset(&initOptions, 0, sizeof(initOptions));
        // InitOptions外部引用赋值
        initOptions.externalReferences = nullptr;
        if (g_aa == 0) {
            g_aa++;
            // 初始化JavaScript引擎实例
            OH_JSVM_Init(&initOptions);
        }
        JSVM_VM vm;
        JSVM_CreateVMOptions options;
        memset(&options, 0, sizeof(options));
        // 创建JavaScript引擎实例
        OH_JSVM_CreateVM(&options, &vm);
        JSVM_VMScope vmScope;
        // 打开一个新的VM scope,引擎实例只能在scope范围内使用,可以保证引擎实例不被销毁
        OH_JSVM_OpenVMScope(vm, &vmScope);
        JSVM_Env env;
        // 创建一个新的JS执行上下文环境,并注册指定的Native函数
        JSVM_Status res = OH_JSVM_CreateEnv(vm, sizeof(descriptor) / sizeof(descriptor[0]), descriptor, &env);
        if (res != JSVM_OK) {
            OH_LOG_INFO(LOG_APP, "JSVM API OH_JSVM_CreateEnv failed res is %{public}d", static_cast<int>(res));
        }
        JSVM_EnvScope envScope;
        // 打开一个新的Env scope,Env只能在scope范围内使用
        OH_JSVM_OpenEnvScope(env, &envScope);
        JSVM_HandleScope handleScope;
        // 打开一个Handle scope
        OH_JSVM_OpenHandleScope(env, &handleScope);
        std::string sourceCodeStr = jsCodeStr;
        napi_value nResult = nullptr;
        JSVM_Value jsVmResult;
        OH_LOG_INFO(LOG_APP, "JSVM API RunJsVm %{public}s", sourceCodeStr.c_str());
        // 根据传入的JavaScript代码字符串判断是否调用获取自定义结构数据的方法
        if (strcmp(sourceCodeStr.c_str(), "defineClass") == 0) {
            // DefineClass预留
             OH_LOG_INFO(LOG_APP, "JSVM API DefineClass called");
        } else {
            JSVM_Value sourceCodeValue = nullptr;
            OH_JSVM_CreateStringUtf8(env, sourceCodeStr.c_str(), sourceCodeStr.size(), &sourceCodeValue);
            JSVM_Script script;
            // 编译JavaScript代码字符串并返回编译后的脚本
            OH_JSVM_CompileScript(env, sourceCodeValue, nullptr, 0, true, nullptr, &script);
            // 执行JavaScript代码字符串
            res = OH_JSVM_RunScript(env, script, &jsVmResult);
            if (res != JSVM_OK) {
                RunScriptFail(nEnv, env, res);
                napi_get_boolean(nEnv, false, &nResult);
            } else {
                napi_get_boolean(nEnv, true, &nResult);
            }
        }
        // 关闭Handle scope
        OH_JSVM_CloseHandleScope(env, handleScope);
        // 关闭Env scope
        OH_JSVM_CloseEnvScope(env, envScope);
        // 关闭VM scope
        OH_JSVM_CloseVMScope(vm, vmScope);
        // 销毁一个JS执行上下文环境
        OH_JSVM_DestroyEnv(env);
        // 销毁JavaScript引擎实例
        OH_JSVM_DestroyVM(vm);
        return nResult;
    }

ArkTS侧调用C/C++方法实现

import hilog from '@ohos.hilog'
// 通过import的方式,引入Native能力。
import napitest from 'libentry.so'
// test assert
try {
  let data = false;
  let script: string = `assert(${data});`;
  let result = napitest.runJsVm(script);
  hilog.info(0x0000, 'testJSVM', 'Test JSVM Assert:%{public}s', result);
} catch (error) {
  hilog.error(0x0000, 'testJSVM', 'Test JSVM Assert error: %{public}s', error);
}

HarmonyOS Next开发学习手册——JSVM-API(一) HarmonyOS JSVM-API是基于标准JS引擎提供的一套稳定的ABI,为开发者提供了较为完整的JS引擎能力,包括创建和销毁引擎,执行JS代码,JS/C++交互等关键能力。通过JSVM-API,开发者可以在应用运行期间直接执行一段动态加载的JS代码。也可以选择将一些对性能、底层系统调用有较高要求的核心功能用C/C++实现并将C++方法注册到JS侧,在JS代码中直接调用,提高应用的执行效率。本文中如无特别说明,后续均使用JSVM-API指代HarmonyOS JSVM-API能力。 阅读详情

相关推荐

openHarmony使用Napi开发样例

NAPI的开发。可以添加函数,c++文件和c++打的so

m0_49071631的博客 2910

鸿蒙NEXT版实战开发:应用侧与前端页面的相互调用(C/C++)(前端页面JavaScript)

本指导适用于ArkWeb应用侧与前端网页通信场景......

qq_39652397的博客 1479

基于立创EDA的8口全千兆POE交换机设计详解:RTL8370N芯片与90W大功率供电方案

本文详细解析了基于立创EDA设计的8口全千兆POE交换机方案,核心采用RTL8370N交换芯片与支持90W大功率供电的IEEE 802.3bt标准PD芯片。文章深入探讨了PSE/PD供电管理、电源架构设计、电路细节及关键散热方案,为DIY或学习POE交换机硬件设计提供了完整的开源实践指南。

weixin_29050829的博客 1万+

鸿蒙5.0开发进阶:NDK代码开发-JSVM-API开发规范(JSVM-API常见问题)

JSVM-API常见问题...........

Androidbye的博客 1083

PCIe扫盲(三)

需要特别注意的是,PCIe的Spec中明确规定只有Root有权限发起配置请求(Originate Configuration Requests),也就是说PCIe系统里面的其他设备是不允许去配置其他设备的配置空间的,即peer-to-peer的配置请求是不允许的。当配置请求进行BDF路由的时候,正是依靠这些信息来确定要找的设备的。前面的文章还介绍过,Root和Switch的每一个端口中都包含一个P2P桥,并且知道桥的配置空间头(Configuration Space Header)是Type1型的。

Liuqz2009的专栏 2411

【Labview】对连续采集数据的一种采样方法

图1如图1,想要对这样一个连续信号进行数据点的采集,我根据网上收集到的方法,在此分享一下最终的结果。可以拓展结合文件的写入,完成对连续信号的采集和输出。 已知: 一个连续信号,如图1. 目标: 设定一定采集点个数、采集点时间间隔、和采集周期次数,得到这条连续信号的数据点,如图2. 图2 方法如下: 主要利用的是队列的方法。 在连续信号生成的时候,不断的写入队列,并且清除队列。 ...

李时珍食疗志的博客 1万+

鸿蒙5.0开发进阶:NDK代码开发-使用JSVM-API实现JS与C/C++语言交互开发流程

使用JSVM-API实现跨语言交互.........

Androidbye的博客 796

大数据国赛第2套任务C-子任务一特征工程

根据**Hudi**的dwd_ds_hudi库中相关表或MySQL中shtd_store中相关表(order_detail、sku_info),计算出与用户id为6708的用户所购买相同商品种类最多的前10位用户(只考虑他俩购买过多少种相同的商品,不考虑相同的商品买了多少次),将10位用户id进行输出,若与多个用户购买的商品种类相同,则输出结果按照用户id升序排序,输出格式如下,将结果截图粘贴至客户端桌面【Release任务C提交结果.docx】中对应的任务序号下;

weixin_44117248的博客 906

鸿蒙5.0开发进阶:NDK代码开发-JSVM-API使用指南(使用JSVM-API接口进行primitive类相关开发)

在使用JSVM-API接口时......

Androidbye的博客 1038

逆变器专题(6)-正负序分离(二阶广义积分器DSOGI)

相应仿真原件请移步资源下载DSOGI作为一种常用的正负序分离方法,其可以在电压三相不平衡的状态下实现较为精准的锁相环。

cyc19980105的博客 8808

【数据集】1980-2020年(5年)土地利用分类数据-中国科学院

简介1980-2020年每五年土地利用数据-中国科学院

WW、forever的博客 3936

鸿蒙5.0开发进阶:NDK代码开发-JSVM-API使用指南(使用JSVM-API接口进行WebAssembly模块相关开发)

JSVM-API WebAssembly 接口提供了 WebAssembly 字节码编译、WebAssembly 函数优化、WebAssembly cache 序列化和反序列化的能力。

Androidbye的博客 1105

华为OD机试 - 整型数组按照个位数排序(Python/JS/C/C++ 双机位C卷 100分)

本专栏收录于《华为OD机试真题(Python/JS/C/C++)》。刷的越多,抽中的概率越大,私信哪吒,备注华为OD,加入华为OD刷题交流群,每一题都有详细的答题思路、详细的代码注释、3个测试用例、为什么这道题采用XX算法、XX算法的适用场景,发现新题目,随时更新。给定一个非空数组(列表),其元素数据类型为整型,请按照数组元素十进制最低位从小到大进行排序,十进制最低位相同的元素,相对位置保持不变。当数组元素为负值时,十进制最低位等同于去除符号位后对应十进制值最低位。给定一个非空数组,其元素数据类型为32位有

学Java,找哪吒 400

鸿蒙5.0开发进阶:NDK代码开发-JSVM-API典型使用场景指南(JSVM-API调试&定位)

本文将介绍调试、CPU Profiler、Heap Snapshot的使用方法。

Androidbye的博客 696

YOLOv11改进 | 特殊场景检测篇 | 低照度图像增强网络SCINet改进黑暗目标检测(全网独家首发)

本文给大家带来的改进机制是低照度图像增强网络SCINet,SCINet(自校正照明网络)是一种专为低光照图像增强设计的框架。它通过级联照明学习过程和权重共享机制来处理图像,优化了照明部分以提升图像质量。我将该网络集成在YOLOv11的主干上针对于图像的输入进行增强,同时该网络的并不会增加参数和计算量,基本和普通的网络结构保持一致,同时该结构支持自定义调节层数,来控制图像增强的效果 ,非常适合想要在黑夜目标检测领域发表文章的读者,该基本网络不会影响模型的速度。欢迎大家订阅我的专栏一起学习YOLO!

Snu77的博客 2207

汉书HE8,好用的汇编代码编写工具

汉书HE8,好用的汇编代码编写工具早期编写汇编代码所用功能强大

鸿蒙5.0开发进阶:NDK代码开发-JSVM-API使用指南(使用JSVM-API接口进行object相关开发)

使用JSVM-API接口进行object相关开发........

Androidbye的博客 948

efm32 入门.pdf

本PDF共计22页,介绍的是操作驱动API,下载与否自己斟酌。

鸿蒙5.0开发进阶:NDK代码开发-JSVM-API使用指南(使用JSVM进行class相关开发)

使用JSVM-API接口进行class相关开发,处理JavaScript中的类,例如定义类、构造实例等。

Androidbye的博客 796

LinePhone3.2.7(android端最新版本) sip客户端

SIP客户端For android:LinePhone3.2.7(最新版本),官网地址:http://www.linphone.org/

jre9下载 jdk9

(Java SE Runtime Environment 9.0) 9.0u175 官方最新版 【x86|x64】

鸿蒙5.0开发进阶:NDK代码开发-JSVM-API使用指南(使用JSVM-API接口进行错误处理开发)

使用JSVM-API接口进行错误处理开发..........

Androidbye的博客 1043

鸿蒙5.0开发进阶:NDK代码开发-JSVM-API使用指南(使用JSVM-API接口处理异步操作)

使用JSVM-API接口处理异步操作。

Androidbye的博客 1093

鸿蒙5.0开发进阶:NDK代码开发-JSVM-API使用指南(使用JSVM-API接口创建基本数据类型)

在JavaScript中,整数类型是一种基本数据类型,用于表示没有小数部分的数值。

Androidbye的博客 865

鸿蒙5.0开发进阶:NDK代码开发-JSVM-API使用指南(使用JSVM-API接口操作bigint类型值)

BigInt是JavaScript中用于表示任意精度整数的数据类型......

Androidbye的博客 698

鸿蒙5.0开发进阶:NDK代码开发-JSVM-API使用指南(使用JSVM-API接口进行ArrayBuffer相关开发)

ArrayBuffer 是 JavaScript 中的一种数据类型,用于表示通用的、固定长度的原始二进制数据缓冲区。

Androidbye的博客 950

鸿蒙5.0开发进阶:NDK代码开发-JSVM-API使用指南(使用JSVM-API接口进行JavaScript代码调试调优)

这些JSVM-API接口涵盖了虚拟机实例检索、内存分析、性能剖析和调试支持.........

Androidbye的博客 682

鸿蒙5.0开发进阶:NDK代码开发-JSVM-API使用指南(使用JSVM-API接口进行array相关开发)

使用 JSVM-API 接口进行数组(array)相关开发时........

Androidbye的博客 704

鸿蒙5.0开发进阶:NDK代码开发-JSVM-API使用指南(使用JSVM-API接口设置JavaScript对象的属性)

使用JSVM-API接口获取和设置JavaScript对象的属性。

Androidbye的博客 652

鸿蒙5.0开发进阶:NDK代码开发-JSVM-API使用指南(使用JSVM-API接口进行Date相关开发)

JSVM-API中date相关接口用于处理JavaScript Date对象.........

Androidbye的博客 591
上一篇: 鸿蒙5.0开发进阶:NDK开发-使用Node-API接口从异步线程向ArkTS线程投递指定优先级和入队方式的的任务
下一篇: 鸿蒙5.0开发进阶:NDK开发-JSVM-API开发规范
懂你的大海
博客等级 码龄6年 9049粉丝 1381原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值