全局配置

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

#1. 配置项

#entryPagePath

指定小程序的默认启动路径（首页），如果不填，将默认为 pages 列表的第一项。不支持带页面路径参数。

#pages

用于指定小程序由哪些页面组成，每一项都对应一个页面的 路径（含文件名） 信息。文件名不需要写文件后缀，框架会自动去寻找对应位置的 .json, .js, .fxml, .ftss 四个文件进行处理。

未指定 entryPagePath 时，数组的第一项代表小程序的初始页面（首页）。

小程序中新增/减少页面，都需要对 pages 数组进行修改。

如开发目录为：

├── app.js
├── app.json
├── app.ftss
├── pages
│   │── index
│   │   ├── index.fxml
│   │   ├── index.js
│   │   ├── index.json
│   │   └── index.ftss
│   └── logs
│       ├── logs.fxml
│       └── logs.js
└── utils
        已复制代码

则需要在 app.json 中写

{
  "pages": ["pages/index/index", "pages/logs/logs"]}
        已复制代码

#window

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

#tabBar

tabBar 用来配置小程序底部或者顶部的 tab 导航栏的样式以及跳转的页面等。

详细配置项如下：

其中 list 是数组类型，只能配置最少2个、最多5个 tab。

tab 按数组的顺序排序，每个项都是一个独立的对象，其可配置值如下：

#networkTimeout

各类网络请求的超时时间，单位均为毫秒。

#debug

布尔类型，当配置为true时，扫码后，小程序中会增加一个信息查看按钮 vconsole，方便开发者查看日志(已废弃)

可以通过:

1、通过调用小程序api(ft.setEnableDebug)来开启Debug模式。

2、非线上版本(比如体验版、审核版、开发版、预览版)可在 更多菜单中通过【打开调试】开启Debug模式。

#subpackages

启用分包加载时，声明项目分包结构。

#plugins

声明小程序需要使用的插件。

#preloadRule

声明分包预-的规则。

#resizable

在 iPad 上运行的小程序可以设置支持屏幕旋转。

在 PC 上运行的小程序，用户可以按照任意比例拖动窗口大小，也可以在小程序菜单中最大化窗口

#usingComponents

在app.json中声明的自定义组件视为全局自定义组件，在小程序内的页面或自定义组件中可以直接使用而无需再声明。

注意：全局声明的自定义组件会视为被所有页面依赖，会在所有页面启动时进行初始化，且会占用主包大小。只被个别页面或分包引用的自定义组件应尽量在页面配置中声明。

#style

由于微信客户端 7.0 开始，UI 界面进行了大改版。小程序也进行了基础组件的样式升级。app.json 中配置 "style": "v2"可表明启用兼容微信新版的组件样式。

本次改动涉及的组件有

• button

• icon

• radio

• checkbox

• switch

• slider

#useExtendedLib

指定需要引用的扩展库。目前支持以下项目：

指定后，相当于引入了对应扩展库相关的最新版本的 npm 包，同时也不占用小程序的包体积。用法如下：

{
  "useExtendedLib": {
    "kbone": true,
    "weui": true
  }
}
        已复制代码

#darkmode

SDK 2.35.1 版本正式支持 DarkMode，可通过配置"darkmode": true表示当前小程序可适配 DarkMode，所有基础组件均会根据系统主题展示不同的默认样式，navigation bar 和 tab bar 也会根据开发者的配置自动切换。

配置后，自行完成基础样式以外的适配工作。

目前 android 是通过反色实现的，在使用前请做好测试。

具体表现为：暗黑模式下基础库部分组件样式与ios不一致，WXSS无法使用prefers-color-scheme，其余功能正常。

#themeLocation

自定义theme.json的路径，当配置"darkmode":true时，当前配置文件为必填项。

#referer

若有配置 referer

组件 video、image 以及 API request、download & uploadFile、loadFontFace、previewImage、previewMedia、getImageInfo 会在请求 http 资源时携带上配置的 referer

#2. 配置示例

{
  "pages": ["pages/index/index", "pages/logs/index"],
  "window": {
    "navigationBarTitleText": "Demo"
  },
  "tabBar": {
    "list": [
      {
        "pagePath": "pages/index/index",
        "text": "首页"
      },
      {
        "pagePath": "pages/logs/logs",
        "text": "日志"
      }
    ]
  },
  "debug": true,}

版权声明：本文内容由网络用户投稿，版权归原作者所有，本站不拥有其著作权，亦不承担相应法律责任。如果您发现本站中有涉嫌抄袭或描述失实的内容，请联系我们jiasou666@gmail.com 处理，核实后本网站将在24小时内删除侵权内容。