鸿蒙（开发进阶）GN构建工程配置HarmonyOS编译工具链

鸿蒙NEXT开发实战往期必看文章：

一分钟了解”纯血版！鸿蒙HarmonyOS Next应用开发！

“非常详细的” 鸿蒙HarmonyOS Next应用开发学习路线！（从零基础入门到精通）

HarmonyOS NEXT应用开发案例实践总结合（持续更新......）

HarmonyOS NEXT应用开发性能优化实践总结（持续更新......）

---

本文将介绍如何在GN工程中配置HarmonyOS工具链，然后通过HarmonyOS工具链编译出可以在HarmonyOS环境下使用的三方库。

概述

HarmonyOS编译子系统是以GN和Ninja构建为基座，对构建和配置粒度进行部件化抽象、对内建模块进行功能增强、对业务模块进行功能扩展的系统，该系统提供以下基本功能：

• 以部件为最小粒度拼装产品和独立编译。
• 支持轻量、小型、标准三种系统的解决方案级版本构建，以及用于支撑应用开发者使用IDE开发的SDK开发套件的构建。
• 支持芯片解决方案厂商的灵活定制和独立编译。

Ninja：是一个专注于快速编译的小型构建系统。

GN：Generate Ninja的缩写，用于产生Ninja文件。

编译环境配置

1. Linux编译环境搭建（如果已有对应版本的Linux开发环境，可跳过Linux环境搭建过程）：详细指导见以下链接。

   使用 WSL 在 Windows 上安装 Linux。

   Ubuntu分发版本获取及安装说明。

   编译环境目前主要支持Ubuntu18.04和Ubuntu20.04（Ubuntu22.04暂不支持）。

2. HarmonyOS SDK镜像下载：

   从DevEco Studio的SDK Manager中获取SDK。

3. 安装构建工具depot_tools并添加到环境变量。

   任意位置创建工作目录depot_tools，cd到自己创建的目录，拉取工具（需要网络环境）：

   mkdir depot_tools
   cd depot_tools
   git clone https://chromium.googlesource.com/chromium/tools/depot_tools.git

   将depot_tools的路径加到环境变量中：

   编译.bashrc文件将depot_tools路径信息加到最后一行。

   vi ~/.bashrc

   在.bashrc文件的最后添加下面一行代码。

   

   export PATH="$PATH:/xxx/depot_tools"

   此处需配置绝对路径信息，例如这里创建的本地路径是/mnt/d/my_code/depot_tools，故此处配置如上图。

   刷新环境变量使其生效：

   source ~/.bashrc

4. 使用GN需要Python环境，安装Python环境。

   sudo apt update
   sudo apt install python

   直接输入指令sudo apt install python可能会安装失败，需要先输入sudo apt update更新一下可用包的最新列表。

   

   判断python是否安装成功：

   输入python显示python版本即可。

   

GN构建工程适配流程