更新记录

0.0.2（2020-10-12）

• 修复动态修改package.json不生效的Bug

0.0.1（2020-10-01）

• 初始化项目

平台兼容性

HBuilderX插件通用注意事项

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

简介

HBuilderX现已内置uni_modules，用法更简单，此插件不再推荐使用。详情：uni_modules

本插件（为了区分概念以下称为：ex-package-management）主要为解决插件使用者更新插件非常麻烦的问题。现状是在不使用ex-package-management的情况下，插件作者发布新版之后，用户需要手动对照文件一一替换，ex-package-management可以简化此流程，用户只需要动手点点就能完成插件导入。

用法

ex-package-management仅支持遵循下面插件发布规范的插件

• 从插件市场安装ex-package-management插件到HBuilderX
• 从插件市场导入要使用的新版插件到HBuilderX
• 在要导入插件的项目根目录上右键选择并更新插件
• 在弹出界面选择第二步的导入的插件合并到所选项目内

插件发布规范（插件作者须知）

插件作者在发布插件时可以在示例项目根目录创建一个package.json，在package.json内添加一个version字段和一个files字段

version为当前插件的版本（暂时没用到，但是还是要加上）

files为用户需要导入的文件列表（支持通配符）

• *通配符表示任意非/字符串
• **通配符标识任意字符串

例：

注意：package.json内不可包含注释

// package.json
{
  "version": "0.0.1"
  "files":[
    "cloudfunctions-aliyun/**", // cloudfunctions-aliyun下的所有文件
    "store/*.js" // store下的所有js文件
  ]
}

插件使用者须知

ex-package-management仅支持遵循上述插件发布规范的插件。

• 在导入插件时ex-package-management会对文件进行简单的对比，自动跳过相同的文件
• 文件冲突时会有以下四个选项
  • 取消：取消导入操作
  • 重命名：自动将插件中冲突文件重命名为xxx(1).ext、xxx(2).ext的形式，放在项目中冲突文件的同级目录
  • 覆盖：直接覆盖项目中所有冲突文件
  • 手动：自行选择每个文件的导入方式
• 选择手动时，对每个冲突文件都有以下三个选项
  • 跳过：跳过当前文件
  • 重命名：自动将插件中冲突文件重命名为xxx(1).ext、xxx(2).ext的形式，放在项目中冲突文件的同级目录
  • 覆盖：直接覆盖项目中的冲突文件

使用限制

• 包含cloudfunctions目录时需要用户手动将项目的cloudfunctions目录修改为和插件一致，再进行导入操作。（阿里云：cloudfunctions-aliyun，腾讯云：cloudfunctions-tcb）

TODO

• [ ] 优化cloudfunctions的导入
• [ ] 卸载插件
• [ ] 文件diff？