# 文件组织

# 应用资源

一个应用包含:描述项目配置信息的manifest 文件,放置项目公共资源脚本的app.ux 文件,多个描述页面的ux 文件,典型示例如下:

应用根目录

├── manifest.json
├── app.ux
├── page1
│   ├── index.ux
├── page2
│   ├── index.ux
└── common
    ├── xxx.png
    └── xxx.css

其中 common 目录下为公用的资源文件,如:图片,CSS,JS 等

# 应用资源访问规则

应用资源路径分为绝对路径和相对路径,以"/"开头的路径表示绝对路径,比如 /common/a.png,不以"/"开头的路径是相对路径,比如 a.png 和 ../common/a.png 等。

应用资源文件分为代码文件和资源文件,代码文件是指 .js/.css/.ux 等包含代码的文件,其他文件则是资源文件,这类文件一般只当作数据来使用,比如图片、音频等。

在代码文件中,导入其他代码文件时,使用相对路径,比如:../common/style.css。 在代码文件中,引用资源文件(如:图片、音频等)时,推荐使用绝对路径。比如:/common/a.png。 在 CSS 中,与前端开发一致,使用 url(PATH)的方式访问资源文件,如:url(/common/a.png)

# 存储目录定义

应用使用文件存储接口访问文件时,可以通过使用特定scheme(只支持internal)来访问预定义的一些文件存取目录。对于不在下列目录下的文件访问将被拒绝(禁止使用../等方式访问父目录)。

目录类型 路径前缀 访问可见性 说明
应用私有目录 internal://app/ 仅本应用可见 随应用卸载删除。