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

一. OpenHarmony簡(jiǎn)介

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

1.2二.工具簡(jiǎn)介

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

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

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

三.環(huán)境搭建

3.1 下載安裝DevEco Studio

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

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

這里全部勾選即可。

完成后選擇第二個(gè)，在桌面上啟動(dòng)DevEco Studio。

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

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

首次使用，請(qǐng)選擇Do not import settings，單擊OK。3.33.4.5

3.2.2

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

說(shuō)明：如果配置向?qū)Ы缑娉霈F(xiàn)的是設(shè)置Set up HTTP Proxy界面，說(shuō)明網(wǎng)絡(luò)受限，請(qǐng)根據(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；對(duì)應(yīng)的npm版本要求為6.14.16及以上，且低于7.0.0版本）；如果本地沒(méi)有合適的版本，可以選擇Download按鈕，在線(xiàn)下載Node.js。本示例以下載Node.js為例，選擇下載源和存儲(chǔ)路徑后，單擊Next進(jìn)入下一步。

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

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

3.2.4

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

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

3.2.5

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

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

3.2.6

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

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

4.1

選擇模板

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

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

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

4.2 預(yù)覽界面

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

4.3增加頁(yè)面

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

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

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

4.4增加交互按鈕

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

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

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

點(diǎn)擊預(yù)覽，即可通過(guò)按鈕完成頁(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端在同一個(gè)網(wǎng)段，建議將Phone/Tablet和PC連接到同一個(gè)WLAN下。

4.6使用USB連接方式

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

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

4.7使用IP Connection連接方式

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

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

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

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ù)提前對(duì)應(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'模塊名稱(chēng)'，或使用默認(rèn)快捷鍵Shift+F10（macOS為Control+R）運(yùn)行應(yīng)用/服務(wù)。

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

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

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

OpenHarmony開(kāi)發(fā)者論壇

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

五.常見(jiàn)問(wèn)題（FAQ）

5.1在本機(jī)運(yùn)行時(shí)產(chǎn)生如下報(bào)錯(cuò)

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

5.2Node.js下載出錯(cuò)

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

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

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