快應(yīng)用 文件組織

應(yīng)用資源

一個(gè)應(yīng)用包含：描述項(xiàng)目配置信息的 manifest文件，放置項(xiàng)目公共資源腳本的 app.ux文件，多個(gè)描述頁面/自定義組件的 ux文件 ，典型示例如下：

應(yīng)用根目錄

├── manifest.json
├── app.ux
├── Page1
│   ├── page1.ux
├── Page2
│   ├── page2.ux
└── Common
    ├── ComponentA.ux
    ├── ComponentB.ux
    └── xxx.png

其中Common目錄下為公用的資源文件和組件文件，每個(gè)頁面目錄下存放各自頁面私有的資源文件和組件文件，如：圖片，CSS，JS等

文件存儲(chǔ)

在應(yīng)用平臺(tái)中是按分區(qū)來存儲(chǔ)文件的，目前支持以下分區(qū)

1. Cache，一般用于存儲(chǔ)緩存文件，比如通過fetch接口下載的文件會(huì)存儲(chǔ)在該分區(qū)中，該分區(qū)中的文件可能因存儲(chǔ)空間不夠被系統(tǒng)刪除
2. Files，一般用于存儲(chǔ)比較小的永久文件，該分區(qū)中的文件由應(yīng)用自己管理
3. Mass，一般用于存儲(chǔ)比較大的文件，但該分區(qū)并不保證一直可用
4. Temp，表示從外部映射過來的臨時(shí)文件，出于安全性考慮，臨時(shí)文件是只讀的，并且只能通過調(diào)用特定的API獲取，比如media.pickVideo方法。另外臨時(shí)文件的訪問是臨時(shí)的，應(yīng)用重啟后無法訪問到臨時(shí)文件，需要通過特定API重新獲取。

另外應(yīng)用資源也作為一個(gè)特殊的只讀分區(qū)進(jìn)行處理。

URI

URI 用于標(biāo)識應(yīng)用資源和文件，組件 和 接口 通過URI來訪問應(yīng)用資源和文件。

URI允許的字符是0-9a-zA-Z_-./%:(不包含引號)，URI中不能出現(xiàn)..，URI支持目錄結(jié)構(gòu)，目錄由斜線'/'分隔。

internal URI表示的是應(yīng)用私有文件，即在指定internal URI時(shí)，無需指定應(yīng)用標(biāo)識，同一個(gè)internal URI對于不同的應(yīng)用會(huì)指向不同的文件。

資源和文件訪問規(guī)則

應(yīng)用資源路徑分為絕對路徑和相對路徑，以"/"開頭的路徑表示絕對路徑，比如 /Common/a.png，不以"/"開頭的路徑是相對路徑，比如 a.png 和 ../Common/a.png 等。

應(yīng)用資源文件分為代碼文件和資源文件，代碼文件是指 .js/.css/.ux 等包含代碼的文件，其他文件則是資源文件，這類文件一般只當(dāng)作數(shù)據(jù)來使用，比如圖片、視頻等。

1. 在代碼文件中，導(dǎo)入其他代碼文件時(shí)，使用相對路徑，比如：../Common/component.ux。
2. 在代碼文件中，引用資源文件(如：圖片、視頻等)時(shí)，一般情況下使用相對路徑，比如： ./abc.png。
3. 當(dāng)代碼文件需要被導(dǎo)入時(shí)，如果導(dǎo)入文件與被導(dǎo)入文件在同一個(gè)目錄，被導(dǎo)入文件引用資源文件時(shí)可以使用相對路徑，但如果不在同一目錄，必須使用絕對路徑，因?yàn)楸粚?dǎo)入文件編譯時(shí)會(huì)被復(fù)制到導(dǎo)入文件中，編譯后目錄會(huì)發(fā)生變化。比如 a.css 文件被 b.ux 導(dǎo)入，如果 a.css 與 b.ux 在同一個(gè)目錄，a.css 引用資源文件時(shí)可以寫相對路徑：abc.png，如果不在同一個(gè)目錄，必須寫絕對路徑：/Common/abc.png，再比如當(dāng) a.ux 文件被 b.ux 文件導(dǎo)入時(shí)，如果 a.ux 與 b.ux 在同一個(gè)目錄，a.ux 引用資源文件時(shí)可以寫相對路徑：a.png，如果不在同一個(gè)目錄，a.ux 引用資源必須寫絕對路徑：/Common/abc.png。
4. 在CSS中，與前端開發(fā)一致，使用url(PATH)的方式訪問資源文件，如：url(/Common/abc.png)