鸿蒙5.0开发进阶:配置构建-配置CPP

鸿蒙HarmonyOS应用开发之使用DevEco Studio模板构建NDK工程 NDK通过CMake和Ninja编译应用的C/C++代码,编译过程如下图所示。核心编译过程如下:根据CMake配置脚本以及build-profile.json5中配置的externalNativeOptions构建参数,与缓存中的配置比对后,生成CMake命令并执行CMake。执行Ninja,按照makefile执行编译和链接,将生成的.so以及运行时依赖的.so同步到输出目录,完成构建过程。 阅读详情

往期鸿蒙5.0全套实战文章必看:(文中附带全栈鸿蒙5.0学习资料)


配置CPP

Hvigor集成cmake,ninja为cpp代码的构建工具。在初始状态下,无需额外配置,您也可以添加以下自定义配置,定制cpp代码编译。

CPP配置包含externalNativeOptions和nativeLib,除特殊说明外,在工程级和模块级build-profile.json5文件中均支持配置,工程级配置会与模块级配置进行合并,模块级配置优先。

externalNativeOptions

externalNativeOptions是Native编译配置项。

表1 externalNativeOptions字段说明

字段名称

类型

是否必选

含义

path

字符串

可选

CMake构建脚本地址,即CMakeLists.txt文件地址。

abiFilters

字符串数组

可选

HarmonyOS当前支持的ABI编译环境,包括:

  • arm64-v8a
  • x86_64

如不配置该参数,编译时默认为arm64-v8a。

arguments

字符串/字符串数组

可选

CMake编译参数。

Hvigor将会把此处的自定义参数传递给cmake构建工具,您可通过cmake官方文档查找您所需的编译参数,同时它也将覆盖默认同名参数。

cppFlags

字符串

可选

C++编译器参数。

cFlags

字符串

可选

C编译参数。仅模块级build-profile.json5文件支持配置。

targets

字符串数组

可选

指定hvigor应构建的CMake项目中的库和可执行目标。仅模块级build-profile.json5文件支持配置。

nativeLib

nativeLib是Native库(.so)相关配置。

表2 nativeLib字段说明

字段名称

类型

是否必选

含义

filter

对象

可选

Native 库(.so)文件的筛选选项。配置后优先级高于napiLibFilterOption。

debugSymbol

对象

可选

移除.so文件中的符号表、调试信息。

headerPath

字符串/字符串数组

可选

指向包含要导出到此模块的依赖项的标头的目录的路径。

collectAllLibs

布尔值

可选

对libs目录收集打包时,是否收集所有后缀的文件。

  • true:不限制后缀,即收集所有文件(包括无后缀文件)。
  • false(缺省默认值):限制后缀为.so,即只收集后缀为.so的文件。

excludeFromHar

布尔值

可选

是否排除依赖HAR模块中的.so文件,排除时,依赖HAR模块的.so文件不会被打包到本模块产物中。

  • true(缺省默认值):排除。
  • false:不排除。

说明

仅针对HAR模块生效。

excludeSoFromInterfaceHar

布尔值

可选

编译HSP模块时,打包的HAR产物是否排除.so文件,减少.tgz包体积大小。

  • true:排除。HAR产物不包含.so文件,HSP产物包含.so文件。
  • false(缺省默认值):不排除。HAR产物和HSP产物都包含.so文件。

说明

  • 仅针对HSP模块生效。
  • 当HSP模块的工程级或模块级build-profile.json5文件中配置headerPath字段时,excludeSoFromInterfaceHar字段不生效。

librariesInfo

对象数组

可选

声明so的透传依赖信息。仅模块级build-profile.json5文件支持配置。

filter

filter是Native 库(.so)文件的筛选选项。配置后优先级高于napiLibFilterOption。

表3 filter字段说明

字段名称

类型

是否必选

含义

excludes

字符串数组

可选

根据正则表达式排除匹配到的.so文件,匹配到的so文件将不会被打包。

pickFirsts

字符串数组

可选

按照.so文件的优先级顺序,打包最高优先级的.so文件。

pickLasts

字符串数组

可选

按照.so文件的优先级顺序,打包最低优先级的.so文件。

enableOverride

布尔值

可选

是否允许当.so文件重名冲突时,使用高优先级的.so文件覆盖低优先级的.so文件:

  • true:允许。
  • false(缺省默认值):不允许。

select

对象数组

可选

select提供native产物的精准选择能力,根据包名、版本、产物名称等,选择打包或排除native产物到HAP/HSP/HAR产物。

select的优先级高于excludes、pickFirsts等配置项。

  • 库文件so的优先级

    库文件so的优先级选择,可以通过pickFirsts,pickLasts选项来选择,其中pickFirsts选择高优先级的库文件,pickLasts选择低优先级的库文件。

    这个优先级是由本模块所依赖模块或三方包的收集顺序决定的,本模块的依赖在oh-package.json5文件的dependencies配置中声明,收集顺序按照广度优先的遍历方式来收集依赖。

    如下图,优先级顺序为current > library0 > library1 > library5 > library2 > library3 > library4。

    图1

  • select
    表4 select字段说明

    字段名称

    类型

    是否必选

    含义

    package

    字符串

    可选

    包名。

    version

    字符串

    可选

    包版本。

    include

    字符串数组

    可选

    选择打包的native产物。

    exclude

    字符串数组

    可选

    排除的native产物。

    例如本模块依赖的libcurl.so所在的har包为@ohos/curl,并且存在多个版本的libcurl.so,需要打包1.3.5版本,那可以通过以下配置,精确打包这个so到产物中。

    {
      buildOption: {
        nativeLib: {
          filter: {
            select: [ // select的优先级高于excludes、pickFirsts等配置项
              {
                package: "@ohos/curl", // 包名
                version: "1.3.5", // 包版本
                include: ["libcurl.so"], // 选择打包的native产物
                exclude: ["libc++_shared.so"] // 排除的native产物
               }
            ]
          }
        }
      }
    }

debugSymbol

debugSymbol用于移除.so文件中的符号表、调试信息。

表5 debugSymbol字段说明

字段名称

类型

是否必选

含义

strip

布尔值

可选

是否移除.so文件中的符号表、调试信息。

  • true(缺省默认值):移除。
  • false:不移除。

说明

从DevEco Studio NEXT Developer Beta2(5.0.3.502)版本开始,缺省默认值由false改为true。

exclude

字符串数组

可选

需要排除的.so文件,支持正则表达式写法。

  • 如果strip配置为true,匹配的.so文件将不会执行strip。
  • 如果strip配置为false,只有匹配的.so文件会执行strip。

librariesInfo

librariesInfo用于声明so的透传依赖信息。仅模块级build-profile.json5文件支持配置。

表6

字段名称

类型

是否必选

含义

name

字符串

必选

本模块so库的名称。

linkLibraries

字符串数组

必选

so库的依赖信息,格式为"依赖包名::依赖so名称"。

如果需要声明库之间的依赖关系,例如entry依赖curl,可在模块内build-profile.json5中配置librariesInfo。

"buildOption": {
  "nativeLib": {
    "librariesInfo": [
      {
        "name": "libentry.so",
        "linkLibraries": ["curl::curl"]
      }
    ]
  }
}

当其他模块依赖声明了依赖透传的模块并使用libentry.so时,libentry.so会将依赖curl::curl添加到参数INTERFACE_LINK_LIBRARIES,开发者无需关注它的依赖。

add_library(library::library SHARED IMPORTED)
set_target_properties(library::library PROPERTIES
    IMPORTED_LOCATION "/path/to/file"
    INTERFACE_LINK_LIBRARIES "curl::curl")

配置字段示例

以模块级build-profile.json5为例:

{
  ...
  "buildOptionSet": [
    {
      "name": "release",
      "arkOptions": {
        "obfuscation": {
          "ruleOptions": {
            "enable": true,
            "files": [
              "./obfuscation-rules.txt"
            ]
          }
        }
      },
      "externalNativeOptions": {
        "path": "./src/main/cpp/CMakeLists.txt", // 自定义cmake配置脚本CMakeLists.txt的位置,它是以模块根目录为起始位置的相对路径
        "arguments": ["-DCMAKE_BUILD_TYPE=Debug"], // Hvigor将会把此处的自定义参数传递给cmake构建工具,您可通过cmake官方文档查找您所需的编译参数,同时它也将覆盖默认同名参数
        "cppFlags": "-g", // 自定义cpp flags参数
        "abiFilters": ["arm64-v8a"] // 自定义cpp编译架构,默认编译架构为arm64-v8a
      },
      "nativeLib": {
        "debugSymbol": { // 可通过此配置对cpp编译产物so执行strip,移除so中的调试信息与符号表等
          "strip": true, // 执行strip
          "exclude": [] //执行strip的过滤正则表达式规则
        },
        "filter": { // 可通过此选项自定义此cpp产物so是否打包到应用包中
          "excludes": [ // 根据正则表达式排除匹配到的.so文件,匹配到的so文件将不会被打包,可用于打包时缩小包体积
            "**/3.so", // 排除所有名称为“3”的so文件
            "**/x86_64/*.so" // 排除所有x86_64架构的so文件
          ], 
          "pickFirsts": ["**/1.so"], // 按照.so文件的优先级顺序,打包最高优先级的.so文件
          "pickLasts": ["**/2.so"], // 按照.so文件的优先级顺序,打包最低优先级的.so文件
          "enableOverride": true, // 当.so重名冲突时,使用高优先级的.so文件覆盖低优先级的.so文件
          "select": [ // select提供native产物的精准选择能力,根据包名、版本、产物名称等选择或排除,select的优先级高于excludes、pickFirsts等配置项
            {
              "package": "@ohos/curl", // 包名
              "version": "1.3.5", // 包版本
              "include": ["libcurl.so"], // 选择打包的native产物
              "exclude": ["libc++_shared.so"] // 排除的native产物
            }
          ],
        },
        "headerPath": "./src/main/cpp/include" // 声明模块打包共享的c/cpp接口
        "librariesInfo":[
          {
             "name": "libentry.so",
             "linkLibraries": ["curl::curl"]
          }
        ]
      },
    },
  ],
  ...
}

HarmonyOS开发:NDK工程构建规范 通过DevEco Studio提供的应用模板,可以快速生成CMake构建脚本模板,并在build-profile.json5中指定相关编译构建参数。 阅读详情

相关推荐

鸿蒙简介以及从零开始开发一个HarmonyOS应用

鸿蒙简介以及从零开始开发一个HarmonyOS应用 文章目录 一、鸿蒙系统介绍二、从零开始开发一个鸿蒙harmonyOS应用 1.环境搭建2.项目工程结构介绍 一、鸿蒙系统介绍 HarmonyOS是一款“面向未来”、面向全场景(移动办公、运动健康、社交通信、媒体娱乐等)的分布式操作系统。在传统的单设备系统能力的基础上,HarmonyOS提出了基于同一套系统能力、适配...

china_2014的博客 5308

HarmonyOS ArkUI容器类组件-格栅布局容器(GridContainer)

ArkUI开发框架提供了纵向排布栅格布局容器 `GridContainer` ,它仅在栅格布局场景中使用。

m0_71263309的博客 749

华为HarmonyOS鸿蒙应用开发初体验

HarmonyOS鸿蒙系统出来好几年了,开发鸿蒙应用和咱平时的前端开发到底有什么差别呢,下面就从一个前端开发的视角带领大家体验一下HarmonyOS开发。

weixin_48091641的博客 1162

HarmonyOS ArkTS与c++交互通信

通过缓存的env,callback对象,调用napi_call_function方法将数据传回给ts。NAPI中缓存回调接口的变量,便于后面回调给TS。

Ada的专栏 6051

鸿蒙HarmonyOS应用开发之NDK工程构建

ohos.toolchain.cmake是OpenHarmony NDK提供给CMake的toolchain脚本,里面预定义了编译OpenHarmony应用需要设置的编译参数,如交叉编译设备的目标、C++运行时库的链接方式等;这些参数在调用CMake命令时,可以从命令行传入,来改变默认编译链接行为。此文件中的常用参数见下表。参数类型说明OHOS_STLlibc++的链接方式。默认为c++_shared。c++_shared表示采用动态链接libc++_shared.so;

YHDMYBY的博客 1419

【鸿蒙 5.0 实战开发】HarmonyOS 音视频开发之音频采集实战

OHAudio分别介绍这两种语言的API。本文介绍了HarmonyOS 提供的两种音频采集方式:TS层的AudioCapture和C++层的OHAudio,并以OHAudio接口实现了实时音频采集功能。

xiaolizibie的博客 1215

鸿蒙5.0开发进阶:配置构建-构建HAR

构建模式:DevEco Studio默认提供debug和release两种构建模式,同时支持开发者自定义构建模式。

Androidbye的博客 1838

ArcGIS Pro2.5深度学习使用注意事项

ArcGIS Pro2.5深度学习使用中的注意事项1、ArcGIS Pro2.5深度学习使用中的注意事项1.1、Label深度学习样本工具参数介绍1.2、准备数据参数介绍1.3、训练模型介绍1.4、ArcGIS Pro2.5深度学习推理工具和模型对应关系介绍1.4.1、Classify Objects Using Deep Learning1.4.2、Classify Pixels Using D...

GIS哼哈哈的博客 7202

HarmonyOS APP 开发入门

本文讲解了入门基于HarmonyOS 的移动开发的一些基本知识和操作讲解

itcyy的博客 1万+

中兴U30air随身WiFi刷机全攻略:从ABD开启到系统调试(附工具包)

本文提供中兴U30air随身WiFi刷机全攻略,从ADB开启到系统调试的详细步骤,包括必备工具清单、ADB调试模式解锁、Bootloader解锁及自定义ROM刷入与调优。适合技术爱好者深度定制设备,提升网络性能和功能扩展。

weixin_29235923的博客 1992

ubuntu18.04安装xenomai3.1(百分百成功版)

ubuntu18.04安装xenomai3.1(百分百成功版),保姆级教学!!!

h542812556sdu的博客 2065

鸿蒙HarmonyOS开发环境安装与配置完全解析

华为鸿蒙系统是国内目前纯原生自产的热门移动应用开发系统,经过近几年的完善与优化,具有它特有的应用魅力与实用价值,诚邀国内外广大编程爱好者使用与推广。

sinat_30844883的博客 1万+

OpenCLI入门:让任何网站变成你的命令行工具(超详细版)

最有用的工具,往往是最简单的。 opencli就是这样。 它不会帮你写代码,不会帮你做决策,但它能把200+个平台装进你的命令行。 让你用最简单的方式,获取最丰富的数据。

weixin_66295112的博客 2094

鸿蒙系统开发app入门系列-- 第一个demo

当脉脉上全是dis鸿蒙系统的时候,我已经做完了第一个demo app,毛主席说过没有调查就没有发言权,与其坐而论道不如行而起之,来通过第一个app,感受一下鸿蒙app的开发和普通ios和Android开发有什么不同. 先自我介绍一下自己,一个35岁的IT老兵,有着前端 iOS,Android,H5,React ,后端Java,PHP,C#等众多开发语言经验,感觉像天龙八部里面的鸠摩智,会各个语言的皮毛,由都不精通.今天就拿鸿蒙系统的开发和以前的开发做个对比. 开发工具及语言 点击下载 有没有一种铺满而来的熟

zhangzeshuai的专栏 2万+

保姆级教程:在ROS Noetic下,手把手教你将自定义A*全局规划器打包成插件(附避坑指南)

本文提供了一份详细的ROS Noetic下自定义A*全局规划器插件开发指南,涵盖从环境准备、算法优化到插件配置与调试的全流程。通过实战案例和避坑技巧,帮助开发者高效实现机器人导航中的全局路径规划,特别适合需要优化ROS导航栈的开发者。

weixin_29168675的博客 287

三维重建笔记_光束平差法(Bundle Adjustment, BA)

目录 1 光束平差法(Bundle Adjustment, BA) 1.1 SFM (Structure‐from‐Motion) 定义 问题描述 1.2 重投影误差 (Reprojection Error) 目标函数 1.3 使用 Levenberg‐Marquardt Algorithm 进行优化 问题描述 简化目标函数 参考 Gauss‐Newton Method ...

惊鸿一博 2万+

鸿蒙HarmonyOS 5.0开发:应用程序包-HAR

HAR(Harmony Archive)是静态共享包,可以包含代码、C++库、资源和配置文件。

m0_73088370的博客 1222

【WRF工具】WRF 模型输出可视化工具 plotfmt

【WRF工具】WRF 模型输出可视化工具 plotfmt

WW、forever的博客 1293

鸿蒙5.0开发进阶:NDK开发-使用命令行CMake构建NDK工程

接下来介绍如何把已有的CMake工程切换到HarmonyOS工具链中,从而使用命令行CMake构建该工程。

Androidbye的博客 1054

Python 爬虫实战:华尔街见闻精选文章爬取(反反爬 + 投资情绪分析)

Python 爬虫实战:华尔街见闻精选文章爬取(反反爬 + 投资情绪分析)

yansideyucsdn的博客 970

VC中sqlite的使用

在VC中对sqlite的使用,实现数据库大批数据的快速插入,读取数据库中的数据在ListCtrl中显示

鸿蒙5.0到来,能与IOS和安卓对抗吗?

随着华为鸿蒙的不断更新,更多的设备类型和场景都能被支持,而且明年还将彻底抛弃安卓的底层代码,摆脱了套皮安卓的鸿蒙能否在如今的市场上与安卓和IOS抗衡?我们都清楚安卓系统是目前全球最流行的移动操作系统,拥有庞大的用户基数和应用生态。鸿蒙系统如果想要在市场上取得一席之地,就必须要有足够多的优质应用来吸引用户。然而,鸿蒙系统并不兼容安卓应用,这意味着开发者需要重新开发或适配应用才能在鸿蒙系统上运行。这无疑增加了开发者的成本和风险,也影响了用户的切换意愿。

bugyinyin的博客 2856

jdk-8u144-linux-x64.tar.gz.

该资源为搭建Linux系统Java环境用,资源的后缀为tar.gz格式的压缩包

鸿蒙5.0开发进阶:NDK开发-构建NDK工程(使用命令行CMake构建NDK工程)

在很多复杂应用工程中,C++代码工程是通过CMake等构建系统以命令行方式来编译构建的....

Androidbye的博客 1569

NTscan扫描工具

ntscan是一个扫描器,可以扫描没有密码和弱密码的共享,先到配置文件中填写猜测的用户名和密码,扫描过程中右侧出现的是扫描日志。

鸿蒙启航:C++开发者的HarmonyOS NEXT分布式开发指南

DevEco Studio一站式支持C++编译、调试、多设备部署,降低工具链复杂度110。:纯血鸿蒙(HarmonyOS NEXT)淘汰安卓兼容,C++原生应用需求激增68。:提供NDK工具链、CMake支持及C++标准库(支持C++17)17。:原生C++模块满足高频计算、实时渲染需求(如车机导航、医疗设备)46。:建议选择C++17以使用现代特性(如智能指针、并发库)17。支持手机、车机等多设备模拟器,实时预览C++渲染效果13。:手机(Phone)、车机(Car)等(按需勾选)5。

qq_30377315的博客 2621

鸿蒙APP架构及开发入门

鸿蒙介绍与开发指南

三翼鸟数字化平台的技术实践分享 3552

鸿蒙系统(HarmonyOS)

鸿蒙系统(HarmonyOS)是华为公司自主研发的面向未来、面向全场景的分布式操作系统。它不仅支持Java和C/C++等传统编程语言,还开放了对Python等其他编程语言的支持。这使得开发者可以更灵活地选择适合项目的开发语言,也降低了开发门槛,让更多的开发者能够参与到鸿蒙生态的建设中来。鸿蒙系统的多语言支持得益于其微内核架构设计。鸿蒙采用的是微内核+外设驱动和服务的方式,将操作系统的功能模块化,从而实现了不同组件之间的松耦合。

qq_40698086的博客 2606
上一篇: 鸿蒙5.0开发进阶:配置构建-添加依赖项
下一篇: 鸿蒙5.0开发进阶:配置构建-构建HAR
懂你的大海
博客等级 码龄6年 9049粉丝 1381原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明:

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

余额充值