HarmonOS实战开发：Node-API接口适配模块加载指导

2024-09-02 04:36
文章标签 实战 模块 加载 接口 开发 api node 指导 适配 harmonos

本文主要是介绍HarmonOS实战开发：Node-API接口适配模块加载指导，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

Node-API中的napi_load_module_with_info接口的功能是进行模块的加载，当模块加载出来之后，可以使用函数napi_get_property获取模块导出的变量，也可以使用napi_get_named_property获取模块导出的函数，该函数可以在新创建的ArkTs基础运行时环境中使用

函数说明

napi_status napi_load_module_with_info(napi_env env,const char* path,const char* module_info,napi_value* result);
参数说明
env当前的虚拟机环境
path加载的文件路径或者模块名
module_infobundleName/moduleName的路径拼接
result加载的模块

注意

  1. bundleName表示AppScope/app.json5中配置的工程名
  2. moduleName指的是待加载模块所在的HAP下module.json5中配置的名字
  3. napi_load_module只局限于在主线程中进行模块加载

napi_load_module_with_info支持的场景

场景详细分类说明
本地工程模块HAP加载模块内文件路径要求路径以moduleName开头
本地工程模块HAP加载HAR模块名-
远程包HAP加载远程HAR模块名-
远程包HAP加载ohpm包名-
APIHAP加载@ohos.或 @system.-
模块Native库HAP加载libNativeLibrary.so-

注意

  1. 加载一个模块名，实际的行为是加载该模块的入口文件，一般为index.ets/ts。
  2. 如果在HAR中加载另外一个HAR，需要确保module_info的配置正确，尤其注意moduleName应为HAP的moduleName。
  3. 如果在HAP/HSP中直接或间接使用了三方包，该三方包中使用napi_load_module_with_info接口加载其他模块A，则需要在HAP/HSP中也添加A的依赖。

使用示例

  • HAP加载模块内文件路径

当加载文件中的模块时，如以下ArkTS代码：

//./src/main/ets/Test.ets
let value = 123;
function test() {console.log("Hello HarmonyOS");
}
export {value, test};
  • 需要在工程的build-profile.json5文件中进行以下配置
{"buildOption" : {"arkOptions" : {"runtimeOnly" : {"sources": ["./src/main/ets/Test.ets"]}}}
}
  • 使用napi_load_module_with_info加载Test文件，调用函数test以及获取变量value
static napi_value loadModule(napi_env env, napi_callback_info info) {napi_value result;//1. 使用napi_load_module_with_info加载Test文件中的模块napi_status status = napi_load_module_with_info(env, "entry/src/main/ets/Test", "com.example.application/entry", &result);napi_value testFn;//2. 使用napi_get_named_property获取test函数napi_get_named_property(env, result, "test", &testFn);//3. 使用napi_call_function调用函数testnapi_call_function(env, result, testFn, 0, nullptr, nullptr);napi_value value;napi_value key;std::string keyStr = "value";napi_create_string_utf8(env, keyStr.c_str(), keyStr.size(), &key);//4. 使用napi_get_property获取变量valuenapi_get_property(env, result, key, &value);return result;
}
  • HAP加载HAR模块名

HAR包Index.ets文件如下

//library Index.ets
let value = 123;
function test() {console.log("Hello HarmonyOS");
}
export {value, test};

在加载本地HAR包时，首先需要在oh-package.json5文件中配置dependencies项

{"dependencies": {"library": "file:../library"}
}

其次，还需要在build-profile.json5中进行配置

{"buildOption" : {"arkOptions" : {"runtimeOnly" : {"packages": ["library"]}}}
}

用napi_load_module_with_info加载library，调用函数test以及获取变量value

static napi_value loadModule(napi_env env, napi_callback_info info) {napi_value result;//1. 使用napi_load_module_with_info加载librarynapi_status status = napi_load_module_with_info(env, "library", "com.example.application/entry", &result);napi_value testFn;//2. 使用napi_get_named_property获取test函数napi_get_named_property(env, result, "test", &testFn);//3. 使用napi_call_function调用函数testnapi_call_function(env, result, testFn, 0, nullptr, nullptr);napi_value value;napi_value key;std::string keyStr = "value";napi_create_string_utf8(env, keyStr.c_str(), keyStr.size(), &key);//4. 使用napi_get_property获取变量valuenapi_get_property(env, result, key, &value);return result;
}
  • HAP加载远程HAR模块名

在远程HAR模块名时，首先需要在oh-package.json5文件中配置dependencies项

{"dependencies": {"@ohos/hypium": "1.0.16"}
}

其次，还需要在build-profile.json5中进行配置

{"buildOption" : {"arkOptions" : {"runtimeOnly" : {"packages": ["@ohos/hypium"]}}}
}

用napi_load_module_with_info加载@ohos/hypium，获取DEFAULT变量

static napi_value loadModule(napi_env env, napi_callback_info info) {napi_value result;//1. 使用napi_load_module_with_info加载@ohos/hypiumnapi_status status = napi_load_module_with_info(env, "@ohos/hypium", "com.example.application/entry", &result);napi_value key;std::string keyStr = "DEFAULT";napi_create_string_utf8(env, keyStr.c_str(), keyStr.size(), &key);//2. 使用napi_get_property获取DEFAULT变量napi_value defaultValue;napi_get_property(env, result, key, &defaultValue);return result;
}
  • HAP加载ohpm包名

在加载ohpm包时，首先需要在oh-package.json5文件中配置dependencies项

{"dependencies": {"json5": "^2.2.3"}
}

其次，还需要在build-profile.json5中进行配置

{"buildOption" : {"arkOptions" : {"runtimeOnly" : {"packages": ["json5"]}}}
}

用napi_load_module_with_info加载json5，调用函数stringify

static napi_value loadModule(napi_env env, napi_callback_info info) {napi_value result;//1. 使用napi_load_module_with_info加载json5napi_status status = napi_load_module_with_info(env, "json5", "com.example.application/entry", &result);napi_value key;std::string keyStr = "default";napi_create_string_utf8(env, keyStr.c_str(), keyStr.size(), &key);//2. 使用napi_get_property获取default对象napi_value defaultValue;napi_get_property(env, result, key, &defaultValue);napi_value stringifyFn;//3. 使用napi_get_named_property获取stringify函数napi_get_named_property(env, defaultValue, "stringify", &stringifyFn);//4. 使用napi_call_function调用函数stringifynapi_value argStr;std::string text = "call json5 stringify";napi_create_string_utf8(env, text.c_str(), text.size(), &argStr);napi_value args[1] = {argStr};napi_value returnValue;napi_call_function(env, defaultValue, stringifyFn, 1, args, &returnValue);return result;
}
  • HAP加载API模块
static napi_value loadModule(napi_env env, napi_callback_info info) {//1. 使用napi_load_module_with_info加载模块@ohos.hilognapi_value result;napi_status status = napi_load_module_with_info(env, "@ohos.hilog", nullptr, &result);//2. 使用napi_get_named_property获取info函数napi_value infoFn;napi_get_named_property(env, result, "info", &infoFn);napi_value tag;std::string formatStr = "test";napi_create_string_utf8(env, formatStr.c_str(), formatStr.size(), &tag);napi_value outputString;std::string str = "Hello HarmonyOS";napi_create_string_utf8(env, str.c_str(), str.size(), &outputString);napi_value flag;napi_create_int32(env, 0, &flag);napi_value args[3] = {flag, tag, outputString};//3. 使用napi_call_function调用info函数napi_call_function(env, result, infoFn, 3, args, nullptr);return result;
}
  • HAP加载Native库

libentry.so的index.d.ts文件如下

//index.d.ts
export const add: (a: number, b: number) => number;

在加载本地so库时，首先需要在oh-package.json5文件中配置dependencies项

{"dependencies": {"libentry.so": "file:../src/main/cpp/types/libentry"}
}

其次，还需要在build-profile.json5中进行配置

{"buildOption" : {"arkOptions" : {"runtimeOnly" : {"packages": ["libentry.so"]}}}
}

用napi_load_module_with_info加载libentry.so，调用函数add

static napi_value loadModule(napi_env env, napi_callback_info info) {napi_value result;//1. 使用napi_load_module_with_info加载libentry.sonapi_status status = napi_load_module_with_info(env, "libentry.so", "com.example.application/entry", &result);napi_value addFn;//2. 使用napi_get_named_property获取add函数napi_get_named_property(env, result, "add", &addFn);napi_value a;napi_value b;napi_create_int32(env, 2, &a);napi_create_int32(env, 3, &b);napi_value args[2] = {a, b};//3. 使用napi_call_function调用函数addnapi_value returnValue;napi_call_function(env, result, addFn, 2, args, &returnValue);return result;
}
  • HAR加载HAR模块名

场景为har1加载har2，har2中的Index.ets文件如下

//har2 Index.ets
let value = 123;
function test() {console.log("Hello HarmonyOS");
}
export {value, test};

在加载har2时，首先需要在har1中的oh-package.json5文件中配置dependencies项

{"dependencies": {"har2": "file:../har2"}
}

其次，还需要在har1的build-profile.json5文件中进行配置

{"buildOption" : {"arkOptions" : {"runtimeOnly" : {"packages": ["har2"]}}}
}

在har1中用napi_load_module_with_info加载har2，调用函数test以及获取变量value

static napi_value loadModule(napi_env env, napi_callback_info info) {napi_value result;//1. 使用napi_load_module_with_info加载har2，注意这里的moduleName为模块所在HAP包的moduleNamenapi_status status = napi_load_module_with_info(env, "har2", "com.example.application/entry", &result);napi_value testFn;//2. 使用napi_get_named_property获取test函数napi_get_named_property(env, result, "test", &testFn);//3. 使用napi_call_function调用函数testnapi_call_function(env, result, testFn, 0, nullptr, nullptr);napi_value value;napi_value key;std::string keyStr = "value";napi_create_string_utf8(env, keyStr.c_str(), keyStr.size(), &key);//4. 使用napi_get_property获取变量valuenapi_get_property(env, result, key, &value);return result;
}

这篇关于HarmonOS实战开发：Node-API接口适配模块加载指导的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/1129010。

相关文章

网页解析 lxml 库--实战

网页解析 lxml 库--实战

lxml库使用流程 lxml 是 Python 的第三方解析库，完全使用 Python 语言编写，它对 XPath表达式提供了良好的支 持，因此能够了高效地解析 HTML/XML 文档。本节讲解如何通过 lxml 库解析 HTML 文档。 pip install lxml lxm| 库提供了一个 etree 模块，该模块专门用来解析 HTML/XML 文档，下面来介绍一下 lxml 库
阅读更多...
这15个Vue指令，让你的项目开发爽到爆

这15个Vue指令，让你的项目开发爽到爆

1. V-Hotkey 仓库地址: github.com/Dafrok/v-ho… Demo: 戳这里 https://dafrok.github.io/v-hotkey 安装: npm install --save v-hotkey 这个指令可以给组件绑定一个或多个快捷键。你想要通过按下 Escape 键后隐藏某个组件，按住 Control 和回车键再显示它吗？小菜一碟： <template
阅读更多...
python: 多模块(.py)中全局变量的导入

python: 多模块(.py)中全局变量的导入

文章目录 global关键字可变类型和不可变类型数据的内存地址单模块(单个py文件)的全局变量示例总结 多模块(多个py文件)的全局变量from x import x导入全局变量示例 import x导入全局变量示例 总结 global关键字 global 的作用范围是模块(.py)级别： 当你在一个模块（文件）中使用 global 声明变量时，这个变量只在该模块的全局命名空
阅读更多...
Hadoop企业开发案例调优场景

Hadoop企业开发案例调优场景

需求 （1）需求：从1G数据中，统计每个单词出现次数。服务器3台，每台配置4G内存，4核CPU，4线程。 （2）需求分析： 1G / 128m = 8个MapTask；1个ReduceTask；1个mrAppMaster 平均每个节点运行10个 / 3台 ≈ 3个任务（4    3    3） HDFS参数调优 （1）修改：hadoop-env.sh export HDFS_NAMENOD
阅读更多...
性能分析之MySQL索引实战案例

性能分析之MySQL索引实战案例

文章目录 一、前言二、准备三、MySQL索引优化四、MySQL 索引知识回顾五、总结 一、前言 在上一讲性能工具之 JProfiler 简单登录案例分析实战中已经发现SQL没有建立索引问题，本文将一起从代码层去分析为什么没有建立索引？ 开源ERP项目地址：https://gitee.com/jishenghua/JSH_ERP 二、准备 打开IDEA找到登录请求资源路径位置
阅读更多...
深入探索协同过滤：从原理到推荐模块案例

深入探索协同过滤：从原理到推荐模块案例

文章目录 前言一、协同过滤1. 基于用户的协同过滤（UserCF）2. 基于物品的协同过滤（ItemCF）3. 相似度计算方法 二、相似度计算方法1. 欧氏距离2. 皮尔逊相关系数3. 杰卡德相似系数4. 余弦相似度 三、推荐模块案例1.基于文章的协同过滤推荐功能2.基于用户的协同过滤推荐功能 前言     在信息过载的时代，推荐系统成为连接用户与内容的桥梁。本文聚焦于
阅读更多...
嵌入式QT开发：构建高效智能的嵌入式系统

嵌入式QT开发：构建高效智能的嵌入式系统

摘要： 本文深入探讨了嵌入式 QT 相关的各个方面。从 QT 框架的基础架构和核心概念出发，详细阐述了其在嵌入式环境中的优势与特点。文中分析了嵌入式 QT 的开发环境搭建过程，包括交叉编译工具链的配置等关键步骤。进一步探讨了嵌入式 QT 的界面设计与开发，涵盖了从基本控件的使用到复杂界面布局的构建。同时也深入研究了信号与槽机制在嵌入式系统中的应用，以及嵌入式 QT 与硬件设备的交互，包括输入输出设
阅读更多...
OpenHarmony鸿蒙开发（ Beta5.0）无感配网详解

OpenHarmony鸿蒙开发（ Beta5.0）无感配网详解

1、简介 无感配网是指在设备联网过程中无需输入热点相关账号信息，即可快速实现设备配网，是一种兼顾高效性、可靠性和安全性的配网方式。 2、配网原理 2.1 通信原理 手机和智能设备之间的信息传递，利用特有的NAN协议实现。利用手机和智能设备之间的WiFi 感知订阅、发布能力，实现了数字管家应用和设备之间的发现。在完成设备间的认证和响应后，即可发送相关配网数据。同时还支持与常规Sof
阅读更多...
活用c4d官方开发文档查询代码

活用c4d官方开发文档查询代码

当你问AI助手比如豆包，如何用python禁止掉xpresso标签时候，它会提示到 这时候要用到两个东西。https://developers.maxon.net/论坛搜索和开发文档 比如这里我就在官方找到正确的id描述 然后我就把参数标签换过来
阅读更多...
C#实战|大乐透选号器[6]：实现实时显示已选择的红蓝球数量

C#实战|大乐透选号器[6]：实现实时显示已选择的红蓝球数量

哈喽，你好啊，我是雷工。 关于大乐透选号器在前面已经记录了5篇笔记，这是第6篇； 接下来实现实时显示当前选中红球数量，蓝球数量； 以下为练习笔记。 01 效果演示 当选择和取消选择红球或蓝球时，在对应的位置显示实时已选择的红球、蓝球的数量； 02 标签名称 分别设置Label标签名称为：lblRedCount、lblBlueCount
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2