大网数据广告活动
OpenHarmony 设备与应用开发

NDK开发导读

· 52CE 我爱测

NDK(Native Development Kit)是OpenHarmony SDK提供的Native API、相应编译脚本和编译工具链的集合,方便开发者使用C或C++语言实现应用的关键功能。NDK只覆盖了OpenHarmony一些基础的底层能力,如C运行时基础库libc、图形库、窗口系统、多媒体、压缩库、面向ArkTS/JS与C跨语言的Node-API等,没有提供ArkTS/JS API的完整能力。

NDK开发导读

NDK(Native Development Kit)是OpenHarmony SDK提供的Native API、相应编译脚本和编译工具链的集合,方便开发者使用C或C++语言实现应用的关键功能。NDK只覆盖了OpenHarmony一些基础的底层能力,如C运行时基础库libc、图形库、窗口系统、多媒体、压缩库、面向ArkTS/JS与C跨语言的Node-API等,没有提供ArkTS/JS API的完整能力。

运行状态,开发者可以使用NDK中的Node-API接口,访问、创建、操作JS对象;也允许JS对象使用Native动态库。

NDK适用场景

适合使用NDK的场景:应用涉及如下场景时,适合采用NDK开发

  • 性能敏感的场景,如游戏、物理模拟等计算密集型场景。

  • 需要复用已有C或C++库的场景。

  • 需要针对CPU特性进行专项定制库的场景,如Neon加速。

不建议使用NDK的场景:应用涉及如下场景时,不建议采用NDK开发

  • 纯C或C++的应用。

  • 希望在尽可能多的OpenHarmony设备上保持兼容的应用。

NDK必备基础知识

为顺利进行NDK开发,开发者需要先掌握必要的基本概念及基础知识。

前置知识

  • Linux C语言编程知识

    内核、libc基础库基于POSIX等标准扩展而来,掌握基本的Linux C编程知识能够更好的帮助理解OpenHarmony NDK开发。

  • CMake使用知识

    CMake是OpenHarmony默认支持的构建系统。请先通过CMake官方文档了解基础用法。

  • Node Addons开发知识

    ArkTS采用Node-API作为跨语言调用接口,熟悉基本的Node Addons开发模式,可以更好理解NDK中Node-API的使用。

  • Clang/LLVM编译器使用知识

    具备一定的Clang/LLVM编译器基础知识,能够帮助开发者编译出更优的Native动态库。

  • Node-API

    曾用名NAPI,是OpenHarmony中提供ArkTS/JS与C/C++跨语言调用的接口,该接口基于Node.js的Node-API扩展而来,但不完全兼容。

NDK目录简介

获取NDK开发包,请参考NDK开发工具目录。

  • build目录:放置预定义的toolchain脚本文件ohos.toolchain.cmake

    [图示请参阅官方原文]

    CMake编译时需要读取该文件中的默认值,比如编译器架构、C++库链接方式等,因此在编译时会通过CMAKE_TOOLCHAIN_FILE指出该文件的路径,便于CMake在编译时定位到该文件。

  • build-tools文件夹:放置NDK提供的编译工具

    # 键入下一行命令查看CMake的版本
    cmake -version
    # 结果
    cmake version 3.16.5
    CMake suite maintained and supported by Kitware (kitware.com/cmake).
    
  • llvm文件夹:放置NDK提供的编译器

    [图示请参阅官方原文]

NDK常用模块

下表介绍了NDK的常用模块及其功能简介。

模块 模块简介
标准C库 基于musl提供的标准C库接口。
标准C++库 C++运行时库接口,提供C++运行时能力。
日志 提供向系统输出HiLog日志接口。
Node-API 支持ArkTS/JS和C/C++之间的交互接口。
FFRT 基于任务的并发编程框架。
libuv 第三方异步IO库。
zlib 提供基础数据压缩与解压功能的zlib库。
Rawfile 提供访问应用内置资源的接口,可用于读取应用中打包的各种资源。
XComponent ArkUI XComponent组件,提供surface与触屏事件等接口,便于开发高性能图形应用。
Drawing 系统提供的2D图形库,支持在surface进行绘制。
OpenGL 系统提供的OpenGL 3D图形接口。
OpenSL ES 支持2D、3D音频加速的接口。

本文来自 OpenHarmony 文档贡献者,按 CC BY 4.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
OpenHarmony 文档贡献者
适用范围
master 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。