行業動態

前面介紹了微信小程序的目錄、文件組成方式，以及各文件類型的作用。這里將為大家詳細介紹配置文件的內容，包括主配置文件和頁面配置文件的內容。

1、主配置文件app.json

主配置文件app.json位于項目主目錄中，用來對當前項目進行全局配置。包括配 置每個頁面文件的路徑、窗口表現、設置網絡超時時間、設置多tab等。

首先看一下前面創建的項目First的主配置文件的內容，具體代碼如下：

可以看出，配置文件的內容就是一個JSON對象，其中的屬性pages用來定義小 程序中用到的頁面，這個屬性是個數組。上面代碼中這個數組屬性有2個值，表示該 小程序有2個頁面，一個頁面位于“pages/index”目錄下，名為“index”，另一個頁 面位于“pages/logs”目錄下，名為logs”。

而屬性window則是用來定義窗口的表現形式，如上面的代碼中， navigationBarTitleText屬性的值為“WeChat”表示設置窗口的標題為“WeChat”。

當然，主配置文件app.json中可供配置的并不只有上面代碼所列的各項，下面列出主配置文件可用的各配置項。

（1）配置頁面路徑

在主配置文件app.json中的第一個配置項就是pages,這是一個數組屬性。在微信小程序中要使用到的頁面都必須在app.json中進行配置，將其添加到pages數組中。

在pages數組中的每一項都是一個字符串，用來指定小程序由哪些頁面組成。每 一項代表對應頁面的【路徑+文件名】信息，文件名不需要寫后綴，因為框架會自動 尋找路徑.json,.js,.wxml,.wxss的4個文件進行編譯組合。

位于pages數組中的第一項表示小程序的初始頁面，即啟動小程序時將運行顯示的頁面。

提示：

小程序中新增/減少頁面，都需要對pages數組進行修改。如果沒有將頁面的路徑添加到pages數組中，即使小程序中的代碼導航到該頁面，仍然不能打開該頁面，并且控制臺不會顯示任何提示信息，因此，在調試時如果打不開頁面，首先應檢查是否將頁面添加到pages數組屬性中。

（2）配置窗口狀態

微信小程序運行時窗口的狀態由主配置文件app.json中的window屬性進行配置, 這是一個JSON對象屬性，包含以下屬性，可用來設置窗口的名稱、導航欄等。

? backgroundColor,用來設置窗口的背景色，與HTML中的顏色設置相同，使 用十六進制的RGB方式設置顏色，in#ffDOOO表示設置背景顏色為紅色。這 個屬性的默認值為（即白色）。

? backgroundTextStyle,用來設置下拉背景字體、loading圖的樣式，目前只支 持設置為“dark”或“light”這兩個值，默認值為“dark”。

? enablePullDownRefresh,用來設置是否開啟下拉刷新，默認值為false。

? navigationBarBackgroundColor ,用來設置導航欄背景顏色，默認值為 ?*#000000% 即黑色。

? navigationBarTextStyle,設置導航欄標題顏色，目前只支持“black”和"white” 這兩個值，默認值為“white” o

? navigationBarTitleText,設置導航欄標題文字內容。

(3）配置窗口底部bar

所謂tabBar,是指在微信小程序底部有一個可以用來切換頁面的tab欄。

要在微信小程序中使用    tabBar ，需要在主配置文件pages.json中加一個名為“tabBar”的屬性，這個屬性是一個數組，只能配置最少2個、最多5個tab，tab按數組的順序排序。每個tab可配置顯示的文字、圖標等選項。另外，對于整個tabBar也可通過屬性進行配置。

在tabBar中有5個屬性可配置，分別如下：

?color,設置tab未激活狀態的文字顏色，使用十六進制的顏色，如#dddddd0

?selectedColor,設置tab激活狀態的文字顏色，使用十六進制的顏色，如#3cc5 If。

?borderStyle,設置tabBar上邊框的顏色，目前只支持設置為“black”或“white”。

?backgroundColor,設置tab的背景色，使用十六進制的顏色，in#ffffffo

?list,這是一個數，設置tab的列表項，最少2個、最多5個tab。

如上面的代碼所示，對于list這個數組屬性，其中每一項又是一個對象，又可以 設置4個屬性值，這些屬性值的含義如下：

?text,設置tab上顯示的文字，如果為tab設置了圖標，則文字位于圖標下方。 如果未設置圖標，則只顯示文字。

?iconPath,設置tab處于未激活狀態時顯示的圖片路徑，icon圖片大小限制為 40KB。

?selectedlconPath,設置tab處于激活狀態時的圖片路徑，同樣，icon圖片大小 限制為40KB。

?pagePath,設置觸按該tab時跳轉的頁面路徑，這里設置的頁面路徑必須在 pages中進行了配置。

(4)其他配置

在微信小程序中有多種網絡連接API,例如request連接、socket網絡連接、上傳 文件、下載文件等網絡操作的APIO在主配置文件app.json中可通過參數 networkTimeout設置各種網絡請求的超時時間。這是一個JSON對象屬性，可通過以下各屬性進行相關超時設置。

?connectSocket,設置wx.connectSocket接口網絡請求的超時時間。

?downloadFile,設置wx.downloadFile下載文件接口的超時時間。

?uploadFile,設置wx.uploadFile上傳文件接口的超時時間。

?request,設置wx.request網絡請求接口的超時時間。

以上的超時時間設置的單位都是毫秒。

另外，在全局配置文件app.json中還有一個名為debug的屬性，可以在開發者工具中開啟debug模式，在開發者工具的控制臺面板，調試信息以info的形式給出，其信息有Page的注冊、頁面路由、數據更新和事件觸發，可以幫助開發者快速定位一 些常見的問題。

以下是一個包含了所有配置選項的簡單主配置文件app.json：

2、頁面配置文件

主配置文件app.json的配置項很多，其配置是全局的，也就是說對所有頁面都適用。但是，如窗口標題之類的，很多時候都需在不同頁面顯示不同標題。因此，每個 頁面也可能需要一個頁面配置文件來對這些項目進行配置。

頁面配置文件的文件名與頁面其他3個文件名相同，擴展名為.json。例如，頁面index的頁面配置文件名全稱為index.json。

頁面的配置比app.json主配置文件的項目要簡單得多，在頁面配置文件中只能設 置app.json中的window配置項的內容（頁面中配置項會覆蓋app.json的window中相 同的配置項），以決定本頁面的窗口表現，所以無須寫window這個鍵（但外部的花 括號不能?。?，如下所示：