当前位置：GHOST系统之家>系统教程 > 跟着小白一起学鸿蒙--写个NAPI子系统（七）

跟着小白一起学鸿蒙--写个NAPI子系统（七）

来源：Ghost系统之家浏览：时间：2023-04-13 16:52:14

跟着小白一起学鸿蒙--写个NAPI子系统（七）

作者：王石 2022-10-09 15:05:50系统 OpenHarmony 此篇文章，我们主要是熟悉下NAPI框架，并一起写一个支持NAPI的子系统，这样以后当我们想在hap应用里加自己功能的时候就可以方便的添加。

想了解更多关于开源的内容，请访问：

51CTO开源基础软件社区

https://ost.51cto.com

在《#跟着小白一起学鸿蒙#[六]第一个hap应用》我们熟悉了如何在开源鸿蒙开发hap应用，后期的文章我们会写在hap应用里调用系统库甚至是动态库。此篇文章，我们主要是熟悉下NAPI框架，并一起写一个支持NAPI的子系统，这样以后当我们想在hap应用里加自己功能的时候就可以方便的添加。

NAPI框架简介

NAPI（Native API）组件是一套对外接口基于Node.js N-API规范开发的原生模块扩展开发框架。类似于Android的JNI，NAPI框架实现了应用层ts/ets/js语言编写的代码和开源鸿蒙的native代码（c/c++）交互的能力。此框架由Node.js N-API框架扩展而来。

注意：开源鸿蒙的标准系统是采用NAPI框架的，轻量系统则是采用jerryscript框架。

#冲刺创作新星# #跟着小白一起学鸿蒙# [七] 写个NAPI子系统-开源基础软件社区

详细的内容介绍在一下链接内可以看到官方的说明：

参考链接：https://gitee.com/openharmony/arkui_napi。

NAPI的使用

graph LR创建d.ts --> 执行napi_generator --> 建立子系统 --> 引入子系统 -->编译生成

创建d.ts: @ohos.napitest.d.ts, basic.d.ts。

@ohos.napitest.d.ts是NAPI的声明文件，在DevEco Studio开发的时候会用到d.ts来检查语法和提供代码帮助。

import {AsyncCallback} from './basic';/** * Provides interfaces to napitest. * * @since 7 */declare namespace napitest {/** * Shuts down the system. * *

This method requires the ohos.permission.SHUTDOWN permission. * * @param reason Indicates the shutdown reason. * @systemapi * @since 7 */function shutdownDevice(reason: string): void;/** * Restarts the system. * *

This method requires the ohos.permission.REBOOT permission. * * @param reason Indicates the restart reason. For example, "updater" indicates entering the updater mode * after the restart. If the parameter is not specified, the system enters the normal mode after the restart. * @since 7 */function rebootDevice(reason: string): void;/** * Checks whether the screen of a device is on or off. * * @return Returns true if the screen is on; returns false otherwise. * @since 7 */function isScreenOn(callback: AsyncCallback): void;function isScreenOn(): Promise;}export default napitest;

basic.d.ts：一些基础方法的声明。

export interface Callback {(data: T): void;}export interface ErrorCallback {(err: T): void;}export interface AsyncCallback {(err: BusinessError, data: T): void;}export interface BusinessError extends Error {code: number;}

执行napi_generator建立个文件夹，将上面建立的两个d.ts和napi_generator放在一起。

//准备环境mkdir napitestcd napitestvim @ohos.napitest.d.tsvim basic.d.ts//拷贝napi_generatorcp [路径]/napi_generator-linux .chmod +x napi_generator-linux//生成napitest代码./napi_generator-linux -f @ohos.napitest.d.ts -o out//当看到success则说明烧录成功//检视out目录├── binding.gyp //工具中间文件├── BUILD.gn//之后需要用到的gn文件├── napi_gen.log//工具log├── napitest.cpp//自动生成的接口调用的实际代码├── napitest.h//自动生成的接口调用的实际代码├── napitest_middle.cpp //自动生成的napi适配代码├── test.sh //生成js代码的脚本，官方没给说明，试了下不可用├── tool_utility.cpp//自动生成的napi适配代码└── tool_utility.h//自动生成的napi适配代码

建立子系统。

在鸿蒙源码目录下建立foundation/napitest，将之前生成的文件拷贝到文件夹内。

foundation├── ability├── ai├── arkui├── barrierfree├── bundlemanager├── communication├── deviceprofile├── distributeddatamgr├── distributedhardware├── filemanagement├── graphic├── multimedia├── multimodalinput├── napitest│ ├── binding.gyp│ ├── BUILD.gn│ ├── bundle.json│ ├── napi_gen.log│ ├── napitest.cpp│ ├── napitest.h│ ├── napitest_middle.cpp│ ├── test.sh│ ├── tool_utility.cpp│ └── tool_utility.h├── resourceschedule

在目录里创建bundle.json，使用一下内容。

{"name": "@ohos/napitest","description": "napitest provides atomic capabilities","version": "3.1","license": "Apache License 2.0","publishAs": "code-segment","segment": {"destPath": "foundation/napitest"},"dirs": {},"scripts": {},"component": {//部件名称"name": "napitest_interface",//子系统名称"subsystem": "napitest","features": [],"adapted_system_type": ["standard"],"rom": "10000KB","ram": "10000KB","deps": {"components": ["ace_napi","ipc_core","libhilog"],"third_party": ["node"]},"build": {"sub_component": ["//foundation/napitest:napitest"],"inner_kits": [{"header": {"header_base": "//foundation/napitest","header_files": ["tool_utility.h","napitest.h"]},"name": "//foundation/napitest:napitest"}]}}}

为了和bundle.json对应，将BUILD.gn改成如下：

import("//build/ohos.gni")ohos_shared_library("napitest"){sources = ["napitest_middle.cpp","napitest.cpp","tool_utility.cpp",]include_dirs = [".","//third_party/node/src","//base/hiviewdfx/hilog/interfaces/native/innerkits/include",]deps=["//foundation/arkui/napi:ace_napi","//base/hiviewdfx/hilog/interfaces/native/innerkits:libhilog",]remove_configs = [ "//build/config/compiler:no_rtti" ]cflags=[]cflags_cc=["-frtti",]ldflags = []relative_install_dir = "module"//部件名称part_name = "napitest_interface"//子系统名称subsystem_name = "napitest"}

引入子系统。

增加子系统，修改build/subsystem_config.json。

//在文件后增加{//前面省略的内容...//新增内容"napitest": {"path": "foundation/napitest","name": "napitest"}}

增加编译入口（已目前的master版本为基础，3.2后改过编译路径）。

//修改 vendor/hihope/[PRODUCT_NAME]/config.json 文件增加如下行{"subsystem": "napitest","components": [{"component": "napitest_interface","features": []}]},

编译生成。

./build.sh --product-name PRODUCT_NAME//看到success则为编译成功，可以通过find out/[PRODUCT_NAME] -name *napitest.z.so查看生成文件,比如我的文件路径如下：./out/rk3568/lib.unstripped/napitest/napitest_interface/libnapitest.z.so./out/rk3568/napitest/napitest_interface/libnapitest.z.so./out/rk3568/innerkits/ohos-arm/napitest_interface/napitest/libnapitest.z.so./out/rk3568/packages/phone/system/lib/module/libnapitest.z.so//最后一个路径就是系统镜像的路径，所以两种办法//1,直接copy到板子的/system/lib路径；参考《#跟着小白一起学鸿蒙# [二]第一个OpenHarmony程序》//2,烧录镜像；参考《#跟着小白一起学鸿蒙# [一]运行OpenHarmony》