Harmony OS 开发指南——源码下载和编译_harmonyos 源代码(1)

先自我介绍一下，小编浙江大学毕业，去过华为、字节跳动等大厂，目前阿里P7

深知大多数程序员，想要提升技能，往往是自己摸索成长，但自己不成体系的自学效果低效又漫长，而且极易碰到天花板技术停滞不前！

因此收集整理了一份《2024年最新HarmonyOS鸿蒙全套学习资料》，初衷也很简单，就是希望能够帮助到想自学提升又不知道该从何学起的朋友。

既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，涵盖了95%以上鸿蒙开发知识点，真正体系化！

由于文件比较多，这里只是将部分目录截图出来，全套包含大厂面经、学习笔记、源码讲义、实战项目、大纲路线、讲解视频，并且后续会持续更新

如果你需要这些资料，可以添加V获取：vip204888 （备注鸿蒙）

正文

本文介绍了如何下载鸿蒙系统源码，如何一次性配置可以编译三个目标平台（ 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主机用于烧写程序到单板以及源码编辑。

软件环境

本文所有操作均基于Ubuntu 18.04进行，其他发行版和Ubuntu版本上的命令操作可能不完全一致，但说明的原理可以互通。

下载源码

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

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

配置 repo 工具

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

mkdir ~/bin/

sudo apt install curl # 如果没有curl命令需要先下载

curl > ~/bin/repo

chmod +x ~/bin/repo

echo ‘export PATH=~/bin:$PATH’ » ~/.bashrc

source ~/.bashrc

下载Harmony OS源码

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

sudo apt install –no-install-recommends git python # repo工具本身是python脚本，它会调用git命令下载单个代码仓

开始前需要配置 user.name 和 user.email ，如果没有配置，使用如下命令进行配置：

git config –global user.name “yourname”

git config –global user.email “your-email-address”

repo init -u -b master –no-repo-verify

repo sync -c # 以后每天同步远程仓的修改，只需要执行这一条命令即可

配置环境

本节介绍如何在Linux主机上配置鸿蒙源码的编译构建环境，所有命令均通过远程终端在Linux主机上执行。

安装文件系统打包工具

1. 运行"mkfs.vfat"，如果未找到该命令，需要安装
2. 运行"mcopy “，如果未找到该命令，需要安装

sudo apt-get install dosfstools mtools # 官方文档说明的两个文件系统打包工具

sudo apt-get install zip # 官方文档虽然没有写，但是打包rootfs过程中需要使用

sudo apt install mtd-utils # 3518需要打包 jffs2 镜像的mkfs.jffs2 命令，需要安装这个包

sudo apt install build-essential # 安装gcc/g++/make等工具，ffmpeg的测试过程中需要使用链接器ld，需要这个包

下载、配置编译工具链

使用如下命令，分别下载 gn、ninja、LLVM、hc-gen包，根据官方文档修改，一步到位，不用反复复制粘贴！

下载gn/ninja/LLVM/hc-gen包

URL_PREFIX=https://repo.huaweicloud.com/harmonyos/compiler

DOWNLOAD_DIR=~/Downloads # 下载目录，可自行修改

TOOLCHAIN_DIR=~/harmonyos/toolchain # 工具链存放目录，可自行修改

[ -e $DOWNLOAD_DIR ] || mkdir $DOWNLOAD_DIR

[ -e $TOOLCHAIN_DIR ] || mkdir -p $TOOLCHAIN_DIR

wget -P $DOWNLOAD_DIR $URL_PREFIX/gn/1523/linux/gn.1523.tar

wget -P $DOWNLOAD_DIR $URL_PREFIX/ninja/1.9.0/linux/ninja.1.9.0.tar

wget -P $DOWNLOAD_DIR $URL_PREFIX/clang/9.0.0-34042/linux/llvm-linux-9.0.0-34042.tar

wget -P $DOWNLOAD_DIR $URL_PREFIX/hc-gen/0.65/linux/hc-gen-0.65-linux.tar

编译 hi3861 需要 riscv 编译工具链

wget -P $DOWNLOAD_DIR $URL_PREFIX/gcc_riscv32/7.3.0/linux/gcc_riscv32-linux-7.3.0.tar.gz

解压gn/ninja/LLVM/hc-gen包：

tar -C $TOOLCHAIN_DIR/ -xvf $DOWNLOAD_DIR/gn.1523.tar

tar -C $TOOLCHAIN_DIR/ -xvf $DOWNLOAD_DIR/ninja.1.9.0.tar

tar -C $TOOLCHAIN_DIR/ -xvf $DOWNLOAD_DIR/llvm-linux-9.0.0-34042.tar

tar -C $TOOLCHAIN_DIR/ -xvf $DOWNLOAD_DIR/hc-gen-0.65-linux.tar

tar -C $TOOLCHAIN_DIR/ -xvf $DOWNLOAD_DIR/gcc_riscv32-linux-7.3.0.tar.gz

向 ~/.bashrc 中追加gn/ninja/LLVM/hc-gen路径配置：

cat <> ~/.bashrc

TOOLCHAIN_DIR=$TOOLCHAIN_DIR

export PATH=$TOOLCHAIN_DIR/gn:$PATH

export PATH=$TOOLCHAIN_DIR/ninja:$PATH

export PATH=$TOOLCHAIN_DIR/llvm/bin:$PATH

export PATH=$TOOLCHAIN_DIR/hc-gen:$PATH

export PATH=$TOOLCHAIN_DIR/gcc_riscv32/bin:$PATH

export PATH=~/.local/bin:$PATH # 用户pip二进制工具目录

EOF

生效环境变量

source ~/.bashrc

安装python3.8和pip包管理器

• 安装python3.8和pip（编译鸿蒙源码 hi3861 目标平台需要使用scons，默认安装的scons版本需要python版本>=3.7）：

• sudo apt-get install --no-install-recommends python3.8 python3-pip

• 将默认python切换为3.8（因为18.04 上默认Python3版本是 3.6），通常有两种方式切换：

• 使用 virtualenv 管理，单独source相应的active脚本切换当前shell会话的默认python版本（推荐，下面均已这种方式进行操作）；

• 使用 update-alternatives 管理，并切换全局Python脚本配置（不推荐，用完需要切换回去，否则会影响apt等依赖python3的软件包使用）；

• 配置pip包下载源，加速国内安装pip包：

mkdir ~/.pip/

cat < ~/.pip/pip.conf

[global]

index-url =

trusted-host = mirrors.huaweicloud.com

timeout = 120

EOF

准备virtualenv

安装virtualenv

pip3 install virtualenv

创建使用python3.8为默认python解释器的virtualenv

mkdir ~/harmonyos/venv && virtualenv -p python3.8 ~/harmonyos/venv

激活 virtualenv，激活后的pip3 install会将包文件缓存到相应的子目录中

source ~/harmonyos/venv/bin/activate

安装 setuptools 和 kconfiglib

pip3 install setuptools kconfiglib

安装编译hi3861需要的pip包

pip3 install scons ecdsa pycryptodome

pip3 install –upgrade –ignore-installed six

可选：将激活脚本添加到 bashrc 中，下次登录默认自动激活此python虚拟环境，可以使用 deactivate 使虚拟环境无效

cat <> ~/.bashrc

source ~/harmonyos/venv/bin/activate

EOF

编译源码

激活刚刚建立的python虚拟环境后，在源码根目录下（ openharmony 目录）执行：

$ source ~/harmonyos/venv/bin/activate # 激活虚拟环境，激活后 deactivate 命令可使当前虚拟环境无效

$ python build.py -h # 查看支持哪些目标平台

usage:

python build.py ipcamera_hi3516dv300

python build.py ipcamera_hi3518ev300

python build.py wifiiot

Quickstart:

positional arguments:

product Name of the product

optional arguments:

网上学习资料一大堆，但如果学到的知识不成体系，遇到问题时只是浅尝辄止，不再深入研究，那么很难做到真正的技术提升。

需要这份系统化的资料的朋友，可以添加V获取：vip204888 （备注鸿蒙）

一个人可以走的很快，但一群人才能走的更远！不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人，都欢迎加入我们的的圈子（技术交流、学习资源、职场吐槽、大厂内推、面试辅导），让我们一起学习成长！

网上学习资料一大堆，但如果学到的知识不成体系，遇到问题时只是浅尝辄止，不再深入研究，那么很难做到真正的技术提升。

需要这份系统化的资料的朋友，可以添加V获取：vip204888 （备注鸿蒙）

[外链图片转存中…(img-mQj4Wucm-1713586182181)]

一个人可以走的很快，但一群人才能走的更远！不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人，都欢迎加入我们的的圈子（技术交流、学习资源、职场吐槽、大厂内推、面试辅导），让我们一起学习成长！