1# NDK工程构建概述
2
3
4OpenHarmony NDK默认使用CMake作为构建系统,随包提供了符合OpenHarmony工具链的基础配置文件[ohos.toolchain.cmake](#ohostoolchaincmake简介),用于预定义CMake变量来简化开发者配置。
5
6
7常用的NDK工程构建方式有:
8
9
10- 从源码构建
11
12  源码构建也有不同方式:
13
14  - 可以使用DevEco Studio提供的C++应用模板,[用DevEco Studio来编译构建](build-with-ndk-ide.md)
15  - 也可以[使用命令行CMake来编译构建](build-with-ndk-cmake.md)
16
17- [使用预构建库构建](build-with-ndk-prebuilts.md)
18
19
20本章节将通过具体示例介绍如何在Native工程中使用NDK,以及如何编写CMake脚本来构建NDK工程。
21
22
23## ohos.toolchain.cmake简介
24
25ohos.toolchain.cmake是OpenHarmony NDK提供给CMake的toolchain脚本,里面预定义了编译OpenHarmony应用需要设置的编译参数,如交叉编译设备的目标、C++运行时库的链接方式等;这些参数在调用CMake命令时,可以从命令行传入,来改变默认编译链接行为。此文件中的常用参数见下表。
26
27| 参数 | 类型 | 说明 |
28| -------- | -------- | -------- |
29| OHOS_STL | c++_shared/c++_static | libc++的链接方式。默认为c++_shared。<br/>c++_shared表示采用动态链接libc++_shared.so;c++_static表示采用静态链接libc++_static.a。<br/>由于C++运行时中存在一些全局变量,因此同一应用中的全部Native库需要采用相同的链接方式。 |
30| OHOS_ARCH | armeabi-v7a/arm64-v8a/x86_64 | 设置当前Native交叉编译的目标架构,当前支持的架构为armeabi-v7a/arm64-v8a/x86_64。 |
31| OHOS_PLATFORM | OHOS | 选择平台。当前只支持OpenHarmony平台。 |
32
33上述参数最终会控制Clang的交叉编译命令,产生合适的命令参数。
34
35- --target={arch}-linux-ohos参数,通知编译器生成相应架构下符合OpenHarmony ABI的二进制文件。
36
37- --sysroot={ndk_root}/sysroot参数,告知编译器OpenHarmony系统头文件的所在位置。
38