在使用小程序模板時(shí)畔师,會(huì)自動(dòng)生成一個(gè)app.json的文件,里面包含了小程序的配置內(nèi)容,官方文檔詳見(jiàn):全局配置普碎,下面我進(jìn)行了一下總結(jié)。
默認(rèn)生成的配置如圖所示:
pages:頁(yè)面路徑列表
? ? ? ? ? ? 在微信開(kāi)發(fā)者工具里面新建page時(shí)录平,pages會(huì)自動(dòng)生成該路徑麻车,如果刪除頁(yè)面,該頁(yè)面的路徑需要在pages里面手動(dòng)刪除斗这,不然會(huì)報(bào)頁(yè)面錯(cuò)誤动猬。
window:全局的默認(rèn)窗口表現(xiàn)
用于設(shè)置小程序的狀態(tài)欄、導(dǎo)航條表箭、標(biāo)題赁咙、窗口背景色:
navigationBarBackgroundColor:導(dǎo)航欄背景顏色,如?#000000
navigationBarTextStyle:導(dǎo)航欄標(biāo)題顏色,僅支持?black?/?white
navigationBarTitleText:導(dǎo)航欄標(biāo)題文字內(nèi)容(會(huì)被頁(yè)面設(shè)置覆蓋)
navigationStyle:導(dǎo)航欄樣式序目,僅支持以下值:default?默認(rèn)樣式臂痕;custom?自定義導(dǎo)航欄,只保留右上角膠囊按鈕
backgroundColor:窗口的背景色(屏幕下拉后展示的背景色):1.ios可以上拉猿涨,上拉背景色如果沒(méi)有單獨(dú)設(shè)置握童,則顯示? ? ? ? ? ? ? ? ? ? ? ????????????????????????backgroundColor2.如果設(shè)置有backgroundColorTop和backgroundColorBottom,則會(huì)覆蓋backgroundColor
backgroundTextStyle:下拉 loading 的樣式叛赚,僅支持?dark?/?light
backgroundColorTop:屏幕下拉露出頂部窗口的背景色澡绩,僅 iOS 支持(覆蓋backgroundColor)
backgroundColorBottom:屏幕上滑露出底部窗口的背景色,僅 iOS 支持(覆蓋backgroundColor)
enablePullDownRefresh(android):是否開(kāi)啟當(dāng)前頁(yè)面的下拉刷新俺附。(只對(duì)android有效)
onReachBottomDistance(ios):頁(yè)面上拉觸底事件觸發(fā)時(shí)距頁(yè)面底部距離肥卡,單位為px。(只對(duì)ios有效)
pageOrientation:屏幕旋轉(zhuǎn)設(shè)置事镣,默認(rèn)“portrait”步鉴,設(shè)置為“auto”則為跟隨系統(tǒng)旋轉(zhuǎn)
resizable:在 iPad 上運(yùn)行的小程序可以設(shè)置支持屏幕旋轉(zhuǎn)
sitemapLocation:
解決小程序項(xiàng)目中有?sitemap.json 但是 app.json 中沒(méi)有指定?sitemaplocation?時(shí)sitemap.json 會(huì)被覆蓋掉修復(fù) 偶現(xiàn) applaunch with an already exist webviewid 錯(cuò)誤修復(fù) 小游戲模擬器彈出時(shí),wx.showkeyboard 會(huì)一閃而過(guò)的問(wèn)題修復(fù) 提交版本的 " 項(xiàng)目備注" 歷史緩存沒(méi)了的問(wèn)題
tabBar:底部?tab?欄的表現(xiàn)
除了tab文字璃哟、圖標(biāo)和背景色等常用的選項(xiàng)可以設(shè)置氛琢,tab上邊框顏色也可以設(shè)置,tab也可以設(shè)置顯示在頁(yè)面頂端(不顯示圖標(biāo))
color:tab 上的文字默認(rèn)顏色随闪,僅支持十六進(jìn)制顏色
selectedColor:tab 上的文字選中時(shí)的顏色阳似,僅支持十六進(jìn)制顏色
backgroundColor:tab 的背景色,僅支持十六進(jìn)制顏色
borderStyle:tabbar上邊框的顏色铐伴, 僅支持?black?/?white
list:tab 的列表撮奏,詳見(jiàn)?list?屬性說(shuō)明,最少2個(gè)当宴、最多5個(gè) tab
position:tabBar的位置畜吊,僅支持?bottom?/?top
custom:自定義 tabBar
debug:是否開(kāi)啟 debug 模式,默認(rèn)關(guān)閉
debug模式是針對(duì)開(kāi)發(fā)者工具的户矢,開(kāi)啟之后再開(kāi)發(fā)者工具的控制臺(tái)面板輸出Page的注冊(cè)定拟,頁(yè)面路由,數(shù)據(jù)更新逗嫡,事件觸發(fā)等之類(lèi)的調(diào)試信息:
debug模式只在開(kāi)發(fā)者工具中有效青自,默認(rèn)關(guān)閉,即不設(shè)置驱证,如需打開(kāi)延窜,需設(shè)置為true。
requiredBackgroundModes:需要在后臺(tái)使用的能力抹锄,如「音樂(lè)播放」
申明需要后臺(tái)運(yùn)行的能力逆瑞,類(lèi)型為數(shù)組荠藤。目前支持以下項(xiàng)目:
audio: 后臺(tái)音樂(lè)播放
如:
{
????"pages": ["pages/index/index"],
????"requiredBackgroundModes": ["audio"]
}
注:在此處申明了后臺(tái)運(yùn)行的接口,開(kāi)發(fā)版和體驗(yàn)版上可以直接生效获高,正式版還需通過(guò)審核哈肖。
其他一些不常用的配置項(xiàng):
networkTimeout:各類(lèi)網(wǎng)絡(luò)請(qǐng)求的超時(shí)時(shí)間,單位均為毫秒念秧。
functionalPages:是否啟用插件功能頁(yè)淤井,默認(rèn)關(guān)閉。
subpackages:分包結(jié)構(gòu)配置摊趾。
plugins:使用到的插件
preloadRule:分包預(yù)下載規(guī)則
navigateToMiniProgramAppIdList:需要跳轉(zhuǎn)的小程序列表币狠。
usingComponents:全局自定義組件配置