全局配置

基础库 3.8.0 开始支持夜间主题（darkmode），低版本需做兼容处理

app.json文件用来对bilibili小程序进行全局配置，决定页面文件的路径、窗口表现、设置网络超时时间、设置多 tab, 夜间主题等。

以下是一个包含了部分常用配置选项的app.json：

{
    "pages": [
        {
            "path": "/pages/index",
            "hasNavigationBar": true,
            "enableScrollEvent": true,
            "navigationBarTitleText": "首页",
            "navigationBarBackgroundColor": "#FB7299",
            "navigationBarTextStyle": "white",
            "backgroundColor": "#ffffff",
            "enablePullDownRefresh": false,
            "onReachBottomDistance": 50,
            "disableScroll": false
        },
        {
            "path": "/pages/detail"
        }
    ],
    // 以下属性值为默认值，可以被pages单个页面配置覆盖
    "window": {
        "hasNavigationBar": false,
        "enableScrollEvent": false,
        "navigationBarTitleText": "",
        "navigationBarBackgroundColor": "#FB7299",
        "navigationBarTextStyle": "white",
        "backgroundColor": "#ffffff",
        "enablePullDownRefresh": false,
        "onReachBottomDistance": 50,
        "disableScroll": false
    },
    "tabBar": {
        "color": "#000000",
        "selectedColor": "#FB7299",
        "backgroundColor": "#ffffff",
        "borderStyle": "",
        "position": "bottom",
        "list": [
            {
                "pagePath": "/pages/index",
                "text": "首页",
                "iconPath": "/static/icon.png",
                "selectedIconPath": "/static/icon-selected.png"
            },
            {
                "pagePath": "/pages/detail",
                "text": "详情"
            }
        ]
    },
    "networkTimeout": {
        "request": 10000,
        "downloadFile": 10000
    },
    "darkmode": true,
    "darkConfig": {
        "pages": [{
            "path": "/pages/index",
            "navigationBarBackgroundColor": "#531D11",
            "navigationBarTextStyle": "white",
            "backgroundColor": "#83BB1F",
            "backgroundColorTop": "#1f1f1f",
            "backgroundColorBottom": "#191919"
        }],
        "window": {
            "navigationBarBackgroundColor": "#3cc51f",
            "navigationBarTextStyle": "white",
            "backgroundColor": "#efefef",
            "backgroundColorTop": "#ffffff",
            "backgroundColorBottom": "#1f1f1f"
        },
        "tabBar": {
            "color": "#191919",
            "selectedColor": "#eeeeee",
            "backgroundColor": "#3cc51f",
            "borderStyle": "white",
            "list": [{
                "pagePath": "/pages/index",
                "iconPath": "/static/icon.png",
                "selectedIconPath": "/static/icon-selected.png"
            }]
        }
    }
}

app.json 配置项列表

pages

用于指定小程序由哪些页面组成，每一项都对应一个页面的 路径+文件名 信息。按照约定，/pages/{pageName}/index.vue，pageName目录下的index.vue作为page的入口文件。（此处跟微信小程序有差异）

数组的第一项代表小程序的初始页面（首页）。小程序中新增/减少页面，都需要对 pages 数组进行修改。

如开发目录为：

├── app.js
├── app.json
├── app.less
├── pages
│   │── index
│   │   └── index.vue
│   └── logs
│       ├── index.vue
│       └── logs.js

则需要在 app.json 中写：（此处跟微信小程序有差异，页面路径以/开头）

{
    "pages": [
        {
            "path": "/pages/index"
        },
        {
            "path": "/pages/logs"
        }
    ]
}

window

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

注：以上属性也可配置在 pages 的每个对象里，只对配置的page页面生效，并会覆盖 window 下的对应的属性配置

tabBar

如果小程序是一个多 tab 应用（客户端窗口的底部或顶部有 tab 栏可以切换页面），可以通过 tabBar 配置项指定 tab 栏的表现，以及 tab 切换时显示的对应页面。

开发者注意：

• tabBar承载的页面，一定有NavigationBar，且page中声明的设定除hasNavigationBar之外均有效，如果page中未声明NavigationBar的设定，则继承window中的声明。

• tabBar只支持2-5个Tab，不足2个Tab，则不生成tabBar（相当于没有配置tabBar），超过5个，取tabBar的list前5个Tab展示。

• 需通过 bl.switchTab 才能跳转到TabBar中承载的页面，bl.navigateTo 不起作用。

其中 list 接受一个数组，只能配置最少2个、最多5个 tab。tab 按数组的顺序排序，每个项都是一个对象，其属性值如下：

networkTimeout

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

darkmode（3.8.0起支持）

通过配置 "darkmode": true 表示当前小程序可适配夜间主题，基础组件包括 xxxx、xxxx、均会根据 APP 主题展示对应主题的指定样式

darkConfig（3.8.0起支持）

夜间模式的详细配置。

监听主题切换事件

• 可在 App.onThemeChange 回调中接收主题切换事件（只有 iOS 支持）。
• 通过 bl.onThemeChange 监听主题变化。
• 通过 bl.offThemeChange 取消监听。

Tips

• 如果 声明了 "darkmode":true， bl.getSystemInfo 或 bl.getSystemInfoSync 的返回结果中会包含 theme 属性，值为 light 或 dark，且navigationBarTextStyle 配置项在 APP 黑色主题下不生效。如果 未声明 "darkmode":true，则无法获取到 theme 属性。
• 如果配置了 pages, pages 的可配置属性包括: path, navigationBarBackgroundColor, navigationBarTextStyle, backgroundColor, backgroundColorTop, backgroundColorBottom 。其中path 为必填。
• 如果配置了 window, window的可配置属性包括: navigationBarBackgroundColor, navigationBarTextStyle, backgroundColor, backgroundColorTop, backgroundColorBottom。
• 如果配置了 tabBar, tabBar的可配置属性包括: color, selectedColor, backgroundColor, borderStyle, list。如果配置了 list, 则 list 的 pagePath 为必填。