全域性配置

小程式根目錄下的 app.json 檔案用來對微信小程式進行全域性配置，決定頁面檔案的路徑、視窗表現、設定網路超時時間、設定多 tab 等。

配置示例

以下是一個包含了部分常用配置選項的 app.json ：

{
  "pages": [
    "pages/index/index",
    "pages/logs/index"
  ],
  "window": {
    "navigationBarTitleText": "Demo"
  },
  "tabBar": {
    "list": [{
      "pagePath": "pages/index/index",
      "text": "首頁"
    }, {
      "pagePath": "pages/logs/logs",
      "text": "日誌"
    }]
  },
  "networkTimeout": {
    "request": 10000,
    "downloadFile": 10000
  },
  "debug": true,
  "navigateToMiniProgramAppIdList": [
    "wxe5f52902cf4de896"
  ]
}
 

app.json 配置項列表

pages

用於指定小程式由哪些頁面組成，每一項都對應一個頁面的 路徑+檔名 資訊。檔名不需要寫檔案字尾，框架會自動去尋找對於位置的 .json, .js, .wxml, .wxss 四個檔案進行處理。

陣列的第一項代表小程式的初始頁面（首頁）。小程式中新增/減少頁面，都需要對 pages 陣列進行修改。

如開發目錄為：

├── app.js
├── app.json
├── app.wxss
├── pages
│   │── index
│   │   ├── index.wxml
│   │   ├── index.js
│   │   ├── index.json
│   │   └── index.wxss
│   └── logs
│       ├── logs.wxml
│       └── logs.js
└── utils

則需要在 app.json 中寫

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

window

用於設定小程式的狀態列、導航條、標題、視窗背景色。

注：HexColor（十六進位制顏色值），如"#ff00ff"

注：navigationStyle 只在 app.json 中生效。開啟 custom 後，低版本客戶端需要做好相容。開發者工具基礎庫版本切到 1.7.0（不代表最低版本，只供除錯用）可方便切到舊視覺

注：客戶端 6.7.2 版本開始，navigationStyle: custom 對 <web-view> 元件無效

如 app.json ：

{
  "window":{
    "navigationBarBackgroundColor": "#ffffff",
    "navigationBarTextStyle": "black",
    "navigationBarTitleText": "微信介面功能演示",
    "backgroundColor": "#eeeeee",
    "backgroundTextStyle": "light"
  }
}

tabBar

如果小程式是一個多 tab 應用（客戶端視窗的底部或頂部有 tab 欄可以切換頁面），可以通過 tabBar 配置項指定 tab 欄的表現，以及 tab 切換時顯示的對應頁面。

其中 list 接受一個數組，只能配置最少2個、最多5個 tab。tab 按陣列的順序排序，每個項都是一個物件，其屬性值如下：

networkTimeout

各類網路請求的超時時間，單位均為毫秒。

debug

可以在開發者工具中開啟 debug 模式，在開發者工具的控制檯面板，除錯資訊以 info 的形式給出，其資訊有Page的註冊，頁面路由，資料更新，事件觸發等。可以幫助開發者快速定位一些常見的問題。

示例：

"debug":{

"debug": "true"

},

"debug":{

"debug": "false"

},

functionalPages

基礎庫 2.1.0 開始支援，低版本需做相容處理。

啟用外掛功能頁時，外掛所有者小程式需要設定其 functionalPages 為 true。

subpackages

微信客戶端 6.6.0 ，基礎庫 1.7.3 及以上版本支援

啟用分包載入時，宣告專案分包結構。

寫成 subPackages 也支援。

workers

基礎庫 1.9.90 開始支援，低版本需做相容處理。

使用 Worker 處理多執行緒任務時，設定 Worker 程式碼放置的目錄

requiredBackgroundModes

微信客戶端 6.7.2 及以上版本支援

申明需要後臺執行的能力，型別為陣列。目前支援以下專案：

• audio: 後臺音樂播放

如：

{
  "pages": ["pages/index/index"],
  "requiredBackgroundModes": ["audio"]
}

注：在此處申明瞭後臺執行的介面，開發版和體驗版上可以直接生效，正式版還需通過稽核。

plugins

基礎庫 1.9.6 開始支援，低版本需做相容處理。

宣告小程式需要使用的外掛。

preloadRule

基礎庫 2.3.0 開始支援，低版本需做相容處理。

宣告分包預下載的規則。

resizable

基礎庫 2.3.0 開始支援，低版本需做相容處理。

在 iPad 上執行的小程式可以設定支援螢幕旋轉。

navigateToMiniProgramAppIdList

基礎庫 2.4.0 開始支援，低版本需做相容處理。

當小程式需要使用 wx.navigateToMiniProgram 介面跳轉到其他小程式時，需要先在配置檔案中宣告需要跳轉的小程式 appId 列表，最多允許填寫 10 個。

usingComponents

開發者工具 1.02.1810190 及以上版本支援 usingComponents 欄位，在此處宣告的自定義元件視為全域性自定義元件，在小程式內的頁面或自定義元件中可以直接使用而無需再宣告。

頁面配置

每一個小程式頁面也可以使用.json檔案來對本頁面的視窗表現進行配置。

頁面的配置只能設定 app.json 中部分 window 配置項的內容，頁面中配置項會覆蓋 app.json 的 window 中相同的配置項。

配置示例

{
  "navigationBarBackgroundColor": "#ffffff",
  "navigationBarTextStyle": "black",
  "navigationBarTitleText": "微信介面功能演示",
  "backgroundColor": "#eeeeee",
  "backgroundTextStyle": "light"
}

頁面配置項列表

頁面的.json只能設定 window 相關的配置項，以決定本頁面的視窗表現，所以無需寫 window 這個鍵。