鸿蒙应用Native SDK C++ （JNI）开发实战 原创 精华
@toc
鸿蒙应用Native SDK C++ （JNI）开发实战
什么是鸿蒙Native SDK
- Native SDK是一套工具，使您能够在 HarmonyOS 应用中使用 C 和 C++ 代码，并提供众多平台库，Native SDK 可能不适合大多数编程初学者，这些初学者只需使用 Java /JS代码和框架 API 开发应用。然而，如果需要实现以下一个或多个目标，那么 Native SDK 就能派上用场：
- 可以进一步提升设备性能，以降低延迟或运行游戏、物理模拟等计算密集型应用。
- 重复使用您自己或其他开发者的 C 或 C++ 库。
HarmonyOS提供了一些图形图像、日志、媒体等相关的Native API
1 鸿蒙NDK开发环境准备
1.1 开发工具DevEco studio安装
- 确认安装好开发工具DevEco studio，版本需要支持Native SDK的
- 本文章的版本是 DevEco studio 2.2.0.200
- 工具到鸿蒙官网下载，如果已经没有2.2版本可以到hmxt.club下载
1.2 设置安装Native SDK（NDK）
- 第一次安装，正常默认安装了NDK，如需要修改版本，点击左下角Configure 进入设置
- 如果已经打开项目则选中DevEco studio的菜单File->Settings
2 第一个鸿蒙应用NDK示例
2.1 创建第一个HamonyOs Native C++项目
2.2 Native C++项目的文件分析
2.2.1 build.gradle 鸿蒙app项目配置
- 路径entry/build.gradle
- 配置编译的CPU对应的架构 arm64-v8a
- 配置C++项目编译用的cmake文件 src/main/cpp/CMakeLists.txt
- 配置C++ 编译参数-指定C++ 版本 -std=c++17
2.2.2 CMakeList.txt （C++项目文件）
-
路径 entry/src/main/cpp/CMakeList.txt
-
add_library(hello SHARED hello.cpp)
输出为动态库 指定c++源码文件 -
target_link_libraries(hello libhilog_ndk.z.so)
设定项目依赖的库
2.2.3 ndk c++源码(jni.h)
- 路径 entry/src/main/cpp/hello.cpp
- 通过函数名称对应java调用
- 引用jni.h与java交互
#include <jni.h>
#include <string>
#include <Hilog/log.h>
extern "C"
JNIEXPORT jstring JNICALL
Java_com_example_myapplication_slice_MainAbilitySlice_stringFromJNI(JNIEnv* env, jobject obj) {
std::string hello = "Hello from JNI C++ codes";
int len = hello.size();
jchar res[len];
for (int i = 0; i < len; i++) {
res[i] = (jchar)hello[i];
}
return env->NewString(res, len);
}
2.2.4 ndk java源码
-
文件名 MainAbilitySlice.java
-
System.loadLibrary(“hello”);
导入c++动态库 -
C++函数与java函数绑定
假定java函数名为 public native String stringFromJNI(); 那 java_命名空间_类名_函数 = C语言函数 ，所以c++函数名为
Java_com_example_myapplication_slice_MainAbilitySlice_stringFromJNI（JNIEnv* env, jobject obj），后面的参数对应java的线程环境和调用stringFromJNI函数的对象。
3 Native SDK （NDK）原生的C++接口分析
在上一章创建项目后，本章分析下c++能够调用哪些接口、c++程序的编译流程、库和编译工具所在路径。
3.1 官方Native API参考
官方直接提供了api的参考，目前鸿蒙自身的接口支持得还不多
3.2 Native API支持得标准库
3.3 分析鸿蒙native SDK 工具和库
-
在DevEco studio的菜单File->Project Structure进入可以看到，项目引用的ndk的路径，并且可以设置修改ndk的版本，本文选择了2.2.0.1版本的ndk。
-
进入ndk目录可以看到：
- 其中llvm目录下是编译工具链，包含编译工具和C/C++ 库，进入llvm/bin后可以看到编译的工具是clang 和clang++
- sysroot是系统库和头文件路径
通过头文件和库文件可以看到OpenGLES 三维渲染 OpenSLES 原始音频 也是支持的，原生音频opensles已测可以正常调用，OpenGLES 三维渲染没有调用测试，但是通过鸿蒙ndk工具已经成功编译开源的三维引擎。
NDK配置 cmake说明
JNI实现C++与java交互
4 JNI入门
4.1 什么是JNI
JNI 是指 Java 原生接口。它定义了Java编译的字节码与原生代码（使用 C/C++ 编写）互动的方式。JNI 不依赖于供应商，支持从动态共享库加载代码。
4.2 JNI开发原则
- 尽可能减少跨 JNI 层传递资源的次数
- 尽可能避免JAVA与C++异步通信
- 尽可能减少需要接触 JNI 或被 JNI 接触的线程数
- 将接口代码保存在少量易于识别的 C++ 和 Java 源位置，以便将来进行重构
4.3 JavaVM 和 JNIEnv
-
JavaVM
Java语言的执行环境是Java虚拟机(JVM)，每个JVM虚拟机都在本地环境中有一个JavaVM结构体，JavaVM是Java虚拟机在JNI层的代表，JNI全局仅仅有一个JavaVM结构中封装了一些函数指针（或叫函数表结构），JavaVM中封装的这些函数指针主要是对JVM操作接口。 -
JNIEnv
每个线程对应一个JNIEnv结构
JNIEnv 提供了大部分 JNI 函数。原生函数第一个参数都是JNIEnv
您无法在线程之间共享 JNIEnv
可以使用 AttachCurrentThread() 或 AttachCurrentThreadAsDaemon() 函数附加通过 pthread_create() 或 std::thread 启动的线程。
在附加之前，线程不包含任何 JNIEnv，也无法调用 JNI
JNI 附加的线程在退出之前必须调用 DetachCurrentThread()
4.4 jclass、jmethodID 和 jfieldID
- 分别对应java中的类、成员函数、和成员变量
- 传递给原生方法的每个参数，以及 JNI函数返回的几乎每个对象都属于“局部引用”。这意味着，局部引用在当前线程中的当前原生方法运行期间有效。在原生方法返回后，即使对象本身继续存在，该引用也无效。
- 获取非局部引用的唯一方法是通过 NewGlobalRef 和 NewWeakGlobalRef 函数。
JNI CMake ninja NDK c++ java的关系
结束
更多jni接口参数可以直接查看java的手册
更多内容可以观看51cto学堂上的课程《鸿蒙Native SDK JNI C++开发入门和实战-示例扩展支持lua脚本》，也可以关注我后发发的文章。
前来学习。