更新记录

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"
        }
    }
}

隐私、权限声明

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

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

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

许可协议

MIT协议

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问