工程管理

DevEco Studio的基本使用，請參考[DevEco Studio使用指南]。本章主要介紹如何使用DevEco Studio進(jìn)行多設(shè)備應(yīng)用開發(fā)。

說明： 本章的內(nèi)容基于DevEco Studio 3.1.1 Release版本進(jìn)行介紹，如您使用DevEco Studio其它版本，可能存在文檔與產(chǎn)品功能界面、操作不一致的情況，請以實(shí)際功能界面為準(zhǔn)。
開發(fā)前請熟悉鴻蒙開發(fā)指導(dǎo)文檔：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]

工程創(chuàng)建

參考[創(chuàng)建系統(tǒng)工程]，先創(chuàng)建出最基本的項(xiàng)目工程。可以看到DevEco Studio創(chuàng)建出的默認(rèn)工程，僅包含一個的entry類型的模塊。

如果直接使用如下所示的平級目錄進(jìn)行模塊管理，工程邏輯結(jié)構(gòu)較混亂且模塊間的依賴關(guān)系不夠清晰，不利于開發(fā)及后期維護(hù)。

/application
├── common
├── feature1
├── feature2
├── featureN
├── wearable
├── default
└── productN

更推薦使用本文[部署模型]小節(jié)中介紹的common、features、product三層工程結(jié)構(gòu)。工程結(jié)構(gòu)示例如下所示：

/application
 ├── common                  # 公共特性目錄
 │
 ├── features                # 功能模塊目錄
 │   ├── feature1            # 子功能
 │   ├── feature2            # 子功能2
 │   └── ...                 # 子功能n
 │
 └── product                 # 產(chǎn)品層目錄
     ├── wearable            # 智能穿戴泛類目錄
     ├── default             # 默認(rèn)設(shè)備泛類目錄
     └── ...

接下來將依次介紹如何新建Module、修改配置文件以及調(diào)整目錄，以實(shí)現(xiàn)“一多”推薦的“三層工程結(jié)構(gòu)”。

新建Module

參考[開發(fā)ohpm包])，新建三個ohpm模塊，分別命名為common、feature1、feature2。參考[添加/刪除Module]，新建一個entry類型的模塊，假設(shè)命名為“wearable”（僅僅為了說明某一類產(chǎn)品）。示例如下：

說明：

• 在一個工程中同一個設(shè)備類型只支持一個Entry類型的模塊。
• 在下一個小節(jié)，我們將介紹如何修改Module的配置，包括Module的類型以及其支持的設(shè)備類型等。

修改Module配置

修改Module名稱

修改創(chuàng)建工程時默認(rèn)的entry模塊名稱。在該模塊上點(diǎn)擊鼠標(biāo)右鍵，依次選擇”Refactor -> Rename”，將名稱修改為default。

修改Module類型及其設(shè)備類型

通過修改每個模塊中的配置文件（module.json5）對模塊進(jìn)行配置，配置文件中各字段含義詳見[配置文件說明]。

• 將default模塊的deviceTypes配置為["default", "tablet"]，同時將其type字段配置為entry。
  即default模塊編譯出的HAP在默認(rèn)設(shè)備和平板上安裝和運(yùn)行。
  
• 將wearable模塊的deviceTypes配置為["wearable"]，同時將其type字段配置為entry。 即wearable模塊編譯出的HAP僅在智能穿戴設(shè)備上安裝和運(yùn)行。
  

調(diào)整目錄結(jié)構(gòu)

調(diào)整目錄結(jié)構(gòu)

在工程根目錄（MyApplication）上點(diǎn)擊鼠標(biāo)右鍵，依次選擇“New -> Directory”新建子目錄。創(chuàng)建product和features兩個子目錄。

用鼠標(biāo)左鍵將default目錄拖拽到新建的product目錄中，在IDE彈出的確認(rèn)窗口中，點(diǎn)擊“Refactor”即可。

按照同樣的步驟，將wearable目錄放到product目錄中，將feature1和feature2放到features目錄中。

修改依賴關(guān)系

回顧之前小節(jié)中關(guān)于“工程結(jié)構(gòu)”的介紹，我們推薦在common目錄中存放基礎(chǔ)公共代碼，features目錄中存放相對獨(dú)立的功能模塊代碼，product目錄中存放完全獨(dú)立的產(chǎn)品代碼。這樣在product目錄中依賴features和common中的公共代碼來實(shí)現(xiàn)功能，可以最大程度實(shí)現(xiàn)代碼復(fù)用。

配置依賴關(guān)系可以通過修改模塊中的oh-package.json文件。如下圖所示，通過修改default模塊中的oh-package.json文件，使其可以使用common、feature1和feature2模塊中的代碼。

同樣的，修改feature1和feature2模塊中的oh-package.json文件，使其可以使用common模塊中的代碼。

修改oh-package.json文件后，請點(diǎn)擊右上角的“Sync Now”，否則改動不會生效。

引用ohpm包中的代碼

在[開發(fā)ohpm包]中，僅介紹了如何使用ohpm包中的頁面和資源，本小節(jié)以例子的形式補(bǔ)充介紹如何使用ohpm包中的類和函數(shù)。

示例如下：

• 在common模塊中新增ComplexNumber類，用于表征復(fù)數(shù)（數(shù)學(xué)概念，由實(shí)部和虛部組成），該類包含toString()方法，將復(fù)數(shù)轉(zhuǎn)換為字符形式。
• 在common模塊中新增Add函數(shù)，用于計算并返回兩個數(shù)字的和。
• 在default模塊中，使用common模塊新增的ComplexNumber類和Add函數(shù)。

1. 在”common/src/main/ets”目錄中，按照需要新增文件和自定義類和函數(shù)。
2. 在”common/index.ets”文件中，申明需要export的類、函數(shù)的名稱及在當(dāng)前模塊中的位置，否則其它模塊無法使用。
3. 在default模塊中import和使用這些類和函數(shù)。注意提前在default模塊的oh-package.json文件中配置對common模塊的依賴關(guān)系。

說明：
HarmonyOS與OpenHarmony鴻蒙文檔籽料：mau123789是v直接拿
如果需要將ohpm包發(fā)布供其他開發(fā)者使用，具體可參考[發(fā)布o(jì)hpm包]。

審核編輯 黃宇