HarmonyOS Next开发学习手册——构建NDK工程

概述

HarmonyOS NDK默认使用CMake作为构建系统，随包提供了符合HarmonyOS工具链的基础配置文件 ohos.toolchain.cmake，用于预定义CMake变量来简化开发者配置。

常用的NDK工程构建方式有：

• 从源码构建

源码构建也有不同方式：
* 可以使用DevEco Studio提供的C++应用模板，用DevEco Studio来编译构建
* 也可以使用命令行CMake来编译构建

• 使用预构建库构建

本章节将通过具体示例介绍如何在Native工程中使用NDK，以及如何编写CMake脚本来构建NDK工程。

ohos.toolchain.cmake简介

ohos.toolchain.cmake是HarmonyOS NDK提供给CMake的toolchain脚本，里面预定义了编译HarmonyOS应用需要设置的编译参数，如交叉编译设备的目标、C++运行时库的链接方式等；这些参数在调用CMake命令时，可以从命令行传入，来改变默认编译链接行为。此文件中的常用参数见下表。

参数	类型	说明
OHOS_STL	c++_shared/c++_static	libc++的链接方式。默认为c++_shared。 c++_shared表示采用动态链接libc++_shared.so；c++_static表示采用静态链接libc++_static.a。 由于C++运行时中存在一些全局变量，因此同一应用中的全部Native库需要采用相同的链接方式。
OHOS_ARCH	armeabi-v7a/arm64-v8a/x86_64	设置当前Native交叉编译的目标架构，当前支持的架构为armeabi-v7a/arm64-v8a/x86_64。
OHOS_PLATFORM	OHOS	选择平台。当前只支持HarmonyOS平台。

上述参数最终会控制Clang的交叉编译命令，产生合适的命令参数。

• –target={arch}-linux-ohos参数，通知编译器生成相应架构下符合HarmonyOS ABI的二进制文件。

• –sysroot={ndk_root}/sysroot参数，告知编译器HarmonyOS系统头文件的所在位置。

使用DevEco Studio模板构建NDK工程

NDK通过CMake和Ninja编译应用的C/C++代码，编译过程如下图所示。

核心编译过程如下：

1. 根据CMake配置脚本以及build-profile.json5中配置的externalNativeOptions构建参数，与缓存中的配置比对后，生成CMake命令并执行CMake。

2. 执行Ninja，按照makefile执行编译和链接，将生成的.so以及运行时依赖的.so同步到输出目录，完成构建过程。

通过DevEco Studio提供的应用模板，可以快速生成CMake构建脚本模板，并在build-profile.json5中指定相关编译构建参数。

CMakeLists.txt

通过DevEco Studio模板工程创建的NDK工程中，包含默认生成的CMakeLists.txt脚本，如下所示：

# the minimum version of CMake.
cmake_minimum_required(VERSION 3.4.1)
project(MyApplication) 

# 定义一个变量，并赋值为当前模块cpp目录
set(NA