更新记录
0.0.0(2021-10-11) 下载此版本
20211011 发布第一个版本
平台兼容性
HBuilderX最低兼容版本 |
---|
3.2.9 |
HBuilderX插件通用注意事项
HBuilderX-2.7.12以下版本安装插件市场内的插件后,卸载时需手动卸载,详细教程参考:如何手动卸载插件
Page Json Tool
实现pages.json内容的分模块管理。致力于让项目代码更清晰,让团队协作更高效。
背景
Uni-app在团队多人协作时,遇到以下问题:
- 应用中页面较多,pages.json文件冗长,阅读困难。
- 团队多人合作时,常因为同时修改了pages.json文件,导致版本管理时代码冲突。
愿望
- 满足系统功能模块化。
- 避免团队开发不会同时编辑一个文件。
- 方便模块移植。
- 实现pages.json内容的分模块管理。将配置分散到不同文件中,当文件被修改时自动合并到pages.json。
实现
- 应用根目录下增加了 config 目录,里面存放系统的全局配置文件,比如:condition.json,easy-com.json,global-style.json,tab-bar.json,通过各json文件的文件名可以看出,是对应pages.json 中的 各配置节点。
- 如果存在workers目录,在该目录下生成 config.json ,对应 pages.json 中的 workers 属性配置。
- pages目录中存放主包页面模块,一个文件夹一个模块,该文件夹下的router.json 对应 pages.json 中的 pages 属性配置。
- 应用根目录下存在分包目录,如pagesA, pagesB...存放分包页面模块,一个文件夹一个模块,该文件夹下的router.json,可对应pages.json中的subPackages属性配置。
- 本插件监控的目录为"pages config workers 以pages开头的文件夹,如pagesA,pagesB", 监控的文件名为"router.json,condition.json,easy-com.json,global-style.json,config.json,tab-bar.json,preload-rule.json"。
- 监控以上各目录文件,发生新建或修改时,自动拉取配置,合并生成 pages.json。
使用步骤
- 在HBuilderX的插件市场搜索Page Json Tool插件,并安装
- 打开项目中任意文件,分别执行右键菜单中的page Json Tool Init,page Json Tool 将完成如下操作: A. page Json Tool Init: 初始化生成config目录,及相应的配置文件 B. page Json Tool: 开启 watch 功能, 当监控的目录或文件发生变化时, 自动合并生成pages.json
说明
- 思路及源码借鉴uni-dev-tools,感谢作者。