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

相关文章

vue使用docxtemplater导出word

《vue使用docxtemplater导出word》docxtemplater是一种邮件合并工具,以编程方式使用并处理条件、循环,并且可以扩展以插入任何内容,下面我们来看看如何使用docxtempl... 目录docxtemplatervue使用docxtemplater导出word安装常用语法 封装导出方

Linux换行符的使用方法详解

《Linux换行符的使用方法详解》本文介绍了Linux中常用的换行符LF及其在文件中的表示,展示了如何使用sed命令替换换行符,并列举了与换行符处理相关的Linux命令,通过代码讲解的非常详细,需要的... 目录简介检测文件中的换行符使用 cat -A 查看换行符使用 od -c 检查字符换行符格式转换将

Java编译生成多个.class文件的原理和作用

《Java编译生成多个.class文件的原理和作用》作为一名经验丰富的开发者,在Java项目中执行编译后,可能会发现一个.java源文件有时会产生多个.class文件,从技术实现层面详细剖析这一现象... 目录一、内部类机制与.class文件生成成员内部类(常规内部类)局部内部类(方法内部类)匿名内部类二、

使用Jackson进行JSON生成与解析的新手指南

《使用Jackson进行JSON生成与解析的新手指南》这篇文章主要为大家详细介绍了如何使用Jackson进行JSON生成与解析处理,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下... 目录1. 核心依赖2. 基础用法2.1 对象转 jsON(序列化)2.2 JSON 转对象(反序列化)3.

使用Python实现快速搭建本地HTTP服务器

《使用Python实现快速搭建本地HTTP服务器》:本文主要介绍如何使用Python快速搭建本地HTTP服务器,轻松实现一键HTTP文件共享,同时结合二维码技术,让访问更简单,感兴趣的小伙伴可以了... 目录1. 概述2. 快速搭建 HTTP 文件共享服务2.1 核心思路2.2 代码实现2.3 代码解读3.

Elasticsearch 在 Java 中的使用教程

《Elasticsearch在Java中的使用教程》Elasticsearch是一个分布式搜索和分析引擎,基于ApacheLucene构建,能够实现实时数据的存储、搜索、和分析,它广泛应用于全文... 目录1. Elasticsearch 简介2. 环境准备2.1 安装 Elasticsearch2.2 J

使用C#代码在PDF文档中添加、删除和替换图片

《使用C#代码在PDF文档中添加、删除和替换图片》在当今数字化文档处理场景中,动态操作PDF文档中的图像已成为企业级应用开发的核心需求之一,本文将介绍如何在.NET平台使用C#代码在PDF文档中添加、... 目录引言用C#添加图片到PDF文档用C#删除PDF文档中的图片用C#替换PDF文档中的图片引言在当

Java中List的contains()方法的使用小结

《Java中List的contains()方法的使用小结》List的contains()方法用于检查列表中是否包含指定的元素,借助equals()方法进行判断,下面就来介绍Java中List的c... 目录详细展开1. 方法签名2. 工作原理3. 使用示例4. 注意事项总结结论:List 的 contain

C#使用SQLite进行大数据量高效处理的代码示例

《C#使用SQLite进行大数据量高效处理的代码示例》在软件开发中,高效处理大数据量是一个常见且具有挑战性的任务,SQLite因其零配置、嵌入式、跨平台的特性,成为许多开发者的首选数据库,本文将深入探... 目录前言准备工作数据实体核心技术批量插入:从乌龟到猎豹的蜕变分页查询:加载百万数据异步处理:拒绝界面

Android中Dialog的使用详解

《Android中Dialog的使用详解》Dialog(对话框)是Android中常用的UI组件,用于临时显示重要信息或获取用户输入,本文给大家介绍Android中Dialog的使用,感兴趣的朋友一起... 目录android中Dialog的使用详解1. 基本Dialog类型1.1 AlertDialog(