OpenHarmony NAPI 使用Cmake 编译C++ .so 并ets调用

2024-05-14 06:28

本文主要是介绍OpenHarmony NAPI 使用Cmake 编译C++ .so 并ets调用,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

一、前言

         这两年多随着国产化兴起,国内越来越多的项目都要求支持国产化系统,并且随着OpenHarmony 开源,更多的人都想分一杯羹。因此,我们公司也要求,所有产品的都需要支持开源鸿蒙OpenHarmony。 对于我们这边的设备,很多代码都是需要保密,在Android 中都是通过jni 方法将不能公开的代码编译成.so 文件提供给客户调用。同理,在OpenHarmony 也是一样,将代码封装成 .so 通过 napi 提供给客户调用,于是有下面文章。

二、基本概念

2.1 关于napi 

NAPI (Native API) 组件是一套对外接口基于Node.js N-API规范开发的原生模块扩展开发框架,也就是源于Node JS,为了实现 javascript 脚本与 C++ 库之间的相互调用。可以在 Node js 官网查看到关于 napi 更多资料。

2.2 在 OpenHarmony 中napi

无论是在OpenHarmony 还是 HarmonyOS 中,目前官方主要是提倡,应用层使用基于 javascript (Ark TS)语言开发应用。当有些特殊场景(访问操作系统底层api),或则高效、高性能的算法执行等,需要使用 c/c++ 有更高执行效率。因此,在Js 与 c/c++ 之间需要互相调用,进行交互传递数据,它们之间需要一个桥梁来实现两种语言代码之间的相互调用,这个桥梁就是 NAPI。

OpenHarmony 提供了 NAPI 框架用于实现 JS 和 C/C++ 互相调用的能力。

在DevEco Studio 默认支持创建 NAPI 工程,支持原生应用访问.

三、创建一个 NAPI 工程生成 xxx.so

3.1 打开DevEco Studio, 创建一个 native 工程

3.2 napi 工程目录

3.2.1 创建工程之后,编译整个工程,默认会有一个cpp 文件,并且生成一个默认 libentry.so 文件,文件在build -> intermediates->cmake->default->obj->arm-v8a->libentry.so

在cpp 目录中,CMakeLists.txt 保存生成 so 规则,修改 Cmake 规则,可以生成自定义.so库。

其中,types 包含NAPI 接口文件定义,

  • index.d.ts:对 napi 接口的 ts 提供的方法声明。
  • package.json:打包的配置文件
  • xxx.cpp 就是c++ 实现源码

CMakeLists.txt 文件还会在 build-profile.json5 里做配置。

在 oh-package.json5 文件中,配置xxx.so 与接口 .index.d.ts 配对的。

{"name": "libcomm_napi.so","types": "./index.d.ts","version": "","description": "Please describe the basic information."
}

设置 libentry.so 库和 index.d.ts 相关联,便于在其他 TS 文件中引入 libentry.so 时调用库中的相关方法,可以跳转到 .ts 接口的声明。

3.3 关于 CMakeLists.txt 

使用CMakeLists.txt 时,注意不能使用以下代码

#目标机使用的操作系统名称,支持Linux,QNX,WindowsCE,Android
#set(CMAKE_SYSTEM_NAME Linux)

指定cmake 的目标平台,虽然 openharmony 底层是 linux , 这样子使用在DevEco Studio编译 .so 时,会报错。

要想在 xxx.cpp 文件中,打印 hilog 日志,则需要在 CMakeLists.txt 编译选择中,输出的 xxx.so 需要增加链接选项,如:

#增加链接选项
target_link_libraries(comm_napi PUBLICdllibace_napi.z.solibhilog_ndk.z.so
)

3.4 关于 napi 变量类型,可以参考node.js 官方的文档。

3.5 应用开发的 NAPI 库会随着应用工程一起编译打包到 hap 文件中,最终部署到 /data 目录每个应用自己的文件夹下。

参考文章:

[经验分享] NAPI入门

OpenHarmony 之 NAPI 框架介绍 - 知乎 (zhihu.com)

/**
 *         ┏┓   ┏┓+ +
 *        ┏┛┻━━━┛┻┓ + +
 *        ┃       ┃
 *        ┃   ━   ┃ ++ + + +
 *        ████━████ ┃+
 *        ┃       ┃ +
 *        ┃   ┻   ┃
 *        ┃       ┃ + +
 *        ┗━┓   ┏━┛
 *          ┃   ┃
 *          ┃   ┃ + + + +
 *          ┃   ┃    Code is far away from bug with the animal protecting
 *          ┃   ┃ +     神兽保佑,代码无bug
 *          ┃   ┃
 *          ┃   ┃  +
 *          ┃    ┗━━━┓ + +
 *          ┃        ┣┓
 *          ┃        ┏┛
 *          ┗┓┓┏━┳┓┏┛ + + + +
 *           ┃┫┫ ┃┫┫
 *           ┗┻┛ ┗┻┛+ + + +
 *
 * @author chenxi
 * @date 2024年5月8日21:16:27
 */

这篇关于OpenHarmony NAPI 使用Cmake 编译C++ .so 并ets调用的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/987995

相关文章

如何使用 Python 读取 Excel 数据

《如何使用Python读取Excel数据》:本文主要介绍使用Python读取Excel数据的详细教程,通过pandas和openpyxl,你可以轻松读取Excel文件,并进行各种数据处理操... 目录使用 python 读取 Excel 数据的详细教程1. 安装必要的依赖2. 读取 Excel 文件3. 读

解决Maven项目idea找不到本地仓库jar包问题以及使用mvn install:install-file

《解决Maven项目idea找不到本地仓库jar包问题以及使用mvninstall:install-file》:本文主要介绍解决Maven项目idea找不到本地仓库jar包问题以及使用mvnin... 目录Maven项目idea找不到本地仓库jar包以及使用mvn install:install-file基

Python使用getopt处理命令行参数示例解析(最佳实践)

《Python使用getopt处理命令行参数示例解析(最佳实践)》getopt模块是Python标准库中一个简单但强大的命令行参数处理工具,它特别适合那些需要快速实现基本命令行参数解析的场景,或者需要... 目录为什么需要处理命令行参数?getopt模块基础实际应用示例与其他参数处理方式的比较常见问http

C 语言中enum枚举的定义和使用小结

《C语言中enum枚举的定义和使用小结》在C语言里,enum(枚举)是一种用户自定义的数据类型,它能够让你创建一组具名的整数常量,下面我会从定义、使用、特性等方面详细介绍enum,感兴趣的朋友一起看... 目录1、引言2、基本定义3、定义枚举变量4、自定义枚举常量的值5、枚举与switch语句结合使用6、枚

使用Python从PPT文档中提取图片和图片信息(如坐标、宽度和高度等)

《使用Python从PPT文档中提取图片和图片信息(如坐标、宽度和高度等)》PPT是一种高效的信息展示工具,广泛应用于教育、商务和设计等多个领域,PPT文档中常常包含丰富的图片内容,这些图片不仅提升了... 目录一、引言二、环境与工具三、python 提取PPT背景图片3.1 提取幻灯片背景图片3.2 提取

C++如何通过Qt反射机制实现数据类序列化

《C++如何通过Qt反射机制实现数据类序列化》在C++工程中经常需要使用数据类,并对数据类进行存储、打印、调试等操作,所以本文就来聊聊C++如何通过Qt反射机制实现数据类序列化吧... 目录设计预期设计思路代码实现使用方法在 C++ 工程中经常需要使用数据类,并对数据类进行存储、打印、调试等操作。由于数据类

使用Python实现图像LBP特征提取的操作方法

《使用Python实现图像LBP特征提取的操作方法》LBP特征叫做局部二值模式,常用于纹理特征提取,并在纹理分类中具有较强的区分能力,本文给大家介绍了如何使用Python实现图像LBP特征提取的操作方... 目录一、LBP特征介绍二、LBP特征描述三、一些改进版本的LBP1.圆形LBP算子2.旋转不变的LB

Maven的使用和配置国内源的保姆级教程

《Maven的使用和配置国内源的保姆级教程》Maven是⼀个项目管理工具,基于POM(ProjectObjectModel,项目对象模型)的概念,Maven可以通过一小段描述信息来管理项目的构建,报告... 目录1. 什么是Maven?2.创建⼀个Maven项目3.Maven 核心功能4.使用Maven H

Python中__init__方法使用的深度解析

《Python中__init__方法使用的深度解析》在Python的面向对象编程(OOP)体系中,__init__方法如同建造房屋时的奠基仪式——它定义了对象诞生时的初始状态,下面我们就来深入了解下_... 目录一、__init__的基因图谱二、初始化过程的魔法时刻继承链中的初始化顺序self参数的奥秘默认

SpringBoot使用GZIP压缩反回数据问题

《SpringBoot使用GZIP压缩反回数据问题》:本文主要介绍SpringBoot使用GZIP压缩反回数据问题,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录SpringBoot使用GZIP压缩反回数据1、初识gzip2、gzip是什么,可以干什么?3、Spr