本文來(lái)源電子發(fā)燒友社區(qū)，作者：ITMING， 帖子地址：https://bbs.elecfans.com/jishu_2307430_1_1.html


前言

通過(guò)【軟通動(dòng)力鴻湖萬(wàn)聯(lián)揚(yáng)帆系列“競(jìng)”開發(fā)板試用體驗(yàn)】認(rèn)識(shí)"競(jìng)"筆者帶大家認(rèn)識(shí)了揚(yáng)帆系列“競(jìng)”開發(fā)板，本節(jié)將講解OpenHarmony源碼編譯環(huán)境搭建以及將編譯OpenHarmony標(biāo)準(zhǔn)系統(tǒng)燒錄到“競(jìng)”開發(fā)板。

OpenHarmony標(biāo)準(zhǔn)系統(tǒng)位開發(fā)者提供了兩種源碼編譯、燒錄的方式：

• IDE方式：完全采用IDE(DevEco Device Tool)進(jìn)行一站式開發(fā)，編譯依賴工具的安裝及編譯、燒錄、運(yùn)行都通過(guò)IDE進(jìn)行操作。
• 安裝包方式：通過(guò)命令進(jìn)行編譯依賴工具的下載安裝，編譯操作也通過(guò)命令實(shí)現(xiàn)。

筆者更喜歡使用第二種安裝包方式，但本文中筆者使用Ubuntu+瑞芯微開發(fā)工具的方式進(jìn)行源碼編譯及燒錄。

1 安裝VMware Workstation Player

VMware Workstation Player(以下簡(jiǎn)稱VM Player)是一款桌面虛擬化應(yīng)用，可以在當(dāng)前計(jì)算機(jī)上運(yùn)行一個(gè)或多個(gè)其他操作系統(tǒng)，在后面小節(jié)中編譯OpenHarmony源代碼需要使用Ubuntu操作系統(tǒng)，因而小節(jié)會(huì)帶讀者安裝VM Player。當(dāng)然讀者也可以選擇其他的虛擬化應(yīng)用程序，如需要授權(quán)的VMware Workstation Pro，或者Virtual Box，甚至讀者還可以使用云虛擬機(jī)。

1.1 下載VM Player

在瀏覽器中打開VM Player下載地址，展開左側(cè)菜單欄下的工作空間，點(diǎn)擊桌面Hypervisor菜單，右側(cè)內(nèi)容區(qū)定位到具體的模塊，點(diǎn)擊Workstation Player卡片進(jìn)入到下載界面，如圖1-1所示。

點(diǎn)擊頁(yè)面中的“免費(fèi)下載”按鈕，等待下載完成，如圖1-2所示。

1.2 安裝VM Player

下載完成后，讀者會(huì)在下載存儲(chǔ)路徑文件夾中得到VM Player安裝包，如VMware-player-full-xxx.exe文件，然后雙擊安裝包，打開安裝向?qū)?，如圖1-3所示。

點(diǎn)擊安裝向?qū)Ы缑嬷小跋乱徊健卑粹o，打開VMware最終用戶許可協(xié)議，勾選“我接受許可協(xié)議中的條款”(感興趣的話也可以讀一讀)，如圖1-4所示。

接著點(diǎn)擊“下一步”按鈕，進(jìn)入到VM Player安裝路徑設(shè)置界面，如圖1-5所示。點(diǎn)擊“更改”按鈕設(shè)置VM Player安裝位置，建議安裝到除C盤之外的其他磁盤中，若只有一個(gè)磁盤，則忽略，如圖1-6所示。

更改完路徑后，點(diǎn)擊“確定”按鈕回到自定義安裝界面，點(diǎn)擊“下一步”按鈕，進(jìn)入用戶體驗(yàn)設(shè)置界面，可默認(rèn)，也可取消勾選，如圖1-7所示。

接著點(diǎn)擊“下一步”按鈕，進(jìn)入快捷方式設(shè)置界面，勾選桌面和開始菜單程序文件夾，方便打開應(yīng)用程序，如圖1-8所示。

點(diǎn)擊“下一步”按鈕，進(jìn)入到VM Player安裝界面，點(diǎn)擊“安裝”按鈕進(jìn)行安裝，如圖1-9所示。

等待安裝完成后，點(diǎn)擊“完成”按鈕(若個(gè)人使用點(diǎn)擊“跳轉(zhuǎn)許可”按鈕即可)，如圖1-10所示。

1.3 初次體驗(yàn)VM Player

雙擊桌面VMware Workstation 16 Player圖標(biāo)，打開VM Player應(yīng)用程序，如圖1-11所示。

由于開發(fā)板需要連接到主機(jī)上，所以此處做額外的設(shè)置，點(diǎn)擊菜單欄Player，選擇文件選項(xiàng)下的首選項(xiàng)，在USB列表中勾選“將設(shè)備連接到主機(jī)”，如圖1-12所示。

2 準(zhǔn)備Ubuntu 20.04 系統(tǒng)鏡像包

Ubuntu是一個(gè)以桌面為主的Linux操作系統(tǒng)，是編譯OpenHarmony源代碼必要的環(huán)境之一，打開官網(wǎng)下載鏈接下載Ubuntu 20.04桌面版(64位)，如圖2-1所示。

注：由于下載的文件格式為.torrent，因此需要使用迅雷下載完整的ISO文件，當(dāng)然讀者也可以使用國(guó)內(nèi)鏡像網(wǎng)站下載Ubuntu 20.04。

3 創(chuàng)建名為OpenHarmony虛擬機(jī)并安裝Ubuntu操作系統(tǒng)

1、2小節(jié)準(zhǔn)備了OpenHarmony源代碼編譯所需的虛擬機(jī)和Ubuntu操作系統(tǒng)鏡像包，本節(jié)將帶讀者創(chuàng)建名為OpenHarmony的虛擬機(jī)并安裝Ubuntu操作系統(tǒng)。

3.1 創(chuàng)建名為OpenHarmony虛擬機(jī)

點(diǎn)擊VM Player歡迎頁(yè)中的創(chuàng)建新虛擬機(jī)，打開新建虛擬機(jī)向?qū)В催x“稍后安裝操作系統(tǒng)”，如圖3-1所示。

點(diǎn)擊“下一步”按鈕，打開選擇客戶機(jī)操作系統(tǒng)界面，客戶操作系統(tǒng)選擇Linux，版本選擇Ubuntu 64位，如圖3-2所示。

點(diǎn)擊“下一步”按鈕，打開命名虛擬機(jī)界面，設(shè)置虛擬機(jī)名稱和虛擬機(jī)存儲(chǔ)位置，如圖3-3所示。

點(diǎn)擊“下一步”按鈕，打開指定磁盤容量界面，為虛擬機(jī)磁盤指定磁盤大小(建議100GB以上)，同時(shí)選擇虛擬磁盤存儲(chǔ)方式，如圖3-4所示。

點(diǎn)擊“下一步”按鈕，打開已準(zhǔn)備好創(chuàng)建虛擬機(jī)界面，該界面中顯示當(dāng)前創(chuàng)建的虛擬機(jī)各項(xiàng)配置。點(diǎn)擊“完成”按鈕，完成虛擬機(jī)創(chuàng)建，如圖3-5所示。

在VM Player左側(cè)虛擬機(jī)管理區(qū)，點(diǎn)擊OpenHarmony菜單項(xiàng)，切換到名稱為OpenHarmony的虛擬機(jī)，然后點(diǎn)擊“編輯虛擬機(jī)設(shè)置”，進(jìn)行虛擬機(jī)細(xì)項(xiàng)配置，如圖3-6所示。

打開虛擬機(jī)設(shè)置界面默認(rèn)硬件選項(xiàng)卡，首先設(shè)置虛擬機(jī)內(nèi)存大小，建議讀者設(shè)置為8G以上，然后點(diǎn)擊“確定”按鈕應(yīng)用配置，如圖3-7所示。

接著在硬件選項(xiàng)卡中，點(diǎn)擊CD/DVD(SATA)細(xì)項(xiàng)配置Ubuntu鏡像路徑，如圖3-8所示。

屏蔽開發(fā)板設(shè)備連接主機(jī)后虛擬機(jī)提示，移除硬件選項(xiàng)卡中的USB控制器，如圖3-9所示。

3.2 安裝Ubuntu操作系統(tǒng)

3.1小節(jié)設(shè)置虛擬機(jī)各項(xiàng)細(xì)項(xiàng)完成后，點(diǎn)擊名稱為OpenHarmony主界面的播放虛擬機(jī)，等待操作系統(tǒng)加載完成，進(jìn)入安裝Ubuntu操作系統(tǒng)安裝向?qū)Ы缑?，并選擇語(yǔ)言，如圖3-10所示。

在安裝向?qū)Ы缑?，有“試用Ubuntu”和“安裝Ubuntu”兩個(gè)按鈕選項(xiàng)，為了規(guī)避安裝時(shí)存在部分界面無(wú)法全顯的問(wèn)題，這兒選擇點(diǎn)擊“試用Ubuntu”按鈕，進(jìn)入U(xiǎn)buntu操作系統(tǒng)桌面后，打開終端，輸入xrandr -s 1280x800設(shè)置分辨率。

接著雙擊Ubuntu桌面“安裝Ubuntu 20.04.4 LTS”圖標(biāo)，進(jìn)入真實(shí)安裝向?qū)Ы缑妫麄€(gè)安裝如圖3-11~19所示。

4 準(zhǔn)備OpenHarmony源碼編譯環(huán)境

在1~3小節(jié)為OpenHarmony源碼編譯準(zhǔn)備好了前置約束條件，本小節(jié)將帶讀者搭建OpenHarmony源碼編譯環(huán)境。在正式開始之前，讀者需要先將Ubuntu軟件源改為國(guó)內(nèi)鏡像地址，打開設(shè)置-->關(guān)于-->軟件更新，在Ubuntu軟件頁(yè)簽中，更改軟件源，如圖4-1所示。

注：更改完成后，打開終端輸入sudo apt-get update和sudo apt-get upgrade進(jìn)行同步。

4.1 配置Ubuntu環(huán)境

啟動(dòng)上節(jié)準(zhǔn)備安裝好的Ubuntu操作系統(tǒng)虛擬機(jī)，打開終端，執(zhí)行以下命令檢查Shell環(huán)境是否為bash，如圖4-2所示。

ls -l /bin/sh

如圖為dash，因此執(zhí)行以下命令進(jìn)行更改，如圖4-3所示。

sudo dpkg-reconfigure dash

注：更改完成后，執(zhí)行圖4-2命令再次檢查是否切換成功。

4.2 安裝DevEco Device Tool軟件包。

1. 下載最新的DevEco Studio ToolLinux(64-bit)版本，如圖4-4所示。

2. 執(zhí)行以下命令解壓下載的devicetool-linux-tool-3.1.0.200.zip，如圖4-5所示。

unzip devicetool-linux-tool-3.1.0.200.zip

3. 執(zhí)行命令賦予安裝文件可執(zhí)行權(quán)限。

chomd u+x devicetool-linux-tool-3.1.0.200.sh

4. 執(zhí)行以下命令，安裝DevEco Device Tool，在用戶協(xié)議和隱私聲明簽署界面，選擇同意項(xiàng)(使用TAB鍵切換到“確定”按鈕)，如圖4-6所示。

sudo ./devicetool-linux-tool-3.1.0.200.sh

等待安裝完成后，終端界面會(huì)顯示“DevEco Device Tool successfully installed.”時(shí)，則證明安裝成功，如圖4-7所示。

4.3 獲取并編譯OpenHarmony源碼

OpenHarmony是由開放原子開源基金會(huì)(OpenAtom Foundation)孵化及運(yùn)營(yíng)的開源項(xiàng)目，其代碼是以組件的形式開放，開發(fā)者可以通過(guò)如下其中一種方式獲?。?/p>

• 使用repo或git工具從gitee或github中下載，此方法可以獲取到最新的代碼；
• 通過(guò)DevEco Marketplace網(wǎng)站獲?。?/li>
• 從鏡像站點(diǎn)下載發(fā)行版壓縮文件。

筆者使用第一種方式從gitee中獲取OpenHarmony源代碼.

1. 使用以下命令安裝git和git-lfs，如圖4-8所示。

sudo apt-get install git git-lfs

2. 執(zhí)行以下命令為git配置用戶信息(一定要有自己的碼云賬號(hào))，如圖4-9所示。

git config --global user.name "用戶名"
git config --global user.email "郵箱地址"
git config --global credential.helper store

3. 執(zhí)行以下命令安裝碼云repo工具，如圖4-10所示。

curl https://gitee.com/oschina/repo/raw/fork_flow/repo-py3 -o /usr/local/bin/repo  #如果沒(méi)有權(quán)限，可下載至其他目錄，并將其配置到環(huán)境變量中
chmod a+x /usr/local/bin/repo
pip3 install -i https://repo.huaweicloud.com/repository/pypi/simple requests

注意：若出現(xiàn)Failed to create the file /usr/local/bin/repo: 權(quán)限不夠，則在命令行前加sudo。

注意：若出現(xiàn)Command 'curl' not found, but can be installed with: sudo apt install curl，則執(zhí)行命令sudo apt-get install curl安裝curl插件。

4. 獲取源碼方式有兩種，一種使用repo+ssh方式，另一種repo+http方式，筆者使用的是第二種方式，不需要設(shè)置公鑰。關(guān)于OpenHarmony源碼可以獲取主干代碼也可以獲取分支代碼，前者為最新代碼，筆者此處使用的是最新的代碼。執(zhí)行以下命令，獲取OpenHarmony主干代碼，如圖4-11所示。

# 創(chuàng)建一個(gè)目錄
mkdir -p ~/openharmony/coding && cd $_
repo init -u https://gitee.com/openharmony/manifest.git -b master --no-repo-verify
repo sync -c
repo forall -c 'git lfs pull'

5. 在源碼根目錄下執(zhí)行prebuilts腳本，安裝編譯器及二進(jìn)制工具，如圖4-12所示。

bash build/prebuilts_download.sh

6. 打開存儲(chǔ)OpenHarmony源碼的目錄，源碼各目錄說(shuō)明如表4-1所示，源碼目錄如圖4-13所示。

7. 編譯OpenHarmony源碼
   筆者這里使用的是終端命令方式編譯，在源碼根目錄打開終端，輸入以下命令進(jìn)行源碼編譯，如圖4-14所示。

./build.sh --product-name yangfan --ccache

注：由于沒(méi)有下載部分依賴工具，因此編譯時(shí)會(huì)出現(xiàn)一些問(wèn)題。缺失依賴工具如圖4-15所示，使用以下命令進(jìn)行安裝。

sudo apt-get install default-jdk u-boot-tools mtd-utils scons gcc-arm-none-eabi gcc-arm-linux-gnueabi

安裝完依賴工具后，再次執(zhí)行源碼編譯命令，等待編譯完成，如圖4-16所示，出現(xiàn)yangfan build success和build successful則表示編譯成功。

源碼編譯后的產(chǎn)物在源代碼根目錄下out目錄中，如圖4-17所示。

注：編譯yangfan源碼適用于RK3399芯片，筆者手中的揚(yáng)帆系列是“競(jìng)”開發(fā)板，是以RK3568芯片為主的，因此筆者選擇重新編譯源碼使其適用于產(chǎn)品名稱為rk3568，該源碼典型應(yīng)用是潤(rùn)和DAYU200開發(fā)板。

4.4 編譯生成RK3568芯片鏡像

適用于“競(jìng)”開發(fā)板的源碼還未合入OpenHarmony主倉(cāng)，因此筆者選擇編譯生成RK3568芯片鏡像，使用以下命令重新編譯。

./build.sh --product-name rk3568 --ccache

使用命令方式第一次編譯源碼需要耗費(fèi)一定的時(shí)間，等待編譯完成，如圖4-18所示。

參照【軟通動(dòng)力鴻湖萬(wàn)聯(lián)揚(yáng)帆系列“競(jìng)”開發(fā)板試用體驗(yàn)】認(rèn)識(shí)"競(jìng)"文章第6小結(jié)使用瑞芯微將編譯后的鏡像燒錄到“競(jìng)”開發(fā)板中，編譯后的鏡像位置源碼根目錄/out/rk3568/packages/phone/images/。燒錄成功后，啟動(dòng)開發(fā)板會(huì)出現(xiàn)以下問(wèn)題：

• 開機(jī)動(dòng)畫不是SwanLinkOS；
• DevEco Studio 無(wú)法識(shí)別設(shè)備；
• 開發(fā)板息屏導(dǎo)致設(shè)備重新啟動(dòng)；
• 界面布局錯(cuò)位。

5 小結(jié)

本節(jié)對(duì)OpenHarmony源碼編譯環(huán)境搭建、源碼目錄結(jié)構(gòu)、針對(duì)性編譯做了簡(jiǎn)單介紹，下章節(jié)將對(duì)源碼進(jìn)行魔改，以適配“競(jìng)”開發(fā)板。