第4章 小程序的配置文件-【千锋教育】微信小程序开发与实战（微课版）

第4章 小程序的配置文件 全局配置文件 sitemap配置文件 页面配置文件 项目配置文件 01 02 04 03 目 录 CATALOUGUE 初心至善 匠心育人 全局配置文件 初心至善 匠心育人 全局配置文件 小程序的全局配置文件控制着小程序的全局表现，所有的配置项都在项目根目录下的app.json文件中进行配置。全局配置文件的内容是一个JSON对象，涵盖了小程序的页面路径、窗口表现、底部tab栏、默认启动页、网络超时时间等几十项配置信息。 初心至善 匠心育人 全局配置文件 小程序根目录下的 app.json 文件用来对微信小程序进行全局配置。文件内容为一个 JSON 对象，核心属性包括： entryPagePath，小程序默认启动首页； pages，页面路径列表； window，全局的默认窗口表现； tabBar，底部 tab 栏的表现； networkTimeout，网络超时时间； debug，是否开启 debug 模式，默认关闭； functionalPages，是否启用插件功能页； singlePage，单页模式相关配置。 初心至善 匠心育人 页面配置文件 初心至善 匠心育人 页面配置文件 小程序的页面配置文件用于对当前页面的窗口表现进行配置。页面的配置在当前页面会覆盖 app.json 的 window 属性中的相同配置项。page.json 可以对当前页面的导航栏、窗口背景、下拉刷新、上拉触底、页面自定义组件等表现能力进行配置。 初心至善 匠心育人 页面配置文件 页面配置文件内容为一个 JSON 对象，核心属性包括： navigationBarBackgroundColor，导航栏背景颜色； navigationBarTextStyle，导航栏标题颜色，仅支持 black / white； navigationBarTitleText，导航栏标题文字内容； navigationStyle，导航栏样式； backgroundColor，窗口的背景色； backgroundTextStyle，下拉 loading 的样式，仅支持 dark / light； enablePullDownRefresh，是否开启当前页面下拉刷新； onReachBottomDistance，页面上拉触底事件触发时距页面底部距离，单位为px； pageOrientation，屏幕旋转设置，支持 auto / portrait / landscape。 初心至善 匠心育人 sitemap配置文件 初心至善 匠心育人 sitemap配置文件 微信客户端提供了搜索小程序的能力，开发者可以通过 sitemap.json 配置文件来配置小程序页面是否允许被微信索引。当开发者允许微信索引时，微信会通过爬虫的形式，为小程序的页面内容建立索引。当用户的搜索词条触发该索引时，小程序的页面将可能展示在搜索结果中。 初心至善 匠心育人 sitemap配置文件 rules 配置项指定了索引规则，每项规则为一个JSON对象，属性如下所示： action，命中该规则的页面是否能被索引； page，页面的路径； params，当 page 字段指定的页面在被本规则匹配时可能使用的页面参数名称的列表（不含参数值）； matching string，当 page 字段指定的页面在被本规则匹配时，此参数说明 params 匹配方式； priority，优先级，值越大则规则越早被匹配，否则默认从上到下匹配。 初心至善 匠心育人 sitemap配置文件 matching 取值说明如下： exact，当小程序页面的参数列表等于 params 时，规则命中； inclusive，当小程序页面的参数列表包含 params 时，规则命中； exclusive，当小程序页面的参数列表与 params 交集为空时，规则命中； partial，当小程序页面的参数列表与 params 交集不为空时，规则命中。 初心至善 匠心育人 sitemap配置文件 sitemap文件配置示例代码： { "rules":[{ "action": "allow", "page": "path/to/page", "params": ["a", "b"], "matching": "exact" }, { "action": "disallow", "page": "path/to/page" }] } 初心至善 匠心育人 项目配置文件 初心至善 匠心育人 项目配置文件 可以在项目根目录使用 project.config.json 文件对项目进行配置。项目的编译设置，可以指定以下设置。 以下字段可以开发者工具-详情-本地设置可以对应上。 初心