當(dāng)我們熟練的掌握了DevEco Studio之后,就可以創(chuàng)建項(xiàng)目進(jìn)行練習(xí)了,和市場(chǎng)上大多數(shù)IDE一樣,DevEco Studio也給我們提供了很多的實(shí)例模板,當(dāng)然了,對(duì)于大多數(shù)移動(dòng)端開發(fā)者而言,這些模板和我們的UI設(shè)計(jì)有著很大的出入,一般都會(huì)選擇一個(gè)空的視圖作為項(xiàng)目,方便我們從0到1進(jìn)行開發(fā)。

點(diǎn)擊下一步,就進(jìn)入到了項(xiàng)目信息編輯頁(yè)面,作為一名Android開發(fā)者,對(duì)這個(gè)頁(yè)面簡(jiǎn)直不要太熟悉,無(wú)非就是項(xiàng)目的名字,包名,SDK版本的選擇等等。

有兩項(xiàng)是我們需要注意的,第一項(xiàng),Model的選擇,也就是應(yīng)用模型,目前隨著HarmonyOS的發(fā)展,提供了兩種應(yīng)用模型,一種是Stage模型,一種是FA模型,目前,官方主推的是Stage模型,我們?cè)趧?chuàng)建項(xiàng)目的時(shí)候,也是默認(rèn)的這種模型,它是在,HarmonyOS 3.1 Develper Preview版本開始新增的模型,是目前主推且會(huì)長(zhǎng)期演進(jìn)的模型,在該模型中,由于提供了AbilityStage、WindowStage等類作為應(yīng)用組件和Window窗口的“舞臺(tái)”,因此稱這種應(yīng)用模型為Stage模型。
關(guān)于Stage模型,官方有著很詳細(xì)的介紹,這里就不多說(shuō)了。
還有一項(xiàng)需要注意的,Enable Super Visual選項(xiàng),也就是是否要啟動(dòng)低代碼作為模板,選擇之后,你就可以在項(xiàng)目中拖拽實(shí)現(xiàn)想要的頁(yè)面,類似Android Studio中的Xml中的Design選項(xiàng)。

以上的部分只是前言,闡述了項(xiàng)目創(chuàng)建前的一些注意事項(xiàng),在講述工程結(jié)構(gòu)之前,我們需要對(duì)HarmonyOS的UI開發(fā)框架ArkUI做一個(gè)簡(jiǎn)單的了解。
今天的文章內(nèi)容,大致如下:
1、ArkUI框架的簡(jiǎn)單闡述
2、Stage模型下的ArkTS工程目錄結(jié)構(gòu)
3、與Android項(xiàng)目結(jié)構(gòu)對(duì)比
4、相關(guān)總結(jié)
一、ArkUI框架的簡(jiǎn)單闡述
為什么要在工程結(jié)構(gòu)之前闡述ArkUI這個(gè)UI框架?主要原因只有一個(gè),就是為以后的項(xiàng)目創(chuàng)建做好鋪墊,首先我們來(lái)搞清楚前因后果。
ArkUI框架,既是方舟開發(fā)框架,它是HarmonyOS提供了一套UI開發(fā)框架,和Flutter與SwiftUI有著異曲同工的角色,你可以使用Flutter語(yǔ)言開發(fā)出Android、iOS等平臺(tái)的應(yīng)用,也可以使用SwiftUI開發(fā)出iOS端的應(yīng)用,同理,HarmonyOS端的應(yīng)用,如何開發(fā)呢,可以使用ArkUI。
針對(duì)不同目的和技術(shù)背景,ArkUI提供了兩種開發(fā)方式,一種是基于ArkTS的聲明式開發(fā)方式,這個(gè)方式和Flutter與SwiftUI很相似,也就是說(shuō),如果你之前了解過(guò)Flutter與SwiftUI,那么使用這種方式,再方便不過(guò);還有一種是兼容JS的類Web開發(fā)方式,言外之意,這種方式允許你用前端語(yǔ)言,也就是經(jīng)典的HML、CSS、JavaScript來(lái)開發(fā)應(yīng)用。
| 開發(fā)方式名稱 | 語(yǔ)言生態(tài) | UI更新方式 | 適用場(chǎng)景 | 適用人群 |
|---|---|---|---|---|
| 聲明式開發(fā)范式 | ArkTS語(yǔ)言 | 數(shù)據(jù)驅(qū)動(dòng)更新 | 復(fù)雜度較大、團(tuán)隊(duì)合作度較高的程序 | 移動(dòng)系統(tǒng)應(yīng)用開發(fā)人員、系統(tǒng)應(yīng)用開發(fā)人員 |
| 類Web開發(fā)范式 | JS語(yǔ)言 | 數(shù)據(jù)驅(qū)動(dòng)更新 | 界面較為簡(jiǎn)單的程序應(yīng)用和卡片 | Web前端開發(fā)人員 |
作為移動(dòng)端應(yīng)用的開發(fā)者,考慮到性能,復(fù)雜度高,開發(fā)效率和發(fā)展趨勢(shì)而言,聲明式開發(fā)方式,絕對(duì)是我們的首選方式,當(dāng)然了,官方也是主推這種方式,官方推薦的原因如下:
開發(fā)效率:聲明式開發(fā)范式更接近自然語(yǔ)義的編程方式,開發(fā)者可以直觀地描述UI,無(wú)需關(guān)心如何實(shí)現(xiàn)UI繪制和渲染,開發(fā)高效簡(jiǎn)潔。
應(yīng)用性能:如下圖所示,兩種開發(fā)范式的UI后端引擎和語(yǔ)言運(yùn)行時(shí)是共用的,但是相比類Web開發(fā)范式,聲明式開發(fā)范式無(wú)需JS框架進(jìn)行頁(yè)面DOM管理,渲染更新鏈路更為精簡(jiǎn),占用內(nèi)存更少,應(yīng)用性能更佳。

發(fā)展趨勢(shì):聲明式開發(fā)范式后續(xù)會(huì)作為主推的開發(fā)范式持續(xù)演進(jìn),為開發(fā)者提供更豐富、更強(qiáng)大的能力。
所以在以后的項(xiàng)目開發(fā)中,第一,基于ArkTS的聲明式開發(fā)方式,第二,采用Stage模型,原因只有一個(gè),基于性能和未來(lái)的發(fā)展趨勢(shì),如果這個(gè)原因還不夠,那就拿官方推薦作為原因,絕對(duì)好使!
至于ArkTS,后續(xù)的文章慢慢講述吧,一步一步來(lái),循序漸進(jìn)。
二、Stage模型下的ArkTS工程目錄結(jié)構(gòu)
不要被一些名詞給唬住了,我們默認(rèn)創(chuàng)建的就是基于Stage模型下的ArkTS工程目錄結(jié)構(gòu),創(chuàng)建完畢之后,窗口如下:

和AndroidStudio不能說(shuō)一模一樣,但也是十分有九分的雷同,具體的各個(gè)功能就不多贅述,我們直接看左側(cè)的目錄結(jié)構(gòu):

我們從上往下一一進(jìn)行解析:
.hvigor:存儲(chǔ)構(gòu)建配置文件信息。
.idea:存儲(chǔ)項(xiàng)目的配置信息。
AppScope:全局的共有資源存放目錄。
resources:用于存放應(yīng)用/服務(wù)所用到的資源文件,如圖形、多媒體、字符串、布局文件等。
base>element:包括字符串、整型數(shù)、顏色、樣式等資源的json文件。每個(gè)資源均由json格式進(jìn)行定義
boolean.json:布爾型
color.json:顏色
float.json:浮點(diǎn)型
intarray.json:整型數(shù)組
integer.json:整型
pattern.json:樣式
plural.json:復(fù)數(shù)形式
strarray.json:字符串?dāng)?shù)組
string.json:字符串值
base>media:多媒體文件,如圖形、視頻、音頻等文件,支持的文件格式包括:.png、.gif、.mp3、.mp4等。
rawfile :用于存儲(chǔ)任意格式的原始資源文件。rawfile不會(huì)根據(jù)設(shè)備的狀態(tài)去匹配不同的資源,需要指定文件路徑和文件名進(jìn)行引用。
app.json5:應(yīng)用的全局配置信息。
entry:HarmonyOS工程模塊,編譯構(gòu)建生成一個(gè)HAP包。
src > main > ets:用于存放ArkTS源碼。
entryability:應(yīng)用/服務(wù)的入口。
pages:應(yīng)用/服務(wù)包含的頁(yè)面。
src > main > resources:用于存放應(yīng)用/服務(wù)所用到的資源文件,如圖形、多媒體、字符串、布局文件等,和上面的共享目錄是一致的。
src > main > module.json5:Stage模型模塊配置文件。主要包含HAP包的配置信息、應(yīng)用/服務(wù)在具體設(shè)備上的配置信息以及應(yīng)用/服務(wù)的全局配置信息。
build-profile.json5:當(dāng)前的模塊信息、編譯信息配置項(xiàng),包括buildOption、targets配置等。其中targets中可配置當(dāng)前運(yùn)行環(huán)境,默認(rèn)為HarmonyOS。
hvigorfile.ts:模塊級(jí)編譯構(gòu)建任務(wù)腳本,開發(fā)者可以自定義相關(guān)任務(wù)和代碼實(shí)現(xiàn)。
hvigor:構(gòu)建配置文件信息,是一款全新基于TS實(shí)現(xiàn)的前端構(gòu)建任務(wù)編排工具,結(jié)合npm包管理機(jī)制,主要提供任務(wù)管理機(jī)制,任務(wù)注冊(cè)編排、工程模型管理、配置管理等關(guān)鍵能力,更符合ArkTS/JS開發(fā)者的開發(fā)習(xí)慣。
oh_modules:用于存放三方庫(kù)依賴信息。
gitignore:git過(guò)濾配置。
build-profile.json5:應(yīng)用級(jí)配置信息,包括簽名、產(chǎn)品配置等。
hvigorfile.ts:應(yīng)用級(jí)編譯構(gòu)建任務(wù)腳本。
hvigorw和hvigorw.bat:ohpm編譯構(gòu)建工具。
local.properties:存儲(chǔ)本地屬性的文件。
oh-package.json5:依賴配置,可以設(shè)置三方包依賴。
可以說(shuō),以上的目錄結(jié)構(gòu)介紹,全網(wǎng)甚至是官網(wǎng),也沒(méi)有這么的詳細(xì),為什么要對(duì)目錄結(jié)構(gòu)過(guò)多的進(jìn)行闡述,目的只有一個(gè),更好的了解項(xiàng)目,可以針對(duì)性且快速的進(jìn)入到開發(fā)之中。
三、與Android項(xiàng)目結(jié)構(gòu)對(duì)比
或許,第一次直接的查看這樣的一個(gè)工程目錄,確實(shí)需要一段時(shí)間的了解,才能知道各個(gè)文件的作用,為了更加直觀明了的讓一名Android開發(fā)者快速的知道每個(gè)文件對(duì)應(yīng)的含義,接下來(lái)將會(huì)按照Android工程的目錄結(jié)構(gòu)和Stage模型下的ArkTS工程目錄結(jié)構(gòu),進(jìn)行一一對(duì)應(yīng),希望可以有所幫助,當(dāng)然了,如果你不是一名Android開發(fā)者,這個(gè)步驟可以掠過(guò),仔細(xì)的查看第二步的介紹即可。
整體的對(duì)照
左側(cè)是HarmonyOS項(xiàng)目,右側(cè)是Android項(xiàng)目,具體的對(duì)照?qǐng)D如下所示:

主要文件對(duì)應(yīng)
| Android文件 | HarmonyOS文件 |
|---|---|
| 清單文件AndroidManifest.xml | module.json5 |
| Activity/Fragment | entryability下的ts文件 |
| XML布局 | pages下的ets文件 |
| res | resources |
| Module下的build.gradle | Module下的build-profile.json5 |
| gradle | hvigor |
| 根目錄下的build.gradle | 根目錄下的build-profile.json5 |
| colors.xmldimens.xmlstrings.xml…… | color.json:顏色float.json:浮點(diǎn)型string.json:字符串值…… |
四、相關(guān)總結(jié)
通過(guò)對(duì)工程結(jié)構(gòu)的了解,對(duì)于我們步入HarmonyOS的開發(fā),有著指引的作用,能夠清晰的知道各個(gè)文件及文件夾的作用,在哪里書寫代碼,又是在哪里添加資源,能夠有一個(gè)直觀的定位,特別是,不是從Android開發(fā)者轉(zhuǎn)過(guò)來(lái)的同學(xué),對(duì)于工程結(jié)構(gòu)更應(yīng)該及時(shí)的了解。