HBuilderX 项目分组

更新记录

0.3.0（2024-05-11）下载此版本

新增在当前分组基础上打开其它额外分组

0.2.0（2024-04-29）下载此版本

修复路径在某些情况下不对的问题
优化切换分组速度

0.1.0-qualifier（2024-04-28）下载此版本

完成功能

平台兼容性

HBuilderX最低兼容版本
不确定

HBuilderX插件通用注意事项

HBuilderX-2.7.12以下版本安装插件市场内的插件后，卸载时需手动卸载，详细教程参考：如何手动卸载插件

本插件是仿照插件【项目分组】的分组操作理念改进而来的

提供非侵入式分组功能及一些额外的功能

非侵入式的意思是不会主动操作未被分组的项目，只有被添加到分组的项目才会在切换项目等操作时，被本插件关闭或打开

同一项目可以被多次添加到不同的分组

分组中的项目支持排序

插件功能及使用

功能一

添加项目到分组

选中要添加的项目（支持多选）
右键项目管理器弹出菜单，选择添加项目到分组...
在弹出的分组列表中选择目标分组（1. 输入框背景提示文件中会显示当前分组 2. 列表第一项为创建分组）
创建分组后会回到选择列表，以供继续选择

功能二

切换项目分组

选择顶部菜单文件-切换项目分组
在弹出的分组列表中选择目标分组（输入框背景提示文件中会显示当前分组）
选择后会关闭当前分组的所有项目并打开目标分组的所有项目

功能三

控件面板

选择顶部菜单文件-控制面板
在弹出的界面中提供了编辑当前分组中的项目的功能（排序、删除、备份）

功能四

打开分组

选择顶部菜单文件-打开分组
在弹出的分组列表中选择目标分组（输入框背景提示文件中会显示当前分组）
选择后会在当前打开的分组基础上再打开另一个分组，当前分组不变

其它

删除分组

为避免误操作导致分组丢失，本插件不支持手动删除分组

但是提供另一种方式删除分组：切换分组时删除空分组

字面意思，也就是在切换分组时，检测并删除空的分组

具体操作如下：

勾选开关偏好设置-插件配置-项目分组-HBuilderX 项目分组-切换分组后删除空分组
切换到需要删除的分组
打开控件面板
删除当前分组下所有项目
切换到其它分组（切换后空分组及空分组的项目备份都将被删除）

配置快捷键

将key中的值替换为自己的快捷键

// 添加项目到分组 快捷键
{
   "key": "alt+g",
   "command": "hx_project_group_cmd_add_project_to_group",
   "when": "explorerResourceIsWorkspaceFolder",
   "override": true
},
// 切换项目分组 快捷键
{
   "key": "f4",
   "command": "hx_project_group_cmd_switch_to_group",
   "override": true
},
// 打开控件面板 快捷键
{
   "key": "shift+f4",
   "command": "hx_project_group_cmd_group_controller",
   "override": true
},
// 打开分组 快捷键
{
   "key": "f6",
   "command": "hx_project_group_cmd_open_group",
   "override": true
}

测试

本插件只在Mac平台做了测试和深度使用

未在Windows平台测试，Windows平台极有可能会出现问题，后面有时间再找台Windows测试使用

所以现阶段

！！！Windows平台不要使用本插件！！！

重要的话说三遍

注意事项

切换项目使用的是HBuilderX提供的cli工具操作的，是异步操作

所以尽量不要在切换分组完成之前再次切换分组，尽管做了本地文件锁处理，但是在一些极端情况下还是可能会出现项目顺序混乱的问题

如果出现项目顺序混乱的问题，不要紧张，本插件是非入侵式分组，不会导致本地项目丢失，这时只需要再次尝试切换项目，就能拨乱反正

由于做了本地文件锁处理，如果在一些极端情况下导致锁文件未被及时清除，导致只要一操作右下角就弹窗提示当前有其它任务正在运行，请稍后再试，这时就需要手动删除锁文件

具体操作如下：

Mac

$ rm -f ~/Library/Application\ Support/HBuilder\ X/extensions/hx_project_group/index.lock

Windows 同上,路径是：%appdata%/HBuilder\ X/extensions/hx_project_group/index.lock

最后，如果还出现其它极端情况，请直接打开配置文件进行编辑

配置文件路径：

~/Library/Application\ Support/HBuilder\ X/extensions/hx_project_group/settings.json