HarmonyOS 实战开发 —— 基于napi_load_module_with_info实现的napi调用arkts的接口


📚往期笔录记录🔖:

🔖鸿蒙(HarmonyOS)北向开发知识点记录~
🔖鸿蒙(OpenHarmony)南向开发保姆级知识点汇总~
🔖鸿蒙应用开发与鸿蒙系统开发哪个更有前景?
🔖嵌入式开发适不适合做鸿蒙南向开发?看完这篇你就了解了~
🔖对于大前端开发来说,转鸿蒙开发究竟是福还是祸?
🔖鸿蒙岗位需求突增!移动端、PC端、IoT到底该怎么选?
🔖记录一场鸿蒙开发岗位面试经历~
🔖持续更新中……


功能描述

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

接口介绍

参数 说明
env 当前的虚拟机环境
path 加载的文件路径或者模块名
module_info bundleName/moduleName的路径拼接
result 加载的模块

相关功能接口:

  • napi_load_module_with_info 获取模块名
  • napi_get_named_property 获取模块中的函数
  • napi_call_function 调用函数

napi_load_module_with_info****的使用场景

加载本地工程的hap模块的文件路径和har模块名,加载远程包的har模块名和ohpm包名,加载API(@ohos或@system),加载Native库(.so文件)

场景一:加载同模块内自定义ArkTs文件导出内容的同步方法

arkts 侧代码:

//./src/main/ets/Test.ets
let value = 123;
function test() {
  console.log("Hello Harmony OS");
}
export {value, test};

build-profile.json5 配置:

{
  "buildOption" : {
  "arkOptions" : {
    "runtimeOnly" : {
      "sources": [
      "./src/main/ets/Test.ets"
      ]
    }
  }
}
}

native 侧代码:

static napi_value loadModule(napi_env env, napi_callback_info info) {
  napi_va
<think>我们已知用户的问题是关于napi_has_named_property函数的用法。根据引用中提供的信息,我们可以推断该函数用于检查一个对象是否具有指定名称的属性。由于引用中没有直接提到napi_has_named_property,但提到了类似的函数如napi_get_named_property(用于获取命名属性),我们可以类比其使用方式。 函数原型(根据Node.js N-API的常见形式)可能为: napi_status napi_has_named_property(napi_env env, napi_value object, const char* utf8name, bool* result); 参数说明: - env: 表示当前的napi环境。 - object: 要检查的JavaScript对象(napi_value类型)。 - utf8name: 属性名称(以UTF-8编码的字符串)。 - result: 指向布尔值的指针,用于存储检查结果(true表示存在,false表示不存在)。 使用步骤: 1. 准备一个napi_value对象(可以是任何JavaScript对象,例如模块导出对象)。 2. 指定要检查的属性名(字符串)。 3. 调用napi_has_named_property函数,传入环境、对象、属性名和一个布尔变量的地址。 4. 检查函数返回的状态(napi_status)以确保调用成功。 5. 根据布尔变量的值判断属性是否存在。 示例场景: 假设我们有一个ArkTS模块导出的对象,我们想检查该对象是否导出了某个特定的属性(例如,检查是否导出了名为"test"的函数)。 示例代码(基于引用[2]中的场景): 在引用[2]的示例中,我们加载了一个模块,并获取了模块导出的对象(result)。我们可以使用napi_has_named_property来检查该对象是否有某个属性。 注意:由于我们没有直接看到napi_has_named_property在引用中的示例,以下代码是根据N-API的常见用法编写的。 示例代码: ```c static napi_value checkProperty(napi_env env, napi_callback_info info) { napi_value result; // 假设我们已经通过napi_load_module加载了模块,并得到了模块导出对象result // ... 加载模块的代码(参考引用[2]) // 检查模块导出对象中是否有名为"test"的属性 bool hasTest = false; napi_status status = napi_has_named_property(env, result, "test", &hasTest); if (status != napi_ok) { // 错误处理 napi_throw_error(env, NULL, "Failed to check property"); return nullptr; } // 根据hasTest的值进行后续操作 // 例如,我们可以打印一条消息 napi_value returnValue; if (hasTest) { napi_create_string_utf8(env, "Property 'test' exists", NAPI_AUTO_LENGTH, &returnValue); } else { napi_create_string_utf8(env, "Property 'test' does not exist", NAPI_AUTO_LENGTH, &returnValue); } return returnValue; } ``` 注意事项: - 该函数是同步的。 - 属性名必须是UTF-8编码的字符串。 - 在调用该函数之前,确保传入的对象是一个有效的JavaScript对象(非null或undefined)。 如果用户需要更详细的官方文档,建议参考OpenHarmony的N-API文档或Node.js的N-API文档(因为两者在API设计上相似)。 相关问题: 1. napi_has_named_property和napi_has_property有什么区别? 2. 如何遍历一个对象的所有属性? 3. 除了napi_has_named_property,还有哪些常用的属性操作函数? </think>### napi_has_named_property 函数用法详解 `napi_has_named_property` 是 Node-API 中用于检查对象是否包含指定名称属性的函数,其核心作用是**同步验证某个 JavaScript 对象是否拥有特定名称的属性或方法**。以下是详细使用方法: #### 函数原型 ```c napi_status napi_has_named_property( napi_env env, // [in] N-API 环境句柄 napi_value object, // [in] 待检查的 JavaScript 对象 const char* utf8name, // [in] 属性名称(UTF-8 字符串) bool* result // [out] 检查结果(true/false) ); ``` #### 使用步骤 1. **准备参数**: - `env`:当前 N-API 环境句柄(通常从函数参数获取) - `object`:目标 JavaScript 对象(如模块导出对象) - `utf8name`:要检查的属性名称(如 `"test"`) - `result`:存储结果的布尔变量指针 2. **调用函数**: ```c bool has_property; napi_status status = napi_has_named_property( env, export_object, "targetProperty", &has_property ); ``` 3. **处理结果**: ```c if (status != napi_ok) { // 错误处理 } if (has_property) { // 属性存在时的操作 } else { // 属性不存在时的操作 } ``` #### 完整示例 ```c static napi_value CheckProperty(napi_env env, napi_callback_info info) { napi_value export_obj; // 加载模块(参考引用[2]) napi_load_module(env, "ets/Test", &export_obj); // 检查是否存在 "test" 方法 bool has_test; napi_status status = napi_has_named_property(env, export_obj, "test", &has_test); if (status != napi_ok) { napi_throw_error(env, NULL, "Property check failed"); return NULL; } // 返回检查结果 napi_value result; napi_get_boolean(env, has_test, &result); return result; } ``` #### 关键说明 1. **同步操作**:函数立即返回检查结果,无需异步处理 2. **命名属性检查**:仅验证直接属性(不包括原型链) 3. **错误处理**: - 返回 `napi_invalid_arg` 如果参数无效 - 返回 `napi_object_expected` 如果 `object` 不是 JS 对象 4. **典型应用场景**: - 验证模块导出接口完整性 - 条件性调用对象方法(避免未定义错误) - 动态检测运行时对象结构 > 注:该函数常与 `napi_get_named_property`(引用[1])配合使用,实现"检查→获取"的安全操作流[^1][^2]。 #### 注意事项 - 属性名需为 **UTF-8 编码**的 C 字符串 - 对函数/变量均适用(如检查导出函数 `"test"` 或变量 `"value"`) - 当对象为 `null` 或 `undefined` 时将返回错误 --- ###
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值