HarmonyOS APP工程結構

在進行HarmonyOS應用開發前，您應該掌握HarmonyOS應用的邏輯結構。

HarmonyOS應用釋出形態為APP Pack（Application Package，簡稱APP），它是由一個或多個HAP（HarmonyOS Ability Package）包以及描述APP Pack屬性的pack.info檔案組成。

一個HAP在工程目錄中對應一個Module，它是由程式碼、資源、第三方庫及應用清單檔案組成，可以分為Entry和Feature兩種型別。

Entry：應用的主模組。一個APP中，對於同一裝置型別必須有且只有一個entry型別的HAP，可獨立安裝執行。Feature：應用的動態特性模組。一個APP可以包含一個或多個feature型別的HAP，也可以不含。

HAP是Ability的部署包，HarmonyOS應用程式碼圍繞Ability元件展開，它是由一個或多個Ability組成。Ability分為兩種型別：FA（Feature Ability）和PA（Particle Ability）。FA/PA是應用的基本組成單元，能夠實現特定的業務功能。FA有UI介面，而PA無UI介面。

工程目錄結構Java工程目錄結構

Java工程目錄結構如下圖所示。

.gradle：Gradle配置檔案，由系統自動生成，一般情況下不需要進行修改。

entry：預設啟動模組（主模組），開發者用於編寫原始碼檔案以及開發資原始檔的目錄。entry>libs：用於存放entry模組的依賴檔案。entry>.gitgnore：標識git版本管理需要忽略的檔案。entry>build.gradle：entry模組的編譯配置檔案。entry>src>main>Java：用於存放Java原始碼。entry>src>main>resources：用於存放資原始檔。entry>src>main>config.json：HAP清單檔案，詳細說明請參考config.json清單檔案介紹。entry>src>test：編寫測試檔案的目錄。JS工程目錄結構

JS工程目錄結構如下圖所示。

pages目錄：pages資料夾下可以包含1個或多個頁面，每個頁面都需要建立一個資料夾（如圖中的index）。頁面資料夾下主要包含3種檔案型別：css、js和hml檔案。pages > index > index.hml檔案：hml檔案定義了頁面的佈局結構，使用到的元件，以及這些元件的層級關係。pages > index > index.css檔案：css檔案定義了頁面的樣式與佈局，包含樣式選擇器和各種樣式屬性等。pages > index > index.js檔案：js檔案描述了頁面的行為邏輯，此檔案裡定義了頁面裡所用到的所有的邏輯關係，比如資料、事件等。app.js檔案：全域性的JavaScript邏輯檔案和應用的生命週期管理。