全局配置

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

配置项

pages

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

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

如开发目录为：

├── app.js
├── app.json
├── app.blss
├── pages
│   │── index
│   │   ├── index.blml
│   │   ├── index.js
│   │   ├── index.json
│   │   └── index.blss
│   └── logs
│       ├── logs.blml
│       └── logs.js
└── utils

则需要在 app.json 中写

{
  "pages": ["pages/index/index", "pages/logs/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

开发者工具 1.03.2004271 及以上版本支持，基础库 2.11.0 及以上版本支持

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

配置后，请根据DarkMode 适配指南自行完成基础样式以外的适配工作。

{
  "darkmode": true
}

darkConfig（3.8.0 起支持）

夜间模式的详细配置。

Tips

• 如果 声明了 "darkmode":true， bl.getSystemInfo 或 bl.getSystemInfoSync 的返回结果中会包含 theme 属性，值为 light 或 dark。
• 如果 未声明 "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 为必填。