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

華為開發者論壇發表於2020-11-27

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

本文介紹瞭如何下載鴻蒙系統原始碼,如何一次性配置可以編譯三個目標平臺(Hi3516Hi3518Hi3861)的編譯環境,以及如何將原始碼編譯為三個目標平臺的二進位制檔案。

坑點總結

  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/

相關文章