1.6　應用工程結構介紹

本節(jié)介紹應用工程結構及各個配置文件的含義。

1.6.1　工程級目錄

工程的目錄結構如圖1-31所示。

詳細說明如下：

·　AppScope中存放應用全局所需要的資源文件。

·　entry是應用的主模塊，存放HarmonyOS應用的代碼、資源等。

·　node_modules是工程的依賴包，存放工程依賴的源文件。

·　build-profile.json5是工程級配置信息，包括簽名、產品配置等。

·　hvigorfile.ts是工程級編譯構建任務腳本，Hvigor是基于任務管理機制實現(xiàn)的一款全新的自動化構建工具，主要提供任務注冊編排、工程模型管理、配置管理等核心能力。

·　package.json是工程級依賴配置文件，用于記錄引入包的配置信息。

在AppScope中還有resources文件夾和配置文件app.json5。

在AppScope中的resources文件夾下的base中包含element和media兩個文件夾。其中element文件夾主要存放公共的字符串、布局文件等資源；media文件夾存放全局公共的多媒體資源文件。

1.6.2　entry模塊級目錄

entry模塊級目錄如圖1-32所示。

entry下的src目錄中主要包含總的main文件夾、單元測試目錄ohosTest以及模塊級的配置文件。

·　在main文件夾中，ets文件夾用于存放ets代碼，resources文件夾用于存放模塊內的多媒體及布局文件等，module.json5文件為模塊的配置文件。

·　ohosTest是單元測試目錄。

·　build-profile.json5是模塊級配置信息，包括編譯構建配置項。

·　hvigorfile.ts文件是模塊級構建腳本。

·　package.json是模塊級依賴配置信息文件。

進入src→main→ets目錄，如圖1-33所示。其分為entryability和pages兩個文件夾。entryability存放Ability文件，用于當前Ability應用邏輯和生命周期管理；pages存放UI界面相關代碼文件，初始會生產一個Index頁面。

resources目錄下存放模塊公共的多媒體、字符串及布局文件等資源，分別存放在element、media文件夾中，如圖1-34所示。

1.6.3　配置文件

1　app.json5

AppScope下的app.json5是應用的全局配置文件，用于存放應用公共的配置信息。

其中配置信息如下：

·　bundleName是包名。

·　vendor是應用程序供應商。

·　versionCode用于區(qū)分應用的版本。

·　versionName是版本號。

·　icon是應用的顯示圖標。

·　label是應用名。

·　distributedNotificationEnabled描述應用程序是否已分發(fā)通知。

2　module.json5

依次打開entry→src→main文件夾，其下的module.json5是模塊的配置文件，包含當前模塊的配置信息。

其中module對應的是模塊的配置信息，一個模塊對應一個打包后的HAP（HarmonyOS Ability Package），其中包含Ability、第三方庫、資源和配置文件。其具體屬性及其描述如表1-1所示。

3　main_pages.json

依次打開src→main→resources→base→profile文件夾，其下的main_pages.json文件保存的是頁面page的路徑配置信息，所有需要進行路由跳轉的page頁面都要在這里進行配置。