1# 文件组织 2<!--Kit: ArkUI--> 3<!--Subsystem: ArkUI--> 4<!--Owner: @xiang-shouxing--> 5<!--Designer: @xiang-shouxing--> 6<!--Tester: @sally__--> 7<!--Adviser: @HelloCrease--> 8 9## 目录结构 10 11JS FA应用的JS模块（entry/src/main/js/module）的典型开发目录结构如下： 12 13**图1** 目录结构 14 15 16 17**图2** [多实例](../application-models/pageability-launch-type.md)资源共享目录结构 18 19 20 21目录结构中文件分类如下： 22 23- .hml结尾的HML模板文件，描述当前页面的文件布局结构。 24 25- .css结尾的CSS样式文件，描述页面样式。 26 27- .js结尾的JS文件，处理页面间的交互。 28 29各个文件夹的作用： 30 31- app.js文件用于全局JavaScript逻辑和应用生命周期管理，详见[app.js](js-framework-js-file.md)。 32 33- pages目录用于存放所有组件页面。 34 35- common目录用于存放公共资源文件，比如：媒体资源，自定义组件和JS文件。 36 37- resources目录用于存放资源配置文件，比如：多分辨率加载等配置文件，详见[资源限定与访问](js-framework-resource-restriction.md)章节。 38 39- share目录用于配置多个实例共享的资源内容，比如：share中的图片和JSON文件可被default1和default2实例共享。 40 41> **说明：** 42> 43> - i18n和resources文件夹不可重命名。 44> 45> 46> - 如果share目录中的资源和实例(default)中的资源文件同名且目录一致时，实例中资源的优先级高于share中资源的优先级。 47> 48> 49> - share目录当前不支持i18n。 50> 51> - 在使用DevEco Studio进行应用开发时，目录结构中的可选文件夹需要开发者根据实际情况自行创建。 52 53 54## 文件访问规则 55 56应用资源可通过绝对路径或相对路径的方式进行访问，绝对路径以"/"开头，相对路径以"./"或"../"。具体访问规则如下： 57 58- 引用代码文件，推荐使用相对路径，比如：../common/utils.js。 59 60- 引用资源文件，推荐使用绝对路径。比如：/common/xxx.png。 61 62- 公共代码文件和资源文件推荐放在common下，通过以上两条规则进行访问。 63 64- CSS样式文件中通过url()函数创建<url>数据类型，如：url(/common/xxx.png)。 65 66> **说明：** 67> 当代码文件A需要引用代码文件B时： 68> 69> - 如果代码文件A和文件B位于同一目录，则代码文件B引用资源文件时可使用相对路径，也可使用绝对路径。 70> 71> - 如果代码文件A和文件B位于不同目录，则代码文件B引用资源文件时必须使用绝对路径。因为Webpack打包时，代码文件B的目录会发生变化。 72> 73> 74> - 在js文件中通过数据绑定的方式指定资源文件路径时，必须使用绝对路径。 75 76 77## 媒体文件格式 78 79**表1** 支持的图片格式 80 81| 格式 | 支持的文件类型 | 82| ---- | ------- | 83| BMP | .bmp | 84| GIF | .gif | 85| JPEG | .jpg | 86| PNG | .png | 87| WebP | .webp | 88 89**表2** 支持的视频格式 90 91| 格式 | 支持的文件类型 | 92| ---------------------------------------- | ------------- | 93| H.264 AVC<br/>Baseline Profile (BP) | .3gp<br/>.mp4 | 94
