ArkTS使用Node-API进行扩展能力功能开发

介绍

扩展能力接口进一步扩展了Node-API的功能，提供了一些额外的接口，用于在Node-API模块中与ArkTS进行更灵活的交互和定制，这些接口可以用于创建自定义ArkTS对象等场景，本工程主要展示了使用Node-API对模块加载、ArkTS Object相关、运行指定abc文件、异步工作对象加入队列并指定优先级、给ArkTS对象绑定回调和回调所需的参数等场景，其中展示的代码详细描述可查如下链接。

• 使用Node-API进行扩展能力功能开发

效果预览

首页	执行结果图

使用说明

1. 运行Index主界面。
2. 页面呈现上述首页效果，分别点击ListItem组件可以执行对应文本内容的Node-API接口并将文本Result:改为执行成功结果，然后在控制台中打印出对应日志。
3. 运行测试用例NodeAPIExtendCapabilities.test.ets文件对页面代码进行测试可以全部通过。

工程目录

entry/src/
 ├── main
 │   ├── cpp
 │   │   ├── types
 │   │       ├── Index.d.ts
 │   │       ├── oh-package.json5
 │   │   ├── CMakeLists.txt
 │   │   ├── napi_init.cpp
 │   ├── ets
 │   │   ├── entryability
 │   │   ├── entrybackupability
 │   │   ├── pages
 │   │       ├── Index.ets               // 使用Node-API进行扩展能力功能开发示例代码
 │   ├── module.json5
 │   └── resources
 ├── ohosTest
 │   ├── ets
 │   │   └── test
 │   │       ├── Ability.test.ets
 │   │       ├── NodeAPIExtendCapabilities.test.ets  // 自动化测试代码
 │   │       └── List.test.ets

相关权限

不涉及。

依赖

不涉及。

约束与限制

1.本示例仅支持标准系统上运行, 支持设备：RK3568。

2.本示例为Stage模型，支持API22版本SDK，版本号：6.0.0.57，镜像版本号：OpenHarmony_6.0.0.57。

3.本示例需要使用DevEco Studio 6.0.0 Release (Build Version: 6.0.0.858, built on October 21, 2025)及以上版本才可编译运行。

下载

如需单独下载本工程，执行如下命令：

git init
git config core.sparsecheckout true
echo code/DocsSample/ArkTS/NodeAPI/NodeAPIUse/NodeAPIExtendCapabilities > .git/info/sparse-checkout
git remote add origin https://gitcode.com/openharmony/applications_app_samples.git
git pull origin master