第4章 小程序的配置文件

第4章小程序的配置文件全局配置文件sitemap配置文件頁面配置文件項目配置文件01020403全局配置文件全局配置文件小程序的全局配置文件控制著小程序的全局表現(xiàn)，所有的配置項都在項目根目錄下的app.json文件中進行配置。全局配置文件的內(nèi)容是一個JSON對象，涵蓋了小程序的頁面路徑、窗口表現(xiàn)、底部tab欄、默認啟動頁、網(wǎng)絡超時時間等幾十項配置信息。全局配置文件小程序根目錄下的app.json文件用來對微信小程序進行全局配置。文件內(nèi)容為一個JSON對象，核心屬性包括：entryPagePath，小程序默認啟動首頁；pages，頁面路徑列表；window，全局的默認窗口表現(xiàn)；tabBar，底部tab欄的表現(xiàn)；networkTimeout，網(wǎng)絡超時時間；debug，是否開啟debug模式，默認關閉；functionalPages，是否啟用插件功能頁；singlePage，單頁模式相關配置。頁面配置文件頁面配置文件小程序的頁面配置文件用于對當前頁面的窗口表現(xiàn)進行配置。頁面的配置在當前頁面會覆蓋app.json的window屬性中的相同配置項。page.json可以對當前頁面的導航欄、窗口背景、下拉刷新、上拉觸底、頁面自定義組件等表現(xiàn)能力進行配置。頁面配置文件頁面配置文件內(nèi)容為一個JSON對象，核心屬性包括：navigationBarBackgroundColor，導航欄背景顏色；navigationBarTextStyle，導航欄標題顏色，僅支持black/white；navigationBarTitleText，導航欄標題文字內(nèi)容；navigationStyle，導航欄樣式；backgroundColor，窗口的背景色；backgroundTextStyle，下拉loading的樣式，僅支持dark/light；enablePullDownRefresh，是否開啟當前頁面下拉刷新； onReachBottomDistance，頁面上拉觸底事件觸發(fā)時距頁面底部距離，單位為px；pageOrientation，屏幕旋轉(zhuǎn)設置，支持auto/portrait/landscape。sitemap配置文件sitemap配置文件微信客戶端提供了搜索小程序的能力，開發(fā)者可以通過sitemap.json配置文件來配置小程序頁面是否允許被微信索引。當開發(fā)者允許微信索引時，微信會通過爬蟲的形式，為小程序的頁面內(nèi)容建立索引。當用戶的搜索詞條觸發(fā)該索引時，小程序的頁面將可能展示在搜索結果中。sitemap配置文件rules配置項指定了索引規(guī)則，每項規(guī)則為一個JSON對象，屬性如下所示：action，命中該規(guī)則的頁面是否能被索引；page，頁面的路徑；params，當page字段指定的頁面在被本規(guī)則匹配時可能使用的頁面參數(shù)名稱的列表（不含參數(shù)值）；matching string，當page字段指定的頁面在被本規(guī)則匹配時，此參數(shù)說明params匹配方式；priority，優(yōu)先級，值越大則規(guī)則越早被匹配，否則默認從上到下匹配。sitemap配置文件matching取值說明如下：exact，當小程序頁面的參數(shù)列表等于params時，規(guī)則命中；inclusive，當小程序頁面的參數(shù)列表包含params時，規(guī)則命中；exclusive，當小程序頁面的參數(shù)列表與params交集為空時，規(guī)則命中；partial，當小程序頁面的參數(shù)列表與params交集不為空時，規(guī)則命中。sitemap配置文件sitemap文件配置示例代碼：{"rules":[{"action":"allow","page":"path/to/page","params":["a","b"],"matching":"exact"},{"action":"disallow","page":"path/to/page"}]}項目配置文件