Harmony OS 開發避坑指南——源碼下載和編譯

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/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包，根據官方文檔修改，一步到位，不用反覆複製粘貼！

# 下載gn/ninja/LLVM/hc-gen包：
URL_PREFIX=https://repo.huaweicloud.com/harmonyos/compiler
wget $URL_PREFIX/gn/1523/linux/gn.1523.tar
wget $URL_PREFIX/ninja/1.9.0/linux/ninja.1.9.0.tar
wget $URL_PREFIX/clang/9.0.0-34042/linux/llvm-linux-9.0.0-34042.tar
wget $URL_PREFIX/hc-gen/0.65/linux/hc-gen-0.65-linux.tar

# 編譯 hi3861 須要 riscv 編譯工具鏈
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 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 <<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/