鸿蒙系统研究第一步：从源码构建系统镜像
鸿蒙系统研究第一步：从源码构建系统镜像
周末下载了 OpenHarmony OS 2.0 的源码，并 build 成功。虽然大部分的步骤都是来自官方文档，但还是碰到了一些问题，所以决定还是写下来，当作一个备忘录。
我平常使用的开发环境是 Ubuntu Linux 系统，但这次切换到了 Windows 系统，原因是鸿蒙的开发工具 DevEcoStudio 和烧写工具 HiTool 只有 Windows 版本和 Mac 版本。好在 Windows 10 对 Linux 的支持非常好，其中 WSL (Windows Subsystem for Linux) 可以像 Windows 应用程序那样安装与运行，比使用虚拟机高效。WSL 已经进化到第二代，简称为 WSL2。关于 WSL2 的安装与配置，请参考相关文档。
我从 Microsoft Store 安装的 Linux 发行版本为 Ubuntu 18.04 LTS 版本。
需要注意的是，WSL2 Linux 的系统镜像文件默认放置在 C 盘，如果 C 盘空间预留不是很足够的话，建议移动到其它空间比较足的盘上。具体方法如下：
- 首先找到 WSL2 Linux 的系统镜像文件位置，默认为 C:\Users<用户>\AppData\Local\Packages\CanonicalGroupLimited.Ubuntu18.04onWindows_79rhkp1fndgsc\LocalState ，将其中的 <用户> 替换为你的用户名。
- 将 C:\Users<用户>\AppData\Local\Packages\CanonicalGroupLimited.Ubuntu18.04onWindows_79rhkp1fndgsc\LocalState 移动到其它盘，比如 D:\VirtualMachines\WSL2\Ubuntu18.04\LocalState
- 建立符号链接（类似 Linux 下的软链接）。
mklink /j C:\Users\chenz\AppData\Local\Packages\CanonicalGroupLimited.Ubuntu18.04onWindows_79rhkp1fndgsc\LocalState D:\VirtualMachines\WSL2\Ubuntu18.04\LocalState
做好上述准备后，就不会担心 C 盘被撑爆了。
言归正传，下面就说说在 Ubuntu 18.04 LTS 下如何下载和编译 OpenHarmony OS 2.0 的源码。
安装依赖工具
安装命令如下：
sudo apt-get update
sudo apt-get install binutils git-core git-lfs gnupg flex bison gperf build-essential zip curl zlib1g-dev gcc-multilib g++-multilib libc6-dev-i386 lib32ncurses5-dev x11proto-core-dev libx11-dev lib32z-dev ccache libgl1-mesa-dev libxml2-utils xsltproc unzip m4 python2.7 python-minimal
获取标准系统源码
官方文档给了三种获取系统源码的方式，如果是研究鸿蒙系统，最好直接从软件仓库下载，这样有比较完善的提交信息。所以这里只介绍如何从软件仓库克隆系统源码。
- 配置 git 用户信息
git config --global user.name "yourname"
git config --global user.email "your-email-address"
git config --global credential.helper store
- 安装 repo 工具，可以执行如下命令。
$ curl https://gitee.com/oschina/repo/raw/fork_flow/repo-py3 > repo
$ chmod a+x repo
$ sudo mv repo /usr/local/bin/repo
$ sudo apt install python3-pip
$ pip3 install -i https://repo.huaweicloud.com/repository/pypi/simple requests
- 获取标准系统源码
$ mkdir OpenHarmony
$ cd OpenHarmony
$ repo init -u https://gitee.com/openharmony/manifest.git -b master --no-repo-verify
$ repo sync -c
$ repo forall -c 'git lfs pull'
注意：repo sync 命令后面的 -c 参数表示只获取当前分支的源码，也就是说并不是所有分支的代码。我尝试不加这个 -c 参数，可能是 gitee 的配置问题，超过 1G 的软件仓库，比如 linux kernel 就出现如下错误，网上搜索了很多方法也未能解决。
error: RPC failed; curl 56 GnuTLS recv error (-110): The TLS connection was non-properly terminated.
fatal: The remote end hung up unexpectedly
fatal: early EOF
fatal: index-pack failed
获取预编译工具
$ curl https://gitee.com/landwind/script-tools/raw/master/Shell/OpenHarmony/OpenHarmony_2.0_canary_prebuilts_download.sh >./prebuilts_download.sh
$ bash ./prebuilts_download.sh
配置NodeJS环境和获取Node_modules依赖包
- 下载Nodejs。
$ mkdir -p prebuilts/build-tools/common/nodejs
$ cd prebuilts/build-tools/common/nodejs
$ wget --no-check-certificate https://nodejs.org/download/release/v12.18.4/node-v12.18.4-linux-x64.tar.gz
$ tar -zxvf node-v12.18.4-linux-x64.tar.gz
$ cd -
- 下载node_modules包。
$ cd third_party/jsframework
$ export PATH=../../prebuilts/build-tools/common/nodejs/node-v12.18.4-linux-x64/bin:${PATH}
$ npm install
$ cd -
- 把下载的node_modules包放入OpenHarmony代码的prebuilts/build-tools/common/js-framework目录下。
$ mkdir -p prebuilts/build-tools/common/js-framework
$ cp -rp third_party/jsframework/node_modules prebuilts/build-tools/common/js-framework/
安装hc-gen工具
hc-gen用于进行驱动编译，具体安装步骤如下：
下载 hc-gen 工具。
$ wget https://repo.huaweicloud.com/harmonyos/compiler/hc-gen/0.65/linux/hc-gen-0.65-linux.tar
解压 hc-gen 安装包到 ~/hc-gen 路径下。
tar -xvf hc-gen-0.65-linux.tar -C ~/
设置环境变量。
vim ~/.bashrc
将以下命令拷贝到.bashrc文件的最后一行，保存并退出。
export PATH=~/hc-gen:$PATH
生效环境变量。
source ~/.bashrc
编译系统
执行脚本 build.sh 即可，后面必须加上 --product-name Hi3516DV300 参数，目前只支持这一种产品形态的构建。
$ ./build.sh --product-name Hi3516DV300 --ccache
构建成功以后，输出如下：
手头还没有 Hi3516DV300 的板子，所以无法烧写体验鸿蒙系统。
非常意外的是，OpenHarmony OS 2.0 没有提供模拟器的 build 选择，这对开发者相当不友好。后面我会研究一下 QEMU 模拟器，看能否在 QEMU 上把 OpenHarmony OS 2.0 运行起来，敬请关注。