更新记录

1.0.0（2026-02-27） 下载此版本

v1.0.0 (首次发布)

  • 支持自动记录uni-app小程序打包版本信息
  • 自动递增版本号(versionCode和versionName)
  • 自动更新manifest.json中的版本号
  • 自动获取HBuilderX版本号
  • 自动检测微信开发者工具版本号
  • 自动使用系统登录用户名作为打包人员
  • 提供快速记录和自定义记录两种模式
  • 记住用户偏好设置
  • 生成Markdown格式的打包历史表格
  • 生成JSON格式的版本数据文件

平台兼容性

HbuilderX/cli最低兼容版本
不确定

HBuilderX插件通用注意事项

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

HBuilderX 打包版本记录器

自动记录uni-app小程序打包版本信息的HBuilderX插件,支持自动版本号递增、智能信息记录。

功能特性

  • ✅ 自动记录打包版本信息到BUILD_HISTORY.md和.build-version.json
  • ✅ 自动递增版本号(versionCode和versionName)
  • ✅ 自动更新manifest.json中的版本号
  • ✅ 自动获取HBuilderX版本号
  • ✅ 自动检测微信开发者工具版本号
  • ✅ 自动使用系统登录用户名作为打包人员
  • ✅ 支持快速记录和自定义记录两种模式
  • ✅ 记住用户偏好设置(打包人员等)

安装方法

  1. 将hbuilderx-build-version-recorder文件夹复制到HBuilderX插件目录:

    • Windows: HBuilderX安装目录/plugins/
    • Mac: HBuilderX.app/Contents/HBuilderX/plugins/

  2. 重启HBuilderX

  3. 插件激活后会显示提示信息

使用方法

方式一: 工具菜单

点击菜单栏【工具】→【记录打包版本信息】

方式二: 右键菜单

在编辑器中右键选择【记录打包版本信息】

快速记录模式(推荐)

  1. 执行命令后,选择"快速记录"
  2. 插件自动完成:
    • 版本号自动递增(如1.0.0→1.0.1)
    • versionCode自动+1
    • 使用系统用户名作为打包人员
    • 自动检测HBuilderX和微信开发者工具版本
    • 更新manifest.json
    • 记录到历史文件

自定义模式

  1. 执行命令后,选择"自定义版本号"
  2. 可以选择:
    • 修订号+1 (1.0.0→1.0.1)
    • 次版本号+1 (1.0.0→1.1.0)
    • 主版本号+1 (1.0.0→2.0.0)
    • 手动输入版本号
  3. 可以修改打包人员(修改后会记住)
  4. 可以添加备注信息

版本号规则

  • versionName: 遵循语义化版本规范 (主版本号.次版本号.修订号)
    • 主版本号: 重大功能变更或不兼容的API修改
    • 次版本号: 新增功能,向下兼容
    • 修订号: bug修复,向下兼容
  • versionCode: 每次打包自动递增的整数,用于版本比较

生成的文件

BUILD_HISTORY.md

Markdown格式的打包历史记录表格,包含:

  • 打包日期时间
  • 小程序版本号
  • versionCode
  • HBuilderX版本
  • 微信开发者工具版本
  • 打包人员
  • 备注信息

.build-version.json

JSON格式的版本信息,包含:

  • lastBuild: 最后一次打包信息
  • history: 最近20次打包历史记录

.build-config.json

用户配置文件,保存:

  • 打包人员姓名偏好
  • 其他用户自定义配置

查看打包历史

点击菜单栏【工具】→【查看打包历史】,或在编辑器右键选择【查看打包历史】

自动检测说明

HBuilderX版本

通过hx.env.appVersion自动获取当前HBuilderX版本号

微信开发者工具版本

自动检测以下路径:

  • C:\Program Files (x86)\Tencent\微信web开发者工具
  • C:\Program Files\Tencent\微信web开发者工具
  • %LOCALAPPDATA%\Programs\微信web开发者工具
  • Windows注册表中的安装路径

读取package.nw/package.json获取版本号

打包人员

默认使用系统登录用户名(%USERNAME%),首次可以修改并保存偏好

最佳实践

  1. 每次打包前记录: 养成打包前先记录版本的习惯
  2. 使用快速模式: 日常打包使用快速记录,一键完成
  3. 重要版本使用自定义: 发布重要版本时使用自定义模式,添加详细备注
  4. 版本号规范: 遵循语义化版本规范,让版本号有意义
  5. 提交到Git: 将BUILD_HISTORY.md和.build-version.json提交到版本控制

注意事项

  • 插件会自动修改manifest.json中的版本号
  • .build-config.json包含个人配置,建议加入.gitignore
  • 确保在uni-app项目根目录下使用(包含manifest.json的目录)

版本历史

v1.0.0

  • 初始版本发布
  • 支持自动版本号递增
  • 支持快速记录和自定义模式
  • 自动检测HBuilderX和微信开发者工具版本

隐私、权限声明

1. 本插件需要申请的系统权限列表：

文件系统读写权限

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明：

插件不采集任何数据。 插件仅在本地读取和写入文件,包括: - 读取项目的manifest.json文件获取版本信息 - 读取系统环境变量获取用户名(仅用于本地记录) - 读取微信开发者工具安装目录获取版本号(仅用于本地记录) - 在项目目录下生成BUILD_HISTORY.md、.build-version.json、.build-config.json文件 所有数据均保存在用户本地,不会上传到任何服务器。

3. 本插件是否包含广告，如包含需详细说明广告表达方式、展示频率：

无

许可协议

MIT License

Copyright (c) 2024 sparksleo

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

评论列表 撰写评论 向官方投诉

暂无用户评论。