关于harmonyos: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 主机上下载鸿蒙源码，所有命令均通过近程终端在 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/openharmony
mkdir -p ~/harmonyos/openharmony && cd ~/harmonyos/openharmony

sudo apt install 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 https://gitee.com/openharmony/manifest.git -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 过程中须要应用 

下载、配置编译工具链

应用如下命令，别离下载 gn、ninja、LLVM、hc-gen 包，依据官网文档批改，一步到位，不必重复复制粘贴！

 编译工具链
wget $URL_PREFIX/gcc_riscv32/7.3.0/linux/gcc_riscv32-linux-7.3.0.tar.gz

# 解压 gn/ninja/LLVM/hc-gen 包：tar -C ~/ -xvf gn.1523.tar
tar -C ~/ -xvf ninja.1.9.0.tar
tar -C ~/ -xvf llvm-linux-9.0.0-34042.tar
tar -C ~/ -xvf hc-gen-0.65-linux.tar
tar -C ~/ -xvf gcc_riscv32-linux-7.3.0.tar.gz

# 向 ~/.bashrc 中追加 gn/ninja/LLVM/hc-gen 门路配置：cat <<EOF >> ~/.bashrc
export PATH=~/gn:\$PATH
export PATH=~/ninja:\$PATH
export PATH=~/llvm/bin:\$PATH
export PATH=~/hc-gen:\$PATH
export PATH=~/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 python3.8 python3-pip，18.04 上默认 Python3 版本是 3.6，须要将默认 python 切换为 3.7+，通常有两种形式：
• 应用 virtualenv 治理，独自 source 相应的 active 脚本切换以后 shell 会话的默认 python 版本（举荐，上面均已这种形式进行操作）；
• 应用 update-alternatives 治理，并切换全局 Python 脚本配置（不举荐，用完须要切换回去，否则会影响 apt 等依赖 python3 的软件包应用）；
• 配置 pip 包下载源，减速国内装置 pip 包：

mkdir ~/.pip/cat <<EOF > ~/.pip/pip.conf
[global]
index-url = https://mirrors.huaweicloud.com/repository/pypi/simple
trusted-host = mirrors.huaweicloud.com
timeout = 120
EOF

筹备 virtualenv

# 装置 virtualenv
pip3 install vritualenv

# 创立应用 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 <<EOF >> ~/.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: https://device.harmonyos.com/cn/docs/start/introduce/oem_start_guide-0000001054913231

positional arguments:
  product               Name of the product

optional arguments:
  -h, --help            show this help message and exit
  -b BUILD_TYPE, --build_type BUILD_TYPE
                        release or debug version.
  -t [TEST [TEST ...]], --test [TEST [TEST ...]]
                        Compile test suit
  -n, --ndk             Compile ndk

能够查看反对哪些指标平台，目前可选的有三个。

编译 3516 指标平台的命令

python build.py ipcamera_hi3516dv300 -b debug

编译生成的 kernel、rootfs、userfs 映像文件会生成到 out/ipcamera_hi3516dv300 目录下，u-boot 二进制会生成在 vendor 目录（能够通过 find vendor -name u-boot*.bin 命令进行查找）。

编译 3518 指标平台的命令

python build.py ipcamera_hi3516dv300 -b debug

编译生成的 kernel、rootfs、userfs 映像文件会生成到 out/ipcamera_hi3518ev300 目录下，u-boot 二进制会生成在 vendor 目录（能够通过 find vendor -name u-boot*.bin 命令进行查找）。

编译 3861 指标平台的命令

python build.py wifiiot

编译生成的二进制文件位于 out/wifiiot/ 子目录下，刷机须要应用 Hi3861_wifiiot_app_allinone.bin 文件。

ffmpeg 相干编译失败问题定位

编译过程中可能会遇到 ffmpeg 相干的编译失败，可能是因为 configure 过程中呈现了问题，能够通过 vendor/hisi/hi35xx/middleware/source/third_party/ffmpeg/ffmpeg-y/ffbuild/config.log 文件查看。

参考链接

鸿蒙设施开发：https://device.harmonyos.com/

鸿蒙利用开发：https://developer.harmonyos.com/

原文链接：https://developer.huawei.com/consumer/cn/forum/topic/0202358095357830874?fid=0101303901040230869

原作者：思维