全局配置

小程序根目录下的 app.json 文件用于对小程序的进行全局配置。文件内容为一个 JSON 对象,有以下属性

键值 说明
id 小程序 ID,作为小程序唯一标识,由小程序平台统一分配
name 小程序名称
start 小程序默认启动页面路径(首页),默认为 index.html
jssdk 基础库版本号
support 小程序支持的容器终端类型列表,值为数组,可选值为:mobile 支持移动端小程序、desktop 支持桌面端小程序 。包含以下三种情况:
(1)当值为["mobile"]时,表示仅支持移动端小程序,此时小程序源包限制 2M。
(2)当值为["desktop"]时,表示仅支持桌面端的小程序,此时小程序资源包限制 8M。
(3)当值为["mobile", "desktop"]时,表示同时支持移动端小程序桌面端小程序,此时小程序资源包同样限制为 2M。
pages 配置页面路径
window 全局默认框架表现

pages

用于配置小程序用到的所有页面路径,配置每项是 路径 + 文件名 这F个结构。配置项的第一个页面路径就是小程序启动展示的第一个页面。

如开发目录如下:

├── pages
│ │── home
│ │ ├── index.css
│ │ ├── index.html
│ │ ├── index.js
│ │ └── index.json
│ │── about
│ │ ├── index.css
│ │ ├── index.html
│ │ ├── index.js
│ │ └── index.json
├── app.css
├── app.js
├── app.json
├── project.config.json

那么 app.json 应该这样配置:

{
"pages": ["pages/home/index", "pages/about/index"]
}

注意:保证单个页面的 .html.css.js.json 资源都放在每个页面路径的首层。

window

用于设置小程序的状态栏、导航条、标题、窗口背景色。

键值 说明
navigationBar 用于设置小程序的状态栏的 UI 配置
        textColor 导航栏标题颜色,值为十六进制颜色值
        backgroundColor 导航栏背景颜色,值为十六进制颜色值
        titleText 导航栏标题文字
        showHistoryBack 是否显示返回按钮,值为 truefalse

示例代码

以下为 app.json 的配置示例

{
"id": "e2921eed",
"name": "云冲印",
"jssdk": "1.2.1",
"start": "index.html",
"support": ["mobile", "desktop"],
"pages": ["pages/home/index", "pages/about/index"],
"window": {
"navigationBar": {
"textColor": "#000000",
"backgroundColor": "#ffffff",
"titleText": "云冲印",
"showHistoryBack": false
}
}
}
  1. 1. 全局配置
    1. 1.1. pages
    2. 1.2. window
    3. 1.3. 示例代码