微信小程序的配置包括三方面:全局配置抬吟、頁面配置归薛、sitemap配置
下面詳細(xì)介紹這三部分內(nèi)容嗡靡。
全局配置
小程序根目錄下的 app.json 文件用來對微信小程序進(jìn)行全局配置。文件內(nèi)容為一個(gè) JSON 對象病线,有以下屬性:
1.pages
用于指定小程序由哪些頁面組成吓著,每一項(xiàng)都對應(yīng)一個(gè)頁面的 路徑(含文件名) 信息。文件名不需要寫文件后綴送挑,框架會自動去尋找對應(yīng)位置的 .json, .js, .wxml, .wxss 四個(gè)文件進(jìn)行處理绑莺。
"pages":[
"pages/index/index"
]
2.window
用于設(shè)置小程序的狀態(tài)欄、導(dǎo)航條让虐、標(biāo)題紊撕、窗口背景色。
"window": {
"navigationBarBackgroundColor": "#ffffff",//導(dǎo)航欄背景顏色
"navigationBarTextStyle": "black",//導(dǎo)航欄標(biāo)題顏色赡突,僅支持 black / white
"navigationBarTitleText": "導(dǎo)航欄標(biāo)題",//導(dǎo)航欄標(biāo)題文字內(nèi)容
"backgroundColor": "#eeeeee",//窗口的背景色
"backgroundTextStyle": "light"http://下拉 loading 的樣式对扶,僅支持 dark / light
}
3.tarBar
如果小程序是一個(gè)多 tab 應(yīng)用(客戶端窗口的底部或頂部有 tab 欄可以切換頁面),可以通過 tabBar 配置項(xiàng)指定 tab 欄的表現(xiàn)惭缰,以及 tab 切換時(shí)顯示的對應(yīng)頁面浪南。
"tabBar": {
"color": "#a9b7b7",//tab上的文字默認(rèn)顏色,僅支持十六進(jìn)制顏色
"selectedColor": "#11cd6e",//tab 上的文字選中時(shí)的顏色漱受,僅支持十六進(jìn)制顏色
"backgroundColor":"#11cd6e",//tab的背景色络凿,僅支持十六進(jìn)制顏色
"borderStyle": "white",//tabbar 上邊框的顏色,僅支持 black / white
"list": [
//其中 list 接受一個(gè)數(shù)組昂羡,只能配置最少 2 個(gè)絮记、最多 5 個(gè) tab。tab 按數(shù)組的順序排序虐先,每個(gè)項(xiàng)都是一個(gè)對象
{
"selectedIconPath": "images/11.png",//選中時(shí)的圖片路徑怨愤,不支持網(wǎng)絡(luò)圖片。當(dāng) position 為 top 時(shí)蛹批,不顯示 icon撰洗。
"iconPath": "images/11.png",//圖片路徑,不支持網(wǎng)絡(luò)圖片腐芍。當(dāng) position 為 top 時(shí)差导,不顯示 icon。
"pagePath": "pages/index/index",//頁面路徑猪勇,必須在 pages 中先定義
"text": "首頁"http://tab 上按鈕文字
},
{
"selectedIconPath": "images/11.png",
"iconPath": "images/11.png",
"pagePath": "pages/logs/logs",
"text": "我的"
}
]
}
4.networkTimeout
各類網(wǎng)絡(luò)請求的超時(shí)時(shí)間设褐,單位均為毫秒。
"networkTimeout": {
"request": 10000,
"downloadFile": 10000
}
5.debug
可以在開發(fā)者工具中開啟 debug 模式,在開發(fā)者工具的控制臺面板络断,調(diào)試信息以 info 的形式給出裁替,其信息有 Page 的注冊,頁面路由貌笨,數(shù)據(jù)更新,事件觸發(fā)等襟沮∽锻铮可以幫助開發(fā)者快速定位一些常見的問題。
"debug":true,
6.functionalPages
插件所有者小程序需要設(shè)置這一項(xiàng)來啟用插件功能頁开伏。
7.requiredBackgroundModes
申明需要后臺運(yùn)行的能力膀跌,類型為數(shù)組。目前支持以下項(xiàng)目:
·audio: 后臺音樂播放
·location: 后臺定位
如:
{
"pages": ["pages/index/index"],
"requiredBackgroundModes": ["audio", "location"]
}
8.PermissionObject 結(jié)構(gòu)
小程序獲取權(quán)限時(shí)展示的接口用途說明固灵。
"permission": {
"scope.userLocation": {
"desc": "你的位置信息將用于小程序位置接口的效果展示" // 高速公路行駛持續(xù)后臺定位
}
9.style
微信客戶端 7.0 開始捅伤,UI 界面進(jìn)行了大改版。小程序也進(jìn)行了基礎(chǔ)組件的樣式升級巫玻。app.json 中配置 "style": "v2"可表明啟用新版的組件樣式丛忆。
"style": "v2"
9.useExtendedLib
指定需要引用的擴(kuò)展庫。目前支持以下項(xiàng)目:
-
kbone
: 多端開發(fā)框架 -
weui
: WeUI 組件庫
指定后仍秤,相當(dāng)于引入了對應(yīng)擴(kuò)展庫相關(guān)的最新版本的 npm 包熄诡,同時(shí)也不占用小程序的包體積。目前暫不支持在分包中引用诗力。用法如下:
"useExtendedLib": {
"kbone": true,
"weui": true
}
其他配置見開發(fā)文檔
(https://developers.weixin.qq.com/miniprogram/dev/reference/configuration/app.html)
局部配置
每一個(gè)小程序頁面也可以使用 .json 文件來對本頁面的窗口表現(xiàn)進(jìn)行配置凰浮。頁面中配置項(xiàng)在當(dāng)前頁面會覆蓋 app.json 的 window 中相同的配置項(xiàng)。文件內(nèi)容為一個(gè) JSON 對象苇本。
{
"navigationBarBackgroundColor": "#ffffff",
"navigationBarTextStyle": "black",
"navigationBarTitleText": "微信接口功能演示",
"backgroundColor": "#eeeeee",
"backgroundTextStyle": "light"
}
sitemap 配置
小程序根目錄下的 sitemap.json 文件用于配置小程序及其頁面是否允許被微信索引袜茧,文件內(nèi)容為一個(gè) JSON 對象,如果沒有 sitemap.json 瓣窄,則默認(rèn)為所有頁面都允許被索引笛厦。