企业官网建设流程全解析

当C++代码工程需要独立于DevEco Studio进行编译时，可以使用命令行方式将现有CMake工程切换到HarmonyOS工具链。

一、获取NDK开发包

方式一：通过Command Line Tools获取

下载command line tools并解压，NDK开发相关工具位于：

$command_line_tools解压目录/sdk/default/openharmony/native

方式二：通过DevEco Studio获取

下载并安装DevEco Studio，NDK开发相关工具位于：

$DevEco Studio安装目录/sdk/default/openharmony/native

二、配置环境变量

说明：如果只是在DevEco Studio中使用，跳过此步骤。

Linux系统

# 打开.bashrc文件 vim ~/.bashrc # 在文件最后添加cmake路径 export PATH=${实际SDK路径}/native/build-tools/cmake/bin:$PATH # 使环境变量生效 source ~/.bashrc

Mac系统

# 打开.bash_profile文件 vim ~/.bash_profile # 在文件最后添加cmake路径 export PATH=${实际SDK路径}/native/build-tools/cmake/bin:$PATH # 使环境变量生效 source ~/.bash_profile

Windows系统

右键点击“我的电脑” → “属性” → “高级系统设置” → “环境变量”，找到“Path”并点击“编辑”，添加NDK中cmake的bin目录路径。

验证环境变量配置：

cmake.exe -version # 正确回显cmake版本号则说明配置完成

三、CMake命令参数

参数作用：

• OHOS_ARCH+OHOS_PLATFORM→ 生成--target=arm-linux-ohos等clang++命令参数

• CMAKE_TOOLCHAIN_FILE→ 默认给clang++设置--sysroot，指定系统头文件根目录

四、示例

4.1 工程目录结构

demo ├── CMakeLists.txt # 根目录CMake配置 ├── include │ └── sum.h # 头文件 └── src ├── CMakeLists.txt # 子目录CMake配置 ├── sum.cpp # 算法实现 └── hello.cpp # 主入口

4.2 源码内容

根目录CMakeLists.txt：

# 指定CMake的最小版本 CMAKE_MINIMUM_REQUIRED(VERSION 3.16) # 工程名称 PROJECT(HELLO) # 添加一个子目录并构建该子目录 ADD_SUBDIRECTORY(src)

src目录CMakeLists.txt：

SET(LIBHELLO_SRC hello.cpp) # 设置编译参数 SET(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -O0") # 设置链接参数 SET(CMAKE_EXE_LINKER_FLAGS "${CMAKE_EXE_LINKER_FLAGS} -Wl,--emit-relocs --verbose") # 添加动态库目标（libsum.so） ADD_LIBRARY(sum SHARED sum.cpp) # 生成可执行程序（Hello） ADD_EXECUTABLE(Hello ${LIBHELLO_SRC}) # 指定头文件目录 TARGET_INCLUDE_DIRECTORIES(Hello PUBLIC ../include) # 指定链接库 TARGET_LINK_LIBRARIES(Hello PUBLIC sum)

hello.cpp：

#include <iostream> #include "sum.h" int main(int argc, const char **argv) { std::cout << "hello world!" << std::endl; int total = sum(1, 100); std::cout << "Sum 1 + 100=" << total << std::endl; return 0; }

sum.h：

int sum(int a, int b);

sum.cpp：

#include <iostream> int sum(int a, int b) { return a + b; }

4.3 Linux/Mac编译构建

# 创建build目录 mkdir build && cd build # 动态链接方式（默认c++_shared） cmake -D OHOS_STL=c++_shared \ -D OHOS_ARCH=arm64-v8a \ -D OHOS_PLATFORM=OHOS \ -D CMAKE_TOOLCHAIN_FILE={ohos-sdk}/linux/native/build/cmake/ohos.toolchain.cmake \ .. # 执行构建 cmake --build .

静态链接方式：

cmake -D OHOS_STL=c++_static \ -D OHOS_ARCH=arm64-v8a \ -D OHOS_PLATFORM=OHOS \ -D CMAKE_TOOLCHAIN_FILE={ohos-sdk}/linux/native/build/cmake/ohos.toolchain.cmake \ ..

注意：需要将{ohos-sdk}替换为实际的SDK下载目录。

4.4 Windows编译构建

# 进入build目录 cd build # 使用Ninja生成器 cmake -G "Ninja" \ -D OHOS_STL=c++_shared \ -D OHOS_ARCH=arm64-v8a \ -D OHOS_PLATFORM=OHOS \ -D CMAKE_TOOLCHAIN_FILE=F:\\windows\\native\\build\\cmake\\ohos.toolchain.cmake \ .. # 执行Ninja编译 ninja -f build.ninja # 或使用cmake命令 cmake --build .

Debug调试：如需debug调试，增加参数-D CMAKE_BUILD_TYPE=Debug。

五、动态链接 vs 静态链接

命令行CMake构建NDK工程需通过CMAKE_TOOLCHAIN_FILE指定ohos.toolchain.cmake，并通过OHOS_ARCH（arm64-v8a/armeabi-v7a/x86_64）、OHOS_STL（c++_shared/c++_static）、OHOS_PLATFORM=OHOS参数配置编译环境，Windows下需使用-G "Ninja"指定生成器。