OpenHarmony开发——CMake方式组织编译的库移植

最新推荐文章于 2024-05-20 17:37:36 发布
最新推荐文章于 2024-05-20 17:37:36 发布
阅读量601 收藏 9
点赞数 3
分类专栏： 移动开发 鸿蒙 Harmony OS 文章标签： 数据挖掘 Openharmony 移动开发 harmonyos 鸿蒙开发
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/weixin_61845324/article/details/137683795
版权
移动开发 同时被 3 个专栏收录
432 篇文章 12 订阅
订阅专栏
Harmony OS
314 篇文章 8 订阅
订阅专栏
鸿蒙
249 篇文章 7 订阅
订阅专栏

概述

本文为OpenHarmony开发者提供一些组织编译形式比较常见（CMakeLists、Makefile）的三方库的移植指南，该指南当前仅适用于Hi3516DV300和Hi3518EV300两个平台，文中着重介绍各编译组织方式下工具链的设置方法以及如何将该库的编译添加到OpenHarmony整个工程的构建中。

CMake方式组织编译的库移植

以double-conversion库为例，其移植过程如下文所示。

源码获取

从仓库获取double-conversion源码，其目录结构如下表：

表1 源码目录结构

名称描述
double-conversion/cmake/CMake组织编译使用到的模板
double-conversion/double-conversion/源文件目录
double-conversion/msvc/-
double-conversion/test/测试用例源文件
double-conversion/.gitignore-
double-conversion/AUTHORS-
double-conversion/BUILD-
double-conversion/CMakeLists.txtCMake方式顶层编译组织文件
double-conversion/COPYING-
double-conversion/Changelog-
double-conversion/LICENSE-
double-conversion/Makefile-
double-conversion/README.md-
double-conversion/SConstruct-
double-conversion/WORKSPACE-

移植思路

移植思路：通过修改工具链，交叉编译该三方库，生成OpenHarmony平台的可执行文件，最后再通过GN调用CMake的方式添加到OpenHarmony工程中。

交叉编译

编译参考

代码仓库的README.md中详细介绍了使用CMake编译double-conversion库的步骤，以及测试方法。本文参考该指导设置该库的编译配置，并完成测试。若开发人员在移植过程中对该库的编译选项配置有疑惑的地方，可参考该指导。对于其他使用CMake可独立编译的三方库，在移植时可以参考其自带的编译指导。

设置执行交叉编译

CMake方式可通过指定工具链进行交叉编译，修改并编译该库，生成OpenHarmony平台的可执行文件，步骤如下：

  1. 设置工具链
    将下列clang工具链配置添加到该工程的顶层CMakeLists.txt（即表1中的该文件）中即可。
   set(CMAKE_CROSSCOMPILING TRUE)
   set(CMAKE_SYSTEM_NAME Generic)
   set(CMAKE_CXX_COMPILER_ID Clang)
   set(CMAKE_TOOLCHAIN_PREFIX llvm-)
   #指定c编译工具（确保工具链所在路径已经添加到了PATH环境变量中）和编译标志，使用clang编译时标志中必须指定--target，否则无法交叉编译。
   set(CMAKE_C_COMPILER clang)
   set(CMAKE_C_FLAGS "--target=arm-liteos -D__clang__ -march=armv7-a -w -mfloat-abi=softfp -mcpu=cortex-a7 -mfpu=neon-vfpv4")
   #指定c++编译工具（确保工具链所在路径已经添加到了PATH环境变量中）和编译标志，必须指定--target，否则无法交叉编译。
   set(CMAKE_CXX_COMPILER clang++) 
   set(CMAKE_CXX_FLAGS "--target=arm-liteos -D__clang__ -march=armv7-a -w -mfloat-abi=softfp -mcpu=cortex-a7 -mfpu=neon-vfpv4")
   #指定链接工具和链接标志，必须指定--target和--sysroot，其中OHOS_ROOT_PATH可通过cmake命令后缀参数来指定。
   set(MY_LINK_FLAGS "--target=arm-liteos --sysroot=${OHOS_SYSROOT_PATH}")
   set(CMAKE_LINKER clang)
   set(CMAKE_CXX_LINKER clang++)
   set(CMAKE_C_LINKER clang)
   set(CMAKE_C_LINK_EXECUTABLE
       "${CMAKE_C_LINKER} ${MY_LINK_FLAGS} <FLAGS> <LINK_FLAGS> <OBJECTS> -o <TARGET> <LINK_LIBRARIES>")
   set(CMAKE_CXX_LINK_EXECUTABLE
       "${CMAKE_CXX_LINKER} ${MY_LINK_FLAGS} <FLAGS> <LINK_FLAGS> <OBJECTS> -o <TARGET> <LINK_LIBRARIES>")
   #指定链接库的查找路径。
   set(CMAKE_SYSROOT ${OHOS_SYSROOT_PATH})
  1. 执行编译
    linux命令行中进入double-conversion的源文件目录（即标1所示目录），执行下列命令：
   mkdir build && cd build
   cmake .. -DBUILD_TESTING=ON -DOHOS_SYSROOT_PATH="..."
   make -j

其中OHOS_SYSROOT_PATH需用绝对路径指定出sysroot目录的位置，以OpenHarmony为例即目录out/hispark_xxx/ipcamera_hispark_xxx/sysroot的绝对路径。上述目录会在全量编译后生成，因此移植前先完成一次全量编译。

  1. 查看结果
    步骤2操作完成后，build目录下会生成静态库文件和测试用例：

    表2 编译生成文件目录结构

    名称描述
    double-conversion/build/libdouble-conversion.a生成的静态库文件
    double-conversion/build/test/目录下存放生成的测试用例和相关CMake缓存文件
    double-conversion/build/CMakeCache.txtCMake构建过程中的缓存文件
    double-conversion/build/CMakeFiles/-
    double-conversion/build/cmake_install.cmake-
    double-conversion/build/CTestTestfile.cmake-
    double-conversion/build/DartConfiguration.tcl-
    double-conversion/build/generated/-
    double-conversion/build/Makefile-
    double-conversion/build/Testing/-

测试

  1. 搭建OpenHarmony环境
    以Hi3516DV300为例，编译出OpenHarmony镜像，烧写到开发板，相关操作可参考快速入门小型系统部分。

    进入系统如下所示：

图1 OpenHarmony启动成功界面

  1. 挂载nfs目录，将表2中test目录下cctest可执行文件放入nfs目录

  2. 执行用例
    该库采用非交叉编译时用例是通过make test执行，CMake会有相关的执行结果统计；交叉编译时无法使用该方法，因此可直接执行生成的测试文件完成测试。

  • 挂载成功后执行下列命令可列出用例所有条目：
     cd nfs
     ./cctest --list

 上述命令执行结果部分展示：

     test-bignum/Assign<
     test-bignum/ShiftLeft<
     test-bignum/AddUInt64<
     test-bignum/AddBignum<
     test-bignum/SubtractBignum<
     test-bignum/MultiplyUInt32<
     test-bignum/MultiplyUInt64<
     test-bignum/MultiplyPowerOfTen<
     test-bignum/DivideModuloIntBignum<
     test-bignum/Compare<
     test-bignum/PlusCompare<
     test-bignum/Square<
     test-bignum/AssignPowerUInt16<
     test-bignum-dtoa/BignumDtoaVariousDoubles<
     test-bignum-dtoa/BignumDtoaShortestVariousFloats<
     test-bignum-dtoa/BignumDtoaGayShortest<
     test-bignum-dtoa/BignumDtoaGayShortestSingle<
     test-bignum-dtoa/BignumDtoaGayFixed<
     test-bignum-dtoa/BignumDtoaGayPrecision<
     test-conversions/DoubleToShortest<
     test-conversions/DoubleToShortestSingle<
     ...
  • 以test-bignum条目为例，执行下列命令开始测试：
     ./cctest test-bignum

 测试结果如下则表示通过：

     Ran 13 tests.

将该库编译添加到OpenHarmony工程中

  1. 复制库到OpenHarmony工程中
    拷贝已经能够成功交叉编译的库到OpenHarmony的third_party目录，为了不修改要移植的三方库目录下的BUILD.gn文件，再添加一层目录放置新增的gn转CMake编译适配文件，新增的文件有BUILD.gn、build_thirdparty.py、 config.gni，新增后的目录结构如下所示。

表3 添加到工程后的目录结构

名称描述
OpenHarmony/third_party/double-conversion/BUILD.gn将三方库加入工程的gn适配文件
OpenHarmony/third_party/double-conversion/build_thirdparty.pyGN调用shell命令脚本文件，由上面GN文件将相关命令传入，实现GN转CMake
OpenHarmony/third_party/double-conversion/config.gni三方库编译配置文件，可修改该文件来配置用例是否参与构建等
OpenHarmony/third_party/double-conversion/double-conversion/要移植的三方库目录
  1. 添加gn到CMake适配文件
    • 新增的BUILD.gn文件实现如下，其他采用CMake方式可独立编译的三方库移植到OpenHarmony平台时只需修改路径即可。
     import("config.gni")
     group("double-conversion") {
         if (ohos_build_thirdparty_migrated_from_fuchisa == true) {
             deps = [":make"]
         }
     }
     if (ohos_build_thirdparty_migrated_from_fuchisa == true) {
         action("make") {
             script = "//third_party/double-conversion/build_thirdparty.py"
             outputs = ["$root_out_dir/log_dc.txt"]
             exec_path = rebase_path(rebase_path("./build", ohos_third_party_dir))
             command = "rm * .* -rf && $CMAKE_TOOLS_PATH/cmake .. $CMAKE_FLAG $CMAKE_TOOLCHAIN_FLAG && make -j"
             args = [
                 "--path=$exec_path",
                 "--command=${command}"
             ]
         }
     }
  • 新增的config.gni用于配置该库，实现如下，其他采用CMake方式可独立编译的三方库移植到OpenHarmony时只需修改CMAKE_FLAG的配置即可。
     #CMAKE_FLAG: config compile feature
     CMAKE_FLAG = "-DBUILD_TESTING=ON -DCMAKE_CXX_STANDARD=11"
   
     #toolchain：follow up-layer，depend on $ohos_build_compiler
     if (ohos_build_compiler == "clang") {
         CMAKE_TOOLCHAIN_FLAG = "-DOHOS_SYSROOT_PATH=${root_out_dir}sysroot"
     } else {
         CMAKE_TOOLCHAIN_FLAG = ""
     }
   
     #CMake tools path,no need setting if this path already joined to $PATH.
     CMAKE_TOOLS_PATH = "setting CMake tools path..."
  • 新增的build_thirdparty.py实现如下，其他采用CMake方式可独立编译的三方库移植到OpenHarmony时无需修改即可使用。
     import os
     import sys
     from subprocess import Popen
     import argparse
     import shlex
   
     def cmd_exec(command):
         cmd = shlex.split(command)
         proc = Popen(cmd)
         proc.wait()
         ret_code = proc.returncode
         if ret_code != 0:
             raise Exception("{} failed, return code is {}".format(cmd, ret_code))
   
     def main():
         parser = argparse.ArgumentParser()
         parser.add_argument('--path', help='Build path.')
         parser.add_argument('--command', help='Build command.')
         parser.add_argument('--enable', help='enable python.', nargs='*')
         args = parser.parse_args()
   
         if args.enable:
             if args.enable[0] == 'false':
               return
   
         if args.path:
             curr_dir = os.getcwd()
             os.chdir(args.path)
             if args.command:
                 if '&&' in args.command:
                     command = args.command.split('&&')
                     for data in command:
                       cmd_exec(data)
               else:
                   cmd_exec(args.command)
           os.chdir(curr_dir)
   
      if __name__ == '__main__':
         sys.exit(main())
  • 在配置文件中添加开关控制该库编译，默认设为关闭

在//build/lite/ohos_var.gni文件中添加下列配置：

     declare_args() {
         ohos_build_thirdparty_migrated_from_fuchisa = true
      }

  1. 编译构建
    手动单独构建：

    执行下列命令

   hb build -T //third_party/double-conversion:double-conversion

编译成功则build目录下会生成静态库文件和测试用例

为了能让大家更好的学习鸿蒙（HarmonyOS NEXT）开发技术，这边特意整理了《鸿蒙开发学习手册》（共计890页），希望对大家有所帮助：https://qr21.cn/FV7h05

《鸿蒙开发学习手册》：

如何快速入门：https://qr21.cn/FV7h05

  1. 基本概念
  2. 构建第一个ArkTS应用
  3. ……

开发基础知识：https://qr21.cn/FV7h05

  1. 应用基础知识
  2. 配置文件
  3. 应用数据管理
  4. 应用安全管理
  5. 应用隐私保护
  6. 三方应用调用管控机制
  7. 资源分类与访问
  8. 学习ArkTS语言
  9. ……

基于ArkTS 开发：https://qr21.cn/FV7h05

  1. Ability开发
  2. UI开发
  3. 公共事件与通知
  4. 窗口管理
  5. 媒体
  6. 安全
  7. 网络与链接
  8. 电话服务
  9. 数据管理
  10. 后台任务(Background Task)管理
  11. 设备管理
  12. 设备使用信息统计
  13. DFX
  14. 国际化开发
  15. 折叠屏系列
  16. ……

鸿蒙开发面试真题（含参考答案）：https://qr18.cn/F781PH

鸿蒙开发面试大盘集篇（共计319页）：https://qr18.cn/F781PH

1.项目开发必备面试题
2.性能优化方向
3.架构方向
4.鸿蒙开发系统底层方向
5.鸿蒙音视频开发方向
6.鸿蒙车载开发方向
7.鸿蒙南向开发方向

码中之牛
关注
  • 3
    点赞
  • 踩
  • 9
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
openharmony使用cmake交叉demo
08-04
第一步解压：tar -zxvf cross_build_demo2.tar.gz 第二步切换到cross_build_demo目录：修改toolchain_install.cmake中的路径 第三步创建build：mkdir build 第四步在buid目录下运行cmake:cmake -DCMAKE_TOOLCHAIN_FILE=../toolchain_install.cmake .. 第五步运行make:make VERBOSE=1 第六步将编译好的amazon_hello2放入开发板中去运行。
OpenHarmony C/C++三方库移植适配
1
04-14 1752
众所周知，C/C++三方库相对与JS/ETS的三方组件来说，其运行效率高。那如何将一个C/C++三方库移植到OH系统上呢？本文将介绍如何快速高效的移植一个C/C++三方库到OpenHarmony上。
OpenHarmony NAPI 使用Cmake 编译C++ .so 并ets调用
gd6321374的专栏
05-13 986
因此，我们公司也要求，所有产品的都需要支持开源鸿蒙OpenHarmony。3.2.1 创建工程之后，编译整个工程，默认会有一个cpp 文件，并且生成一个默认 libentry.so 文件，文件在build -> intermediates->cmake->default->obj->arm-v8a->libentry.so。设置 libentry.so 库和 index.d.ts 相关联，便于在其他 TS 文件中引入 libentry.so 时调用库中的相关方法，可以跳转到 .ts 接口的声明。
OpenHarmony实战开发-使用命令行CMake构建NDK工程
最新发布
m0_70749039的博客
05-20 699
接下来介绍如何把已有的CMake工程切换到OpenHarmony工具链中，从而使用命令行CMake构建该工程。
Cmake编译OsgEarth3.5的库
04-24
**CMake 编译 OSGEarth 3.5 库详解** 在 IT 领域，CMake 是一个跨平台的构建系统，用于管理软件构建过程。它通过生成特定平台的构建工具（如 Makefile 或 Visual Studio 工程）来简化多平台开发。本篇文章将详细...
cmake交叉编译
01-12
CMake是一个跨平台的安装（编译）工具，可以用简单的语句来描述所有平台的安装(编译过程)。他能够输出各种各样的makefile或者project文件，能测试编译器所支持的C++特性,类似UNIX下的automake。
ios平台使用cmake交叉编译的工具链
03-07
在iOS开发中，有时我们需要为不同的架构或平台创建软件库，比如静态库(.a)和动态库(.dylib)。为了实现这一目标，开发者经常利用交叉编译技术，这是一种可以在一个系统上构建针对另一个系统（在这种情况下是iOS）的...
CMake交叉编译配置
11-05
这一步骤非常重要，因为它改变了 CMake 寻找库文件和编译工具的方式。 **步骤1:** 在 `CMakeLists.txt` 文件的开头设置目标平台名称。 ```cmake SET(CMAKE_SYSTEM_NAME Linux) ``` 这里的 `Linux` 表示目标平台。...
使用OpenHarmonyNDK移植三方库Speexdsp
weixin_58069108的博客
07-21 838
大家好，我是一名即将本科毕业的OpenHarmony开发者，去年暑假利用了两个月时间移植了一个语音处理的三方库Speexdsp到OpenHarmony标准系统。主要为其编写了build.gn使其加入了OpenHarmony编译体系（基于ninja和gn）,Speexdsp在linux下是使用构建工具configure、makefile构建的。移植的难点并不在于.c和.h以及cflags、idflags的分析，而在于重新熟悉一套编译构建体系，而且当时可参考的资料并不太多。
4步成功将三方库——speexdsp移植到OpenHarmony
OpenHarmony_dev的博客
09-27 1280
/build.sh --product-name rk3568 --ccache --build-target=移植的三方库名称 --target-cpu arm64（ohos更新到3.2版本后，支持64位系统的编译，默认情况下编译的都是32位系统，在编译命令中添加--target-cpu arm64即可构建64位系统）③定义目标并加入组件：在编写gn文的时候，我们定义的动态库以及测试可执行程序都是我们的目标模块，在每个目标模块中添加对应的组件名后即将我们的目标模块加入该组件中。
OpenHarmony实战：CMake方式组织编译的库移植
m0_64420071的博客
04-03 1572
以double-conversion库为例，其移植过程如下文所示。
OpenHarmony开源三方库的cmake在IDE上直接引用的问题
m0_70748458的博客
05-16 941
一、部分开源三方库的脚本可以在DevEco Studio上直接使用这部分开源三方库没有其他库的依赖，可以直接使用add_subdirectory引用二、有依赖的三方库的脚本不能在DevEco Studio上直接使用需要配置搜索路径和提前将依赖的库都构建并安装完毕或者在顶层CMakeLists.txt中使用execute_process来调用shell命令，先把依赖库编译并安装完成。
【C++三方库移植】移植BehaviorTree.CPP到OpenHarmony标准系统①
weixin_58069108的博客
07-21 299
笔者最近将BehaviorTree.CPP移植到OpenHarmony标准系统上，并且将移植成果开源。相关成果已经合并至 OpenHarmony-SIG仓库tpc_c_cplusplus：https://gitee.com/openharmony-sig/tpc_c_cplusplus/pulls/313
OpenHarmony/HarmonyOS三方库使用指导
热门推荐
坚果的博客
05-12 1万+
【代码】OpenHarmony/HarmonyOS三方库使用指导。
OpenHarmony的C/C++三方库的适配
maniuT的博客
04-12 594
本仓库主要用于存放已经适配OpenHarmony的C/C++三方库的适配脚本和OpenHarmony三方库适配指导文档、三方库适配相关的工具。
OpenHarmony实战：Makefile方式组织编译的库移植
m0_64420071的博客
04-03 968
以yxml库为例，其移植过程如下文所示。
cmake静态库编译到动态库中
09-13
你可以使用CMake将静态库编译为动态库，以下是一个简单的示例： 首先，在你的CMakeLists.txt文件中，将你的项目设置为生成共享库（动态库）： ``` cmake_minimum_required(VERSION 3.0) project(myproject) # ...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值