概述
众所周知,在开发小程序时。在微信开发者工具中有个功能叫 添加编译模式
。 通过配置可以帮助开发者快速调试指定页面下的场景。当你添加了内容后。会在项目的 project.private.config.json
中的 condition.miniprogram.list
中保存一条记录。
通常情况下。这个配置信息需要我们手动录入并进行维护。当然插件也提供了一种方式能够方便的进行生成
使用
文件监听自动生成/同步
插件会自动监听 配置页面的文件(注1) 中 pages 和 subpages 中的修改。并在每次发生变化后弹窗提示你是否需要生成/同步页面配置信息到 project.private.config.json。
对于弹窗有三种选择:
不再显示
: 当此工作空间内修改文件不在提示同步。重启编辑器后重置。如果你需要永久关闭。请使用插件参数配置同步
: 同步至 project.private.config.json不同步
: 或者按 ESC取消同步
注1
配置页面的文件
在 Taro项目中指的是 src/app.config.ts
;在 Uni项目中指的是 pages.config.ts
注意
由于小程序配置文件没有唯一key的概念并且在人工编辑后会被强制覆盖。
所以为了保证插件与json文件能够正确关联。每个配置中的name字段都有个 💻 开头的图标。此图标请不要删除。否则会被认为是人工添加。丢失同步
手动生成/同步
除了上面自动生成的方式。你可以可以通过右键
的方式手动进行同步。
- 找到配置页面的文件
app.config.ts
或pages.config.ts
- 右键, 选择
同步页面配置至 project.private.config.json
- 执行成功
name字段生成
在project.private.config.json
有两个重要的参数 pathName (表示页面路径地址) 和 name (开发工具中显示的名称)。对于name字段插件可以从 注释中关联。
目前支持两种注释方式: 1. JSDOC 类型注释 2. 尾注释。示例如下,你可以选择自己喜欢的方式编写。建议使用 尾注释
ts
{
pages: [
'pages/tabbar/home/index', // 首页 - 尾注释
/** 登录授权 - JSDOC注释*/
'pages/auth/index',
],
}
配置
参数 | 描述 | 备注 |
---|---|---|
wmeimob.wechat.openSyncConditionList | 默认: true | 是否开启文件监听小程序同步project.private.config.json中的condition.list |