"鸿蒙OS开发文档"的目录
鸿蒙OS开发文档 鸿蒙OS 文件组织
文件组织
目录结构
JS FA应用的 JS 模块(entry/src/main/js/module)的典型开发目录结构如下：
图1 目录结构 
目录结构中文件分类如下：
- .hml结尾的HML模板文件，这个文件用来描述当前页面的文件布局结构。
- .css结尾的CSS样式文件，这个文件用于描述页面样式。
- .js结尾的JS文件，这个文件用于处理页面和用户的交互。
各个文件夹的作用：
- app.js文件用于全局JavaScript逻辑和应用生命周期管理。
- pages目录用于存放所有组件页面。
- common目录用于存放公共资源文件，比如：媒体资源，自定义组件和JS文件。
- resources目录用于存放资源配置文件，比如：全局样式、多分辨率加载等配置文件。
- i18n目录用于配置不同语言场景资源内容，比如应用文本词条，图片路径等资源。
说明
i18n和resources是开发保留文件夹，不可重命名。
应用资源访问规则
应用资源可通过绝对路径或相对路径的方式进行访问，本开发框架中绝对路径以"/"开头，相对路径以"./"或"../"。具体访问规则如下：
- 引用代码文件，需使用相对路径，比如：../common/utils.js。
- 引用资源文件，推荐使用绝对路径。比如：/common/xxx.png。
- 公共代码文件和资源文件推荐放在common下，通过规则1和规则2进行访问。
- CSS样式文件中通过url()函数创建<url>数据类型，如：url(/common/xxx.png)。
说明
当代码文件A需要引用代码文件B时：
- 如果代码文件A和文件B位于同一目录，则代码文件B引用资源文件时可使用相对路径，也可使用绝对路径。
- 如果代码文件A和文件B位于不同目录，则代码文件B引用资源文件时必须使用绝对路径。因为Webpack打包时，代码文件B的目录会发生变化。
存储目录定义
应用使用文件存储接口访问文件时，可以通过使用特定scheme（只支持internal）来访问预定义的一些文件存取目录。对于不在下列目录下的文件访问将被拒绝（禁止使用../等方式访问父目录）。
| 目录类型 | 路径前缀 | 访问可见性 | 说明 |
|---|---|---|---|
| 临时目录 | internal://cache/ | 仅本应用可见 | 可读写，随时可能清除，不保证持久性。一般用作下载临时目录或缓存目录。 |
| 应用私有目录 | internal://app/ | 仅本应用可见 | 随应用卸载删除。 |
| 外部存储 | internal://share/ | 所有应用可见 | 随应用卸载删除。其他应用在有相应权限的情况下可读写此目录下的文件。 |