更新记录

1.0.3（2023-12-07）

增加项目模版

1.0.2（2023-12-07）

解决组件库无法显示问题

1.0.1（2023-08-08）

新增adb默认路径

平台兼容性

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": {
        "渠道1": {
            "alias": "别名1",
            "asset": "/flavors/way1"
        },
        "渠道2": {
            "alias": "",
            "asset": "/flavors/wai2"
        }
    }
}