更新记录
1.0.3(2023-12-07) 下载此版本
增加项目模版
1.0.2(2023-12-07) 下载此版本
解决组件库无法显示问题
1.0.1(2023-08-08) 下载此版本
新增adb默认路径
查看更多平台兼容性
HBuilderX最低兼容版本 |
---|
3.2.10 |
HBuilderX插件通用注意事项
HBuilderX-2.7.12以下版本安装插件市场内的插件后,卸载时需手动卸载,详细教程参考:如何手动卸载插件
插件使用说明
简介
本插件针对HBuilderX现有uni-app打包调试环境进行强化,具备以下功能:
1.一键自定义发行
2.已发行项目打包
3.一键发行并导入android设备。
支持版本
HBuilderX 3.2.16+
如何安装
将hz-pack-plugin文件夹直接复制到HBuilderX安装程序目录plugin文件夹内,重启HBuilderX即可生效。
使用命令
下载:
git clone [项目git] /HBuilderX安装目录/plugins/hz-pack-plugin
更新:
git pull /HBuilderX安装目录/plugins/hz-pack-plugin
mac版
打开应用程序 -> 找到HBuilderX -> 右键显示包内容 -> 进入Contents/HBuilderX/plugins目录
快捷命令:open /Applications/HBuilderX.app/Contents/HBuilderX/plugins/
win版
找到HBuilderX应用图标 -> 右键属性 -> 点击打开文件位置 -> 进入/plugins目录
快捷命令:start HBuilderX安装目录/plugins/
如何配置
Mac:打开菜单栏HBuilderX
-> 偏好设置
-> 插件配置
Win:打开菜单栏 工具
-> 设置
-> 插件配置
注意:本插件需读取项目配置信息,因此打包所需文件对应目录必须包含package.json。
如何使用
先选中打开项目中的任意文件,点击顶部菜单发行
,菜单下方出现对应功能选项
自定义发行
本插件支持自定义发行功能,当使用发布功能时,需要对应根目录下存在package.json的配置,选择自定义发行类型。
{
"uni-app": {
"scripts": {
"platformDev": {
"title": "调试环境",
"BROWSER": "Chrome",
"env": {
"UNI_PLATFORM": "h5",
"VUE_APP_PLATFORMENV": "platformPro",
"SAFE_SWICHSAFE": false
}
},
"platformPro": {
"title": "生产环境",
"BROWSER": "Chrome",
"env": {
"UNI_PLATFORM": "h5",
"VUE_APP_PLATFORMENV": "platformPro",
"SAFE_SWICHSAFE": true
}
}
}
}
}
微应用发布打包
根据打包所需文件和打包输出目录执行发布后打包功能(支持自定义发布功能)
微应用仅打包
自动替换打包所需文件直接输出程序包。
微应用发布并导入android设备
发布完成后直接导入android设备配置的指定目录使用。
注意:当存在多台android设备,需选择对应设备导入。
uni-app打包流程
graph TB
subgraph 设备导入流程
31[开始]-->
32[读取package.json]-->
33[读取设备调试路径配置]-->
34[执行导入文件命令]-->
35[导入完成]-->
36[结束]
end
subgraph 配置打包流程
21[开始]-->
22[读取扩展文件路径]-->
23[复制扩展文件]-->
25[读取配置信息]-->
26[打包完成]-->
27[结束]
end
subgraph 发布编译流程
11[开始]-->
12[读取自定义配置]-->
13[自定义发布]-->
14[执行发布编译]-->
15[发布完成]-->
16[结束]
end
多渠道打包功能
激活
在项目根目录package.json文件中按以下方式配置
字段名 | 描述 |
---|---|
packFlavors | 多渠道打包配置 |
alias | 别名,配置后的打包文件名 |
asset | 渠道所需资源,需保持多个渠道文件数量一致,文件会互相覆盖,支持,分隔。 |
渠道1,渠道2 | 未配置别名,打包文件名后方自动添加(-渠道) |
示例
{
"packFlavors": {
"渠道1": {
"alias": "别名1",
"asset": "/flavors/way1"
},
"渠道2": {
"alias": "",
"asset": "/flavors/wai2"
}
}
}