微信小程序配置详解:app.json与project.config.json
2023.12.25 11:55浏览量:44简介:微信小程序(二)——小程序配置文件介绍
微信小程序(二)——小程序配置文件介绍
在微信小程序的开发过程中,配置文件扮演着非常重要的角色。配置文件提供了小程序的基本信息和设置,是开发人员进行小程序开发的重要参考。本文将详细介绍微信小程序中的配置文件,帮助读者更好地理解小程序的配置和设置。
一、小程序配置文件概述
微信小程序的配置文件主要分为两部分:app.json和project.config.json。
- app.json:小程序的全局配置文件,负责小程序的生命周期流程控制以及页面的基本属性等配置。在开发时,小程序会先编译app.json文件,根据里面的配置来生成对应的项目结构。
- project.config.json:项目的本地开发环境配置文件,主要包含编译时的一些配置信息。
二、app.json配置项
app.json是小程序的全局配置文件,包含了小程序的所有页面路径、界面表现、网络超时时间、底部tab等配置信息。其主要配置项包括: - pages:定义小程序所有页面的路径,是小程序必须的一个字段。
- window:全局的样式变量。在小程序的wxml文件中,可以直接使用这些全局样式变量来进行样式控制。
- tabBar:底部分类导航功能页,切换底部标签页时,会渲染此组件。
- networkTimeout:网络请求超时时间设置。
- navigationBarOptions:定义页面顶部导航栏的展示属性,主要有以下三种布局:
- navigationBarTitleText:文字导航栏
- navigationBarBackButtonText:返回按钮
- navigationBarShowButton:显示返回按钮
- tabBar:底部tab栏的配置信息。包括tabBarList(tab栏列表)、selectedColor(默认选中时的文字颜色)、unselectedColor(默认未选中时的文字颜色)、selectedTextColor(默认选中时的文字颜色)、unselectedTextColor(默认未选中时的文字颜色)、backgroundColor(tab栏背景色)、borderStyle(tab栏外框样式)、list(tab栏列表)、pagePath(tab栏链接地址)等属性。
- networkTimeout:网络请求超时时间设置。
- debug:开启调试模式,在真机调试时,可查看更详细的报错信息。
- debugLineNumber:开启后在控制台输出代码行号。
- lang:当前小程序的地区设置,在界面样式里使用,例如button的hover效果。
- showAppStoreButton:是否显示右上角的小程序码打开app的按钮。
- appStoreAppId:App Store应用的appId,若设置了该值则会在页面上出现右上角的小程序码打开app的按钮。
- reLaunchTitle:再次启动页面的标题,仅在有title属性时有效。
- reLaunchDesc:再次启动页面的描述信息,仅在有description属性时有效。
- imathostname、fntoken等自定义扩展功能需要的配置项。
三、project.config.json配置项
project.config.json主要用于存储编译时的一些配置信息,其主要包含以下字段: - usingComponents:项目中使用的自定义组件,键为组件名,值为组件路径。这个配置在构建项目时会生效,项目结构根据此文件会做出相应的调整。对于Hbuild自带的组件(wx:if、wx:else、wx:elif等),也可在这里指定使用时的模板文件名(必填)。使用第三方组件也需要在此处指定。此外还可以对hbuild支持的标签进行扩展。扩展的标签会在编译时被识别并注册到标签体系中。
- usingComponentsInAllWxml:为hbuild预留扩展的接口,便于扩展全局支持其他工具创建的小程序的标签。例如微信小程序的wxml不支持class和for循环,但在hbuilderx中可以创建带有class和for循环的标签,这个属性就是为这个预留的接口,其值是项目中的wxml文件的路径数组,这个路径数组中的文件会被hbuild扫描并注册到标签体系中,生成js文件后也会被微信小程序识别并支持其标签语法。同时也会在hbuild的工具链中注册到全局标签体系中,以便其他项目可以使用这些标签。需要注意的是这个属性只能由hbuild使用,一般项目不应自行设置该属性值。其是必填字段。在使用for等非标准属性值或者jsx标签的时候也需要在这里指定模板文件名(必填)。如果需要在项目中定义自己的自定义标签(不是用 hbuilderx 的自定义组件工具生成的标签),可以直接修改 www/component/ 下的index.js 文件(此操作可能会破坏兼容性,需要谨慎操作)。使用非标准属性的模板必须用 for 循环才能生成标准属性值,因此需要在 hbuilderx 中直接指定使用该模板的 w

发表评论
登录后可评论,请前往 登录 或 注册