鴻蒙OS 文件組織

文件組織

目錄結(jié)構(gòu)

JS FA應(yīng)用的 JS 模塊(entry/src/main/js/module)的典型開發(fā)目錄結(jié)構(gòu)如下：

圖1 目錄結(jié)構(gòu)

目錄結(jié)構(gòu)中文件分類如下：

• .hml結(jié)尾的HML模板文件，這個(gè)文件用來(lái)描述當(dāng)前頁(yè)面的文件布局結(jié)構(gòu)。
• .css結(jié)尾的CSS樣式文件，這個(gè)文件用于描述頁(yè)面樣式。
• .js結(jié)尾的JS文件，這個(gè)文件用于處理頁(yè)面和用戶的交互。

各個(gè)文件夾的作用：

• app.js文件用于全局JavaScript邏輯和應(yīng)用生命周期管理。
• pages目錄用于存放所有組件頁(yè)面。
• common目錄用于存放公共資源文件，比如：媒體資源，自定義組件和JS文件。
• resources目錄用于存放資源配置文件，比如：全局樣式、多分辨率加載等配置文件。
• i18n目錄用于配置不同語(yǔ)言場(chǎng)景資源內(nèi)容，比如應(yīng)用文本詞條，圖片路徑等資源。

說(shuō)明

i18n和resources是開發(fā)保留文件夾，不可重命名。

應(yīng)用資源訪問規(guī)則

應(yīng)用資源可通過絕對(duì)路徑或相對(duì)路徑的方式進(jìn)行訪問，本開發(fā)框架中絕對(duì)路徑以"/"開頭，相對(duì)路徑以"./"或"../"。具體訪問規(guī)則如下：

• 引用代碼文件，需使用相對(duì)路徑，比如：../common/utils.js。
• 引用資源文件，推薦使用絕對(duì)路徑。比如：/common/xxx.png。
• 公共代碼文件和資源文件推薦放在common下，通過規(guī)則1和規(guī)則2進(jìn)行訪問。
• CSS樣式文件中通過url()函數(shù)創(chuàng)建<url>數(shù)據(jù)類型，如：url(/common/xxx.png)。

說(shuō)明

當(dāng)代碼文件A需要引用代碼文件B時(shí)：

• 如果代碼文件A和文件B位于同一目錄，則代碼文件B引用資源文件時(shí)可使用相對(duì)路徑，也可使用絕對(duì)路徑。
• 如果代碼文件A和文件B位于不同目錄，則代碼文件B引用資源文件時(shí)必須使用絕對(duì)路徑。因?yàn)閃ebpack打包時(shí)，代碼文件B的目錄會(huì)發(fā)生變化。

存儲(chǔ)目錄定義

應(yīng)用使用文件存儲(chǔ)接口訪問文件時(shí)，可以通過使用特定scheme（只支持internal）來(lái)訪問預(yù)定義的一些文件存取目錄。對(duì)于不在下列目錄下的文件訪問將被拒絕（禁止使用../等方式訪問父目錄）。