【六】Purple Pi OH開發(fā)板帶你7天入門OpenHarmony！

今天我們來從OpenHarmony簡介、環(huán)境搭建、創(chuàng)建第一個OpenHarmony項(xiàng)目等方面開始OpenHarmony應(yīng)用開發(fā)的第一步。

一. OpenHarmony簡介

OpenHarmony 是由開放原子開源基金會（OpenAtom Foundation）孵化及運(yùn)營的開源項(xiàng)目,目標(biāo)是面向全場景、全連接、全智能時代、基于開源的方式，搭建一個智能終端設(shè)備操作系統(tǒng)的框架和平臺，促進(jìn)萬物互聯(lián)產(chǎn)業(yè)的繁榮發(fā)展。

1.2二.工具簡介

DevEco Studio 是 OpenHarmony 應(yīng)用開發(fā)推薦的 IDE 工具。

HUAWEI DevEco Studio For OpenHarmony 是基于 IntelliJ IDEA Community 開源版本打造，面向 OpenHarmony 全場景多設(shè)備的一站式集成開發(fā)環(huán)境（IDE），為開發(fā)者提供工程模板創(chuàng)建、開發(fā)、編譯、調(diào)試、發(fā)布等 E2E 的 OpenHarmony 應(yīng)用/服務(wù)開發(fā)。

通過使用 DevEco Studio，開發(fā)者可以更高效的開發(fā)具備 OpenHarmony 分布式能力的應(yīng)用/服務(wù)，進(jìn)而提升創(chuàng)新效率。

三.環(huán)境搭建

3.1 下載安裝DevEco Studio

在下載地址里下滑找到歷史版本，選擇更多版本后找到3.0 Relese，下載對應(yīng)系統(tǒng)版本。

下載完成后進(jìn)行安裝，安裝時不需要特殊配置，大部分選擇接受默認(rèn)配置即可，部分安裝路徑和個性化可以按需更改。

這里全部勾選即可。

完成后選擇第二個，在桌面上啟動DevEco Studio。

3.2 配置開發(fā)環(huán)境

接下來介紹第一次啟動DevEco Studio的配置向?qū)В?.2.1 運(yùn)行已安裝的DevEco Studio。

首次使用，請選擇Do not import settings，單擊OK。3.33.4.5

3.2.2

進(jìn)入DevEco Studio操作向?qū)ы撁?，修改npm registry，DevEco Studio已預(yù)置對應(yīng)的倉（默認(rèn)的npm倉，可能出現(xiàn)部分開發(fā)者無法訪問或訪問速度緩慢的情況），直接單擊Start using DevEco Studio進(jìn)入下一步。

說明：如果配置向?qū)Ы缑娉霈F(xiàn)的是設(shè)置Set up HTTP Proxy界面，說明網(wǎng)絡(luò)受限，請根據(jù)參考信息配置DevEco Studio代理和NPM代理后，再下載OpenHarmony SDK。

3.2.3

設(shè)置Node.js信息，可以指定本地已安裝的Node.js（此處安裝DevEco版本為3.0，Node.js版本要求為v14.19.1及以上，且低于v15.0.0；對應(yīng)的npm版本要求為6.14.16及以上，且低于7.0.0版本）；如果本地沒有合適的版本，可以選擇Download按鈕，在線下載Node.js。本示例以下載Node.js為例，選擇下載源和存儲路徑后，單擊Next進(jìn)入下一步。

說明：若配置過程中檢測到在環(huán)境變量中，或在C:\Users\userName目錄下有符合要求的Node.js版本，則設(shè)置Node.js步驟將自動跳過。

等待Node.js安裝完成，然后單擊Finish進(jìn)入下一步。

3.2.4

在SDK Componets Setup界面，設(shè)置OpenHarmony SDK下載路徑，如果需要開發(fā)HarmonyOS應(yīng)用，請勾選上HarmonyOS SDK，單擊Next進(jìn)入下一步。

說明：OpenHarmony SDK和HarmonyOS SDK不能設(shè)置為同一個路徑，且路徑中不能包含中文字符。

3.2.5

在彈出的SDK下載信息頁面，單擊Next，并在彈出的License Agreement窗口，閱讀License協(xié)議，需同意License協(xié)議后（若步驟4中勾選了HarmonyOS SDK，需同時接受OpenHarmony SDK和HarmonyOS SDK的License協(xié)議），單擊Next開始下載SDK。

說明：下載SDK過程中，如果出現(xiàn)下載JS SDK失敗，提示“Install Js dependencies failed”，請根據(jù)JS SDK安裝失敗處理指導(dǎo)進(jìn)行處理。

3.2.6

等待OpenHarmony SDK及工具下載完成，單擊Finish，界面會進(jìn)入到DevEco Studio歡迎頁。

四.創(chuàng)建第一個OpenHarmony項(xiàng)目

4.1

選擇模板

打開 DevEco Studio，選擇 Create Project 進(jìn)入 Choose your ability template，選擇 OpenHarmony 下的 Empty Ability 模板。

DevEco Studio 提供了(HarmonyOs 和 OpenHarmony)兩類Template，每個模板都有符合自己應(yīng)用的場景，其中 Empty Ability 是默認(rèn)創(chuàng)建的 ets 工程模板。

這里配置默認(rèn)即可或如圖進(jìn)行調(diào)整。

4.2 預(yù)覽界面

等待項(xiàng)目創(chuàng)建完成，打開/pages/index.ets可以看到代碼。點(diǎn)擊右側(cè)的Previewer可以預(yù)覽界面效果。

4.3增加頁面

右鍵pages文件夾，選擇New->Page新建一個頁面。

頁面初始化設(shè)置。

修改’message’字符串和字號，點(diǎn)擊右上角刷新，可以看到新的效果。

4.4增加交互按鈕

在第一個頁面增加一個按鈕，即Button組件，設(shè)置文字內(nèi)容和樣式。

導(dǎo)入router模塊，即頁面跳轉(zhuǎn)接口，監(jiān)聽Button點(diǎn)擊事件并跳轉(zhuǎn)到第二個頁面。

同理，在第二個頁面導(dǎo)入router模塊并增加按鈕，跳轉(zhuǎn)到第一個頁面。

點(diǎn)擊預(yù)覽，即可通過按鈕完成頁面的跳轉(zhuǎn)。

4.5在本地真機(jī)運(yùn)行應(yīng)用/服務(wù)

在Phone和Tablet中運(yùn)行OpenHarmony應(yīng)用/服務(wù)的操作方法一致，可以采用USB連接方式或者IP Connection的連接方式。采用IP Connection連接方式要求Phone/Tablet和PC端在同一個網(wǎng)段，建議將Phone/Tablet和PC連接到同一個WLAN下。

4.6使用USB連接方式

【設(shè)置】->【系統(tǒng)】->【開發(fā)者選項(xiàng)】，打開【USB調(diào)試】：

連接后，右上角會出現(xiàn)設(shè)備：

4.7使用IP Connection連接方式

將Phone/Tablet和PC連接到同一WLAN網(wǎng)絡(luò)。

獲取Phone/Tablet端的IP地址，可通過MobaXterm使用ifconfig wlan0命令查看。

Phone/Tablet上的5555端口為打開狀態(tài)，默認(rèn)是關(guān)閉狀態(tài)，可以連接上設(shè)備后，先檢查是否檢測到設(shè)備，然后執(zhí)行如下命令打開。

hdc tmode port 5555

在DevEco Studio菜單欄中，單擊Tools>IP Connection，輸入連接設(shè)備的IP地址，單擊 ，連接正常后，設(shè)備狀態(tài)為online。

4.8 簽名

在Phone/Tablet中運(yùn)行應(yīng)用/服務(wù)，需要根據(jù)提前對應(yīng)用/服務(wù)進(jìn)行簽名。

選擇菜單依次點(diǎn)擊 File->Project Struture->Project->default->Signing Configs，勾選上 Automatically generate signing，點(diǎn)擊 Apply，可以發(fā)現(xiàn)在根目錄的 build-profile.json5 中已經(jīng)生成了 signingConfigs 簽名配置。

4.9 運(yùn)行應(yīng)用

在菜單欄中，單擊Run>Run'模塊名稱'，或使用默認(rèn)快捷鍵Shift+F10（macOS為Control+R）運(yùn)行應(yīng)用/服務(wù)。

本機(jī)運(yùn)行結(jié)果

至此，我們就完成了第一個小項(xiàng)目。

更多有關(guān)OpenHarmony的信息，大家可以到官網(wǎng)查看相關(guān)的手冊和資料。

OpenHarmony開發(fā)者論壇

HarmonyOS應(yīng)用開發(fā)官網(wǎng) - 華為HarmonyOS打造全場景新服務(wù)。

五.常見問題（FAQ）

5.1在本機(jī)運(yùn)行時產(chǎn)生如下報錯

參考解決方案：重新對應(yīng)用/服務(wù)進(jìn)行簽名。

5.2Node.js下載出錯

參考解決方案：下載路徑選擇空文件夾。

5.3 usb連接識別不到本機(jī)

參考解決方案：可以通過hdc list targets指令和燒錄工具查看是否識別到設(shè)備。如果識別到了設(shè)備，可以再去設(shè)備管理器檢查驅(qū)動，檢查DevCo Studio環(huán)境。如果沒有識別到設(shè)備，可以嘗試重新燒錄系統(tǒng)。