目录结构
小程序包含一个描述整体程序的 app 和多个描述各自页面的 page。
小程序目录结构
.
├── images       // 小程序资源默认路径文件,建议将图片等资源都放在这个目录下,读取时使用 /images/xxx.png 形式绝对路径读取
├── pages       // 小程序的页面
│   ├── index.css      // 小程序的页面的样式
│   ├── index.dlt      // 小程序的页面模板
│   ├── index.js       // 小程序的页面逻辑
│   └── index.json     // 小程序的页面配置
├── app.css    // 小程序全局样式
├── app.js     // 小程序全局 js 逻辑
└── app.json   // 小程序全局配置
主体组成
一个小程序主体部分由三个文件组成,必须放在项目的根目录,如下:
| 文件 | 必需 | 作用 | 
|---|---|---|
| app.js | 是 | 小程序逻辑 | 
| app.json | 是 | 小程序公共配置 | 
| app.css | 否 | 小程序公共样式表 | 
页面组成
一个小程序页面由四个文件组成,分别是:
| 文件 | 必需 | 作用 | 
|---|---|---|
| js | 是 | 页面逻辑 | 
| dlt | 是 | 页面结构 | 
| json | 否 | 页面配置 | 
| css | 否 | 页面样式表 | 
注意:为了方便开发者减少配置项,描述页面的四个文件必须具有相同的路径与文件名。
资源文件夹 images
项目内的图片、视频等资源建议放在项目根目录下 images 目录下,取用资源时的目录用根目录路径 images/xxx.png。
允许上传的文件
在项目目录中,以下文件会经过编译,因此上传之后无法直接访问到:.js、app.json、.dlt、*.css(其中 dlt 和 css 文件仅针对在 app.json 中配置了的页面)。除此之外,只有后缀名在白名单内的文件可以被上传,不在白名单列表内文件在开发工具能被访问到,但无法被上传。具体白名单列表如下:
- png
 - jpg
 - jpeg
 - gif
 - svg
 - json
 - cer
 - mp3
 - aac
 - m4a
 - mp4
 - wav
 - ogg
 - silk
 - wasm
 - br
 - cert