微信小程序配置文件介紹
- 2020 年 4 月 3 日
- 筆記
1.小程序的配置文件都是什麼格式的?
json格式
2.小程序的json格式配置文件包含哪些?
- 全局配置app.json
app.json 是當前小程序的全局配置,包括了小程序的所有頁面路徑、界面表現、網絡超時時間、底部 tab 等。QuickStart 項目裡邊的 app.json 配置內容如下:
{ "pages":[ "pages/index/index", "pages/logs/logs" ], "window":{ "backgroundTextStyle":"light", "navigationBarBackgroundColor": "#fff", "navigationBarTitleText": "WeChat", "navigationBarTextStyle":"black" } }
我們簡單說一下這個配置各個項的含義:
pages字段 —— 用於描述當前小程序所有頁面路徑,這是為了讓微信客戶端知道當前你的小程序頁面定義在哪個目錄。
window字段 —— 定義小程序所有頁面的頂部背景顏色,文字顏色定義等。
其他配置項細節可以參考文檔 小程序的配置 app.json 。
總結:主配置文件app.json位於小程序項目的根目錄中,用來對小程序進行全局配置,包括配置所有頁面的路徑、窗口表現、設置網絡超時時間、設置頁面頭部或底部tab欄等。
- 工具配置project.config.json
通常大家在使用一個工具的時候,都會針對各自喜好做一些個性化配置,例如界面顏色、編譯配置等等,當你換了另外一台電腦重新安裝工具的時候,你還要重新配置。
考慮到這點,小程序開發者工具在每個項目的根目錄都會生成一個 project.config.json,你在工具上做的任何配置都會寫入到這個文件,當你重新安裝工具或者換電腦工作時,你只要載入同一個項目的代碼包,開發者工具就自動會幫你恢復到當時你開發項目時的個性化配置,其中會包括編輯器的顏色、代碼上傳時自動壓縮等等一系列選項。
其他配置項細節可以參考文檔 開發者工具的配置 。
總結:
- 頁面配置 page.json
這裡的 page.json 其實用來表示 pages/logs 目錄下的 logs.json 這類和小程序頁面相關的配置。
如果你整個小程序的風格是藍色調,那麼你可以在 app.json 裡邊聲明頂部顏色是藍色即可。實際情況可能不是這樣,可能你小程序裡邊的每個頁面都有不一樣的色調來區分不同功能模塊,因此我們提供了 page.json,讓開發者可以獨立定義每個頁面的一些屬性,例如剛剛說的頂部顏色、是否允許下拉刷新等等。
其他配置項細節可以參考文檔 頁面配置 。
註:配置文件的優先級是page.json大於app.json