Harmony OS 开发避坑指南——源码下载和编译

本文介绍了如何下载鸿蒙系统源码，如何一次性配置可以编译三个目标平台（Hi3516，Hi3518和Hi3861）的编译环境，以及如何将源码编译为三个目标平台的二进制文件。

坑点总结：

1. 下载源码基本上没有太多坑，可以很顺利的进行

2. 编译源码主要的一个大坑是，默认版本的scons依赖python 3.7+，鸿蒙基础编译代码依赖python3，需要安装python 3.7+，并和当前系统上的python2.7/python3.6和谐共处！解决方法一般有两种：

• 使用virtualenv管理多个版本的python环境，这种方式好处是只在当前shell会话生效不影响系统环境、其他用户和其他shell会话，缺点是使用前需要source active脚本稍微有点麻烦；
• 使用update-alternatives管理系统的多个版本python命令，这种方式需要切换系统的链接/usr/bin/python和/usr/bin/python3，可能会影响依赖python的应用程序（例如apt）的正常使用、其他用户和其他shell会话；

准备环境

本节介绍下载、编译和烧写鸿蒙系统所需的软硬件环境。

硬件环境

其中，Linux主机用于源码下载和编译，Windows主机用于烧写程序到单板以及源码编辑。

软件环境

硬件	说明
Linux主机	推荐实际物理机器，Ubuntu16.04及以上64位系统，Shell使用bash，使用虚拟机也可以，如何安装这里不做详细介绍。
Windows主机	Windows XP/Windows7/Windows10 系统
远程终端	推荐MobaXterm（PuTTY、SecureCRT等其他远程终端也可以），用于在Windows主机上登录Linux主机，进行源码下载、编译等工作
USB转串口芯片驱动	下载链接： http://www.hihope.org/download 页面，USB-to-Serial Comm Port.exe 文件（AI Camera和DIY IPC套件附赠的USB串口线中集成了PL2302芯片，需要安装此驱动才能识别）。WiFi IoT主控芯片上集成的是CH340G芯片，可以选择联网自动安装驱动程序。

下载源码

本节介绍如何在Linux主机上下载鸿蒙源码，所有命令均通过远程终端在Linux主机上执行。

这里使用的是“从代码仓库获取”的方式，这种方式方便后续更新代码；你也可以从官网下载源码压缩包（这里不再介绍）。

配置 repo 工具

如果你的Linux系统上还没有配置repo命令，需要先下载并配置repo命令行工具：

mkdir ~/bin/
# sudo apt install curl # 如果没有curl命令需要先下载
curl https://gitee.com/oschina/repo/raw/fork_flow/repo-py3 > ~/bin/repo
chmod +x ~/bin/repo
echo 'export PATH=~/bin:$PATH'  >> ~/.bashrc
source ~/.bashrc

下载Harmony OS源码

mkdir -p ~/harmonyos/openharmony && cd ~/harmonyos/