Skip to content

配置文件

配置文件介绍

  • app.json:小程序全局配置文件,用于配置小程序的全局属性和页面路由。
  • 页面.json:页面配置文件,用于配置当前页面的窗口样式、页面标题等。
  • project.config.json:项目配置文件,用于配置项目相关的配置项,如开发工具的配置、编译选项等。
  • sitemap.json:配置小程序及页面是否允许被微信索引,提高小程序在搜索引擎搜索到的概率。

app.json配置

  • pages:配置小程序所有页面路径,数组格式,数组中每个元素都是页面的路径。
    • 页面路由不需要写文件后缀,框架会自动去寻找同名目录下的index.wxml、index.wxss、index.js文件。
    • 小程序中新增/减少页面,都需要对pages数组进行修改。
    • 未指定entryPagePath时,数组的第一项代表小程序的初始页面(首页)。
  • window:配置小程序窗口的样式,如导航栏、背景色、标题、状态框等。
  • tabBar:配置小程序底部、顶部tab栏,包括
    • list:配置最少个、最多5个tab项,以及tab的样式。
    • color:tab的字体颜色。
    • selectedColor:tab选中时的字体颜色。
    • backgroundColor:tab的背景色。
    • borderStyle:tab的边框样式。
    • position:tab的位置,可选值:top、bottom。

页面配置

页面配置文件的属性和全局配置文件中的window属性几乎一致,只不过这里不需要额外指定window字段,因此如果出现相同的配置项,页面中配置项会覆盖全局配置文件中相同的配置项。

项目配置文件和配置sass

  • 在创建项目的时候,每个项目的根目录生成两个config.json文件,用于保存开发者在工具上做的个性化配置,例如和编译有关的配置。当重新安装微信开发者工具或换电脑时,只要载入同一个项目的代码包,开发者工具就会自动恢复到当时开发项目时的个性化配置。
  • 项目根目录中的project.config.json和project.private.config.json文件都可以对项目进行配置,区别在于:
    • project.config.json文件常用来进行配置公共的配置;
    • project.private.config.json文件常用来配置个人的配置。
    • 注意事项:project.private.config.json文件写到.gitignore文件中,确保不会被提交到代码仓库中。与最终编译结果有关的设置必须设置到project.config.json文件中。
  • 配置sass:在project.config.json文件中配置setting->useCompilerPlugins:["sass"]。

知识是财富,分享是快乐!