OpenHarmony NDK工具（上）

最新推荐文章于 2024-09-04 16:02:07 发布
最新推荐文章于 2024-09-04 16:02:07 发布
阅读量4.6k 收藏 38
点赞数 12
文章标签： harmonyos 华为
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/weixin_58069108/article/details/129507082
版权

在OpenHarmony应用开发中选择Native C ++开发方式需要使用OpenHarmony NDK工具，或者想移植一个C/C ++的三方库到OpenHarmony中也可以使用NDK。NDK使用到的编译工具是cmake，也就是CMakeLists.txt那一套。Native C ++应用开发方式可以做直接编译三方库的so库再利用NAPI框架实现能力的调用（只需要在三方库原生的CMakeLists.txt中修改小部分的内容就可以实现）。

目录

一、OpenHarmony NDK

  • NDK (原生开发套件) 是一套工具，使开发者能够在 OpenHarmony hap应用中使用 C/C++ 代码。
  • NDK提供了一系列的工具可以帮助开发者快速的开发C/C++的动态库、静态库和可执行文件。
  • OpenHarmony 应用开发的Native C++开发方式就要依赖NDK。NDK被包含在OpenHarmony SDK中。可以在DevEco Studio使用 NDK 将 C/C ++ 代码编译到so库中，然后使用 DevEco Studio 的构建插件hvigor-ohos-plugin将so库打包到 Hap 中。ArkTS代码随后可以通过NAPI框架调用SO库中的函数。
    9f9c443fd275d73a5cc875bfb9e433f.jpgimage.png

二、获取NDK的方式

2.1 从每日构建中获取

  • 每日构建地址： http://ci.openharmony.cn/dailys/dailybuilds

  • 组件形态选择ohos-sdk,版本选择最新版本的sdk一般是没有问题的（但是笔者之前遇到下载的ndk中的clang工具找不到libatomic.so无法工作的情况的情况）
    eeec91bc355a36fb308d55a4c7c7613.jpg

  • 下载解压后可以得到如下文件，根据linux或者windows端解压不同文件得到sdk
    b7a65dd5442f79cc917e7bf792a8543.jpg

2.2 编译源码得到SDK中的NDK

安装依赖
./build/build_scripts/env_setup.sh

执行完上述命令后记得执行source ~/.bashrc或者重启终端
source ~/.bashrc

安装编译SDK需要的依赖包（编译镜像的时候是不依赖这些包的）
sudo apt-get install libxcursor-dev libxrandr-dev libxinerama-dev

./build.sh --product-name ohos-sdk --ccache --build-target ohos_ndk

写文章提的issue https://gitee.com/openharmony/build/issues/I6H8IO?from=project-issue

  • 在对应的目录底下找到编译成功的NDK，相关路径out/sdk/packages/ohos-sdk/linux/native,根据linux或者windows端解压不同文件得到sdk

image.png

二、NDK目录

native
   ├── NOTICE.txt                                        声明文件
   ├── build
   │     └── cmake
   │           ├── ohos.toolchain.cmake             ---->编译的工具链
   │           └── sdk_native_platforms.cmake       ---->编译的工具链（在DevEco Studio中编译打包so要用到）                 
   ├── build-tools                                  ---->cmake编译工具所在目录（NDK提供的编译工具）
   ├── llvm                                         ---->编译器所在目录（NDK提供的编译工具）
   ├── sysroot                                      ---->编译器的 sysroot 目录，存放 SDK 内部的已经包含的库和对应的头文件
   ├── ndk_system_capability.json                   ---->NDK自带so库能力描述文件
   ├── nativeapi_syscap_config.json                 ---->调用NDK自带so库能力相关头文件
   ├── docs                                         ---->调用NDK自带so库能力相关文档
   └── oh-uni-package.json                          ---->SDK 信息描述
  • llvm中bin目录下的编译器有
FileCheck    clang-format      ld64.lld        lldb-vscode      llvm-cxxfilt     llvm-objdump   llvm-strip       yaml2obj
clang        clang-tidy        lld             llvm-addr2line   llvm-dis         llvm-profdata  llvm-symbolizer
clang++      clangd            lld-link        llvm-ar          llvm-lib         llvm-ranlib    not
clang-12     count             lldb            llvm-as          llvm-link        llvm-readelf   sancov
clang-check  dsymutil          lldb-argdumper  llvm-cfi-verify  llvm-modextract  llvm-readobj   sanstats
clang-cl     git-clang-format  lldb-mi         llvm-config      llvm-nm          llvm-size      scan-build
clang-cpp    ld.lld            lldb-server     llvm-cov         llvm-objcopy     llvm-strings   scan-view

三、linux下使用NDK编译库文件和可执行文件

3.1 使用NDK编译一个简单demo

  • 在这里使用这个OpenHarmony仓库的这个demo https://gitee.com/openharmony/third_party_musl/tree/master/ndk-test/ndk-test/src/shared-library 这个demo编译前的目录结构
shared-library            
├── CMakeLists.txt      外部CMakeLists.txt    
├── include             头文件目录
│   └── shared
│       └── Hello.h      
└── src                 源文件目录
    ├── CMakeLists.txt  内部CMakeLists.txt  
    ├── Hello.cpp
    └── main.cpp
  • 外部CMakeLists.txt
#cmake的版本
CMAKE_MINIMUM_REQUIRED(VERSION 3.16)
#工程名称
PROJECT(HELLO_LIBRARY)
#添加一个子目录并构建该子目录
ADD_SUBDIRECTORY(src)

cmake的内置命令是不区分大小写的,因此add_subdirectory与ADD_SUBDIRECTORY作用一致。但是cmake的所有变量都是区分大小写的

  • 内部CMakeLists.txt
#设置可执行文件输出路径
SET(EXECUTABLE_OUTPUT_PATH ${PROJECT_BINARY_DIR}/output)
# 设置so库文件输出路径
SET(LIBRARY_OUTPUT_PATH ${PROJECT_BINARY_DIR}/output)

############################################################
# Create a library
############################################################

#SHARED表示生成的是动态库，动态库的名字是hello_shared_library。生成动态库的源文件是Hello.cpp
ADD_LIBRARY(hello_shared_library SHARED 
	Hello.cpp
	)
#为生成的动态库添加一个别名，后续hello::library可使用来替代hello_shared_library
ADD_LIBRARY(hello::library ALIAS hello_shared_library)

#为指定目标hello_shared_library添加头文件搜索路径（这个指定目标决不能是alias target，也就是指定的别名hello::library）
TARGET_INCLUDE_DIRECTORIES(hello_shared_library
	PUBLIC 
	${PROJECT_SOURCE_DIR}/include
	)

############################################################
# Create an executable
############################################################

# 使用指定的源文件main.cpp创建出一个可执行文件hello_shared_binary 
ADD_EXECUTABLE(hello_shared_binary
	main.cpp
	)

#TARGET_LINK_LIBRARIES指令的作用为将目标文件与库文件进行链接
#将可执行文件hello_shared_binary与库文件hello::library进行链接
TARGET_LINK_LIBRARIES( hello_shared_binary
	PRIVATE 
	hello::library
	)

3.2 进行cmake编译

3.2.1 NDK自带的cmake编译工具添加到环境变量

1、第一种方法：

#将其临时加入环境变量中（适用于临时想用用NDK）
export PATH=$PATH:/ohos-sdk/linux/native/build-tools/cmake/bin（你自己解压的NDK目录）

2、第二种方法：

#将其永远加入环境变量中
#打开.bashrc文件
vim ~/.bashrc
#在文件最后添加cmake路径，该路径是自己的放置文件的路径，之后保存退出
export PATH=/ohos-sdk/linux/native/build-tools/cmake/bin:$PATH
#在命令行执行source ~/.bashrc使环境变量生效
source ~/.bashrc

3、查看环境变量添加是否成功

 cmake -version

image.png
可知cmake的版本是3.16.5 ，所以编写CMakeLists.txt可参考的链接为 https://cmake.org/cmake/help/v3.16/guide/tutorial/

3.2.2 安装make

  • 如果没有安装make会出现以下报错，则执行sudo apt-get install make。（如果已经安装make,请忽略）
    image.png

3.2.3 cmake的几个参数

1、OHOS_STL参数,其类型可以是c++_shared和c++_static，默认是c++_shared
image.png

2、OHOS_ARCH参数（设置应用程序二进制接口ABI）,其类型是armeabi-v7a、x86_64 ，默认值是arm64-v8a。每一种ABI定义了相应的二进制文件。

  • armeabi-v7a （选择这个是编译32位的二进制文件）
  • arm64-v8a （选择这个是编译64位的二进制文件）
  • x86_64 （现在不使用，OpenHarmony现在在适配x86的芯片）

3、OHOS_PLATFORM参数，其类型为OHOS(只能选择OHOS平台)

4、 CMAKE_TOOLCHAIN_FILE参数指向的是工具链文件所在的位置，就是ohos.toolchain.cmake的路径（对于编译不同平台二进制文件是很重要的）。

  • build目录中的工具链文件ohos.toolchain.cmake，cmake编译时需要读取该文件中的默认值，比如编译器的选择、编译平台，例如ohos.toolchain.cmake文件中，
# Common default settings
39:if(NOT DEFINED OHOS_PLATFORM_LEVEL)
   set(OHOS_PLATFORM_LEVEL 1)
   endif()
43:if(NOT DEFINED OHOS_TOOLCHAIN)
   set(OHOS_TOOLCHAIN clang)
   endif()
47:if(NOT DEFINED OHOS_STL)
   set(OHOS_STL c++_shared)
   endif()
51:if(NOT DEFINED OHOS_PIE)
   set(OHOS_PIE TRUE)
   endif()
55:if(NOT DEFINED OHOS_ARM_NEON)
   set(OHOS_ARM_NEON thumb)
   endif()
60:if(NOT DEFINED OHOS_ARCH)
   set(OHOS_ARCH arm64-v8a)
   endif()
  • 在编译时需要指出该文件的所在路径，以便于cmake在编译时定位到该文件。在编译的时候需要为cmake指定参数来控制编译目标的属性。

3.2.4 使用CMake进行构建，并传递工具链文件及cmake参数

# dmeo目录下创建build目录，用来放置cmake构建时产生的中间文件。
mkdir build && cd build

# 传递OHOS_STL（可选，默认就是c++_shared）、OHOS_ARCH、OHOS_PLATFORM、工具链文件
# CMAKE_TOOLCHAIN_FILE是ohos.toolchain.cmake具体放置的路径
# 这一步会检查CMakeLists.txt是否有语法错误 
# 不要忘记在ohos.toolchain.cmake路径后面加上 ..
cmake -D OHOS_STL=c++_shared -D OHOS_ARCH=armeabi-v7a -D OHOS_PLATFORM=OHOS -D CMAKE_TOOLCHAIN_FILE=/xxx/build/cmake/ohos.toolchain.cmake ..

cmake --build .

1、执行如下过程如下：
image.png

2、可以注意到执行cmake --build .时会有warning： -Wunused-command-line-argument,
通过在内部的CMakeLists.txt中添加如下语句消除warning。

set(CMAKE_CXX_FLAGS "-Wno-unused-command-line-argument")

image.png

  • 注意：.c文件时是使用CMAKE_C_FLAGS，.cpp文件时是使用CMAKE_CXX_FLAGS

3、编译结果如下：
生成可执行文件和动态库
image.png

4、要编译静态库及其可执行文件，内部的CMakeLists.txt中添加如下语句

############################################################
# Create a library
############################################################

#Generate the static library from the library sources
ADD_LIBRARY(hello_static_library STATIC 
	Hello.cpp
	)

TARGET_INCLUDE_DIRECTORIES(hello_static_library
	PUBLIC 
	${PROJECT_SOURCE_DIR}/include
	)

############################################################
# Create an executable
############################################################

# Add an executable with the above sources
ADD_EXECUTABLE(hello_static_binary 
	main.cpp
	)

# link the new hello_library target with the hello_binary target
TARGET_LINK_LIBRARIES( hello_static_binary
	PRIVATE 
	hello_static_library
	)

编译结果如下,生成静态库及其可执行文件
image.png

5、编译64位的库文件和可执行文件，OHOS_ARCH参数选择arm64-v8a或者编译时不传递该参数。

3.4.5 使用CMake进行构建，选择ninja生成器并生成编译流程图

1、执行cmake -G查看linux环境下的生成器，ndk中自带的生成器是Ninja。

image.png

2、使用CMake进行构建时添加上-G “Ninja”

image.png

第一步：mkdir build && cd build

第二步：cmake -G "Ninja" -D OHOS_STL=c++_shared -D OHOS_ARCH=armeabi-v7a -D OHOS_PLATFORM=OHOS -D CMAKE_TOOLCHAIN_FILE=/xxx/build/cmake/ohos.toolchain.cmake ..

第三步：cmake --build .或者ninja -f build.ninja

执行完第二步后，build目录下会生成build.ninja，有了build.ninja可以使用ninja生成程序的编译流程图。

3、使用ninja工具生成库文件和可执行文件的编译流程图。

# 将libhello_shared_library.so动态库的编译流程转为dot
ninja -t graph libhello_shared_library.so > xxx.dot

# 将dot格式转化为png格式的流程图
dot -T png xxx.dot -o libhello_shared_library.so.png
# 将dot格式转化为svg格式的流程图
dot -T svg xxx.dot -o libhello_shared_library.so.svg

xxx.png
如果生成图片格式太小的话，可以生成svg格式到浏览器打开,这一点很重要，请参考该 issue

3.4.6 使用NDK中的cmake-gui进行图形化操作编译

1、native/build-tools/cmake/bin目录有cmake-gui，可以用它图形化传入编译参数进行编译。
image.png

2、首先点击Where is source code行的Browser Source，加载工程所在目录。
再点击Where to build the binarys行的Browser Source,加载点击“Where is source code”行的Browser Source，加载源码所在目录。
点击“Where to build the binarys行的Browser Source,加载工程所在目录下的build目录（没有就创建一个）。

3、点击Add Entry传入cmake 参数。勾选把旁边的Grouped选项。
9825d68023da3b2f4c3881c0b19a4e4.jpg

4、点击Configure选择Current Generator生成器为Unix Makefiles。

5、最后打开Where to build the binarys加载构建目录终端，执行make -j 8命令

make -j n含义是 让make最多允许n个编译命令同时执行，这样可以更有效的利用CPU资源。假设系统cpu是12核，在不影响其他工作的情况下，我们可以make -j 12将cpu资源充分利用起来，一般来说，最大并行任务数为cpu_num * 2。

image.png

写文章提的issue https://gitee.com/openharmony/third_party_musl/issues/I6JRBU?from=project-issue

离北况归
关注
openHarmony 利用c++程序在dayu210开发板上实现拉取RTSP视频流并且在屏幕上显示，如何实现？
**My Coding Family**
10-27 615
这个流程不一定需要使用DevStudio，可以通过常规的CMake + 交叉编译工具链进行开发。使用FFmpeg或GStreamer处理RTSP流。使用交叉编译工具链生成ARM可执行文件。通过SSH或SCP将编译好的程序推送到开发板并运行。这样你可以实现一个C++程序，在Dayu210的OpenHarmony上拉取并显示RTSP视频流。如果你需要更详细的代码或遇到具体问题，可以随时继续讨论。希望如上措施及解决方案能够帮到有需要的你。
HarmonyOS编译开源native库（OpenSSL实例）
金戈鐡馬
12-11 2795
近期项目要开始做鸿蒙版本，有一部分依赖native的代码也需要迁移，某个native模块依赖openssl，需要在鸿蒙下重新编译openssl才行。一开始找了很多相关文档都没有得到方法，无奈只能自己凭经验慢慢试，最后还是成功了。
ndk-build编译工具
11-21
ndk-build Native方法编译工具
android -- NDK 编译环境搭建
最新发布
2401_86372693的博客
09-04 1501
注意：如果你的应用程序是可调试的（即，如果你的清单文件中设置了android:debuggable的属性是”true”）。$NDK是之前配置的ndk的环境变量，这两个根据你具体的安装目录进行配置，其他的不用变，Arguments这串参数实际是给bash.exe命令行程序传参数，进入要编译的程序目录，然后运行ndk-build编译程序。配置保存完成，如果你配置的编译器在其它编译器下边，记得一定要点Up按钮，把它排到第一位，否则C代码的编译晚于Java代码的编译，会造成你的C代码要编译两次才能看到最新的修改。
鸿蒙next开发-OpenHarmony的NDK开发
2301_76813281的博客
01-19 1835
Native API在SDK包的位置为$(SDK_ROOT)/native目录，主要有以下几个部分组成目录功能说明build应用中编译动态库的toolchain cmake脚本；这个目录下ohos.toolchain.cmake文件定义了给OHOS交叉编译选项放置编译构建的工具，如cmakedocsNative API接口参考文档，通过doxgen从头文件中提取出来llvm支持OHOS ABI的llvm交叉编译器sysroot放置编译链接的依赖文件目录，包含头文件，动态库等。
eclipse开发android-ndk环境所需工具包及安装配置方法
hxl5955的博客
06-17 2290
一、准备工具包 到网盘下载android相关工具包； 地址：https://pan.baidu.com/s/1kUSRu31 二、安装 1、安装eclipse、adt、sdk; 解压adt-bundle-windows-x86_64-20140702.zip里面含eclispse、adt、sdk; 2、安装ndk 双击运行android-ndk-r10d-window
鸿蒙HarmonyOS应用开发之NDK开发导读
1
03-27 1733
build目录：放置预定义的toolchain脚本文件ohos.toolchain.cmakeCMake编译时需要读取该文件中的默认值，比如编译器架构、C++库链接方式等，因此在编译时会通过CMAKE_TOOLCHAIN_FILE指出该文件的路径，便于CMake在编译时定位到该文件。build-tools文件夹：放置NDK提供的编译工具# 键入下一行命令查看CMake的版本# 结果llvm文件夹：放置NDK提供的编译器。
OpenHarmony应用开发引入开源C/C++库---之Har包里的NDK
maniuT的博客
04-10 1166
创建一个工程工程里加模块选择 staticlibrary，就是静态库打开 native 的开关就是支持 nativec++，也就支持 ndk在主工程里导入 library 工程修改代码导出控件，方法// library 工程里修改 ------------------------------------------......})// library 工程里修改 ------------------------------------------// 主项目里导入。
openharmony 上 ndk编译
06-16
2. **配置环境变量**: 安装完NDK后，需要将其路径添加到系统环境变量中，这样命令行可以识别NDK工具链。在终端中执行适当的`export`命令，例如在Linux或MacOS中： ``` export PATH=$PATH:/path/to/your/ndk/...
OpenHarmony 实战开发——串口服务访问
m0_70748458的博客
04-27 1396
本文档是在eTS项目hap包中实现串口访问的使用说明，通过JS接口开放给上层应用使用。如果你觉得这篇内容对你还蛮有帮助，我想邀请你帮我三个小忙：关注小编，同时可以期待后续文章ing🚀，不定期分享原创知识。
OpenHarmony源码解析之编译构建
m0_70748458的博客
04-26 1632
OpenHarmony是由开放原子开源基金会（OpenAtom Foundation）孵化及运营的开源项目，目标是面向全场景、全连接、全智能时代、基于开源的方式，搭建一个智能终端设备操作系统的框架和平台，促进万物互联产业的繁荣发展。最近在学习OpenHarmony源代码，个人认为学习有三个阶段，分别是看、实操、写（归纳总结），本着追求学习的终极目标，因此有了这篇文章
OpenHarmony系统应用开发流程(编译full sdk并替换)
龚礼鹏的博客
07-22 516
public-SDK是提供给应用开发的工具包，跟随DevEco Studio下载，不包含系统应用所需要的高权限APIfull-SDK是提供给OEM厂商开发应用的工具包，不能随DevEco Studio下载，包含了系统应用所需要的高权限API三方开发者通过DevEco Studio自动下载的API8版本SDK均为public版本。public-SDK不支持开发者使用所有的系统API。
安卓开发工具包NDK下载
cnfly8
01-03 848
该NDK是一个工具集，可让您使用本机代码语言，如C和C + +实现您的应用程序的一部分。对于某些类型的应用程序，这可能是有益的，因此您可以重复使用这些语言编写的现有代码库，但大多数应用程序并不需要在Android NDK 。 在下载NDK ，你应该明白， NDK将不利于大多数应用程序。作为开发人员，你需要针对其缺点平衡它的好处。值得注意的是，在使用Android原生代码一般不会导
安卓NDK——原生开发工具包
旧日灯塔
05-09 1660
NDK （Native Development Kit ） 概述 NDK是一个集成了Android交叉编译环境的工具集，并提供了一套比较方便的Makefile，可以帮助开发者快速开发C或者C++的动态库，并自动的将so和java程序打包成apk，在Android上运行。 原生开发工具包 (NDK) 是一套工具，允许您为 Android 使用 C 和 C++ 代码，并提供众多平台库，您可用...
OpenHarmony实战开发-使用命令行CMake构建NDK工程
m0_70749039的博客
05-20 769
接下来介绍如何把已有的CMake工程切换到OpenHarmony工具链中，从而使用命令行CMake构建该工程。
Android：NDK编译
肖云鹤的博客
03-27 1717
使用NDK可以编译出静态(.a)、动态(.so)链接库和可执行文件 比在工程环境里写mk或者bp要方便很多 一段时间不用NDK编译容易忘记怎么使用，所以用一个小的"Hello NDK"示例记录NDK编译的基本过程
【OpenHarmony-NDK技术】简单将cJson移植到OpenHarmony中，并在c层修改参数值再返回json
sinat_35845281的博客
04-21 1161
简单的将cJson 移植到 OpenHarmony 中实现js的json在c层进行修改并返回。
Android NDK 编译工具ndk-build的使用
Brainbg的博客
06-22 1455
Android NDK 编译工具ndk-build的使用1.创建native相关方法1.1 native相关方法去掉报红2.创建c/c++文件2.1 生成头文件2.2 添加 c/c++文件3.添加mk文件3.1 添加 `Android.mk`文件(必加)3.2 添加 `Application.mk`文件（可选）4.编译so库文件4.用Gradle链接c++项目6.加载so库、运行app7.下载地址...
android ndk编译
Moe_Cirno的博客
01-19 450
Android提供了NDK工具，用来编译native代码（c/c++），该工具配置好了相关的交叉编译环境和工具链，只需要你简单地编写几个.mk文件即可将你的c/c++代码编译为Android的java工程/Android手机可以识别、加载和运行的库或者应用程序。 默认情况下，使用NDK编译c/c++代码，需要将该代码放置到任一个Android应用工程的jni目录下，然后编写相应的Android.
评论 1
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值