一、小程序文檔配置

1、小程序的目錄結構

1.1、目錄結構

小程序包含一個描述整體程序的 app 和多個描述各自頁面的 page
一個小程序主體部分由三個文件組成，必須放在項目的根目錄

比如當前我們的《第一個小程序》項目根目錄下就存在這三個文件：

1.2、pages目錄
一個小程序頁面由四個文件組成，分別是
項目根目錄下的pages目錄存放的是小程序中的頁面，小程序每個頁面都由4個文件組成， 分別為：

注意：為了方便開發者減少配置項，描述頁面的四個文件必須具有相同的路徑與文件名
例如：《第一個小程序》項目中的pages目錄

例如：index頁面文件夾中

2、全局配置 app.json

2.1 app.json概述

小程序根目錄下的 app.json 文件用來對微信小程序進行全局配置，決定頁面文件的路徑、窗口表
現、設置網絡超時時間、設置多 tab 等

• 注意：
  1）app.json中不能添加任何注釋，否則會報錯
  2）字符串用戶雙引號引起來。
  

上圖中我們看到app.json中實際保存的是小程序的主配置項屬性列表，app.json中常見的屬性設置有以
下幾項：

2.2、各項屬性說明

2.2.1、pages

值是一個數組，數組的每一項都字符串，用來指定小程序由哪些頁面組成。每一項代表對應頁面【路徑
+文件名(不包含后綴名)】的信息。數組的第一項代表小程序的初始頁面。
注意：小程序每新增一個頁面，相應的在pages中就需要增加多一個配置頁面記錄；反之亦然。

2.2.2、window

用于設置小程序的狀態欄、導航條、標題、窗口背景色。

示例：

2.2.3、tabBar

tabBar 支持的屬性：

• 當設置 position 為 top 時，將不會顯示 icon。
• tabBar 中的 list 是一個數組，只能配置最少2個、最多5個tab，tab 按數組的順序排序。

tabBar 中list支持的屬性：

2.2.4、networkTimeout
用于設置各種網絡請求的超時時間

注意：上線之前一定要設置一下超時時間，不然小程序有可能出現下列情況。
示例：

2.2.5、debug
用于在開發者工具中開啟 debug 模式，在開發者工具的控制臺面板，調試信息以 info 的形式給出，其
信息有 Page 的注冊，頁面路由，數據更新，事件觸發。可以幫助開發者快速定位一些常見的問題，默
認為開啟狀態。
在開發階段，建議打開 debug。上線時請關閉此選項，設置為 false。

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

開發文檔：https://developers.weixin.qq.com/miniprogram/dev/framework/config.html

3、頁面配置文件 *.json

每個小程序頁面也可以使用同名 *.json 文件來對本頁面的窗口表現進行配置，頁面中配置項會覆蓋
app.json 的 window 中相同的配置項。
用于設置小程序的狀態欄、導航條、標題、窗口背景色。

開發文檔：https://developers.weixin.qq.com/miniprogram/dev/reference/configuration/page.html

靜態配置參考

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

例如：

動態設置
使用微信提供的API接口
語法：wx.setNavigationBarTitle(Object object)

4、sitemap配置

開發文檔：https://developers.weixin.qq.com/miniprogram/dev/reference/configuration/sitemap.
html
微信現已開放小程序內搜索，開發者可以通過 sitemap.json 配置，或者管理后臺頁面收錄開關來配
置其小程序頁面是否允許微信索引 ； 當開發者允許微信索引時，微信會通過爬蟲的形式，為小程序的
頁面內容建立索引。當用戶的搜索詞條觸發該索引時，小程序的頁面將可能展示在搜索結果中。