更新记录

1.0.18(2024-07-10)

  • 修复 mac 环境jdk路径转义问题。
  • 优化打包失败提示,新增手动打包的命令。
  • 优化其他已知问题。

1.0.17(2024-07-08)

  • 新增模块配置持久化存储,解决重启后打开插件配置界面导致配置丢失的问题。
  • 插件配置新增 模块配置是否按照项目单独缓存
  • 优化打包流程,解决部分情况下环境变量设置不生效的问题。
  • 新增 nativeResources 资源同步,解决 uni-push app-android平台高级场景用途 资源无法同步的问题。
  • 优化其他已知问题。

1.0.16(2024-07-07)

  • 更新内置依赖列表,新增 uni-rpx2pxuni-getProvideruni-theme 基础模块。
查看更多

平台兼容性

HBuilderX最低兼容版本
4.18.0

HBuilderX插件通用注意事项

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


# kux-easy-pack-hxp 一个用来给 uniapp/x 打包自定义调试基座的hx插件,为了大幅度简化离线打包流程,让更多开发者们享受到离线打包自定义基座的丝滑体验。

插件特色

  • 自动化合并本地打包资源
  • 支持 Github Actions 自动打包
  • 支持离线自动打包
  • 自动生成自定义调试基座到项目中
  • 人性化打包错误输出
  • 人性化打包进度输出
  • 支持自动更新SDK
  • 支持自动同步本地模块
  • 支持全局可视化配置
  • 支持可视化模块配置
  • 支持自动检测打包环境
  • ...

提示

选择云端打包时页面内容要有更新才能提交git,不然会提交失败。
v1.0.5 及以上版本支持 windows 打包。 预计 v1.1.0 及以上版本支持 uniapp 打包。

插件运行方式

  • 右键菜单->kux自定义打包
  • 顶部运行菜单->kux自定义打包

全局可视化配置

插件提供了全局可视化配置。点击 设置-插件配置 即可看到 kux自定义打包 配置内容。 kux自定义打包可视化配置

  • Android离线打包SDK下载地址:Android离线打包SDK下载地址。详情
  • 原生工程仓库地址:请 fork uniappx-native-android 项目到自己的 github 仓库后填写代码仓库的ssh协议地址。(示例:git@github.com:kviewui/uniappx-native-android.git)
  • 安卓SDK路径:如未安装请到 https://developer.android.google.cn/studio 下载。默认会获取全局的 uts开发扩展-Android 的安卓sdk路径。
  • JDK路径:如果安装了android studio,则为安装目录的jbr路径,(示例: %安装路径%\jbr)
  • 自动验证SDK版本:勾选后插件会在进入打包前自动验证SDK版本和编译器版本,如果不一致会终止下面的流程。

打包配置说明

云端密钥配置

选择 Github 云端打包 时,需要先配置参考密钥信息,配置地址:

https://github.com/{账户名}/uniappx-native-android/settings/secrets/actions

需要将上面的仓库名替换为自己的,比如仓库名为 bob,完整地址即为:https://github.com/bob/uniappx-native-android/settings/secrets/actions
然后在 Repository secrets 板块点击 New repository secret 创建自己的密钥,名称必须为 KEYSTORE_PASSWORD

项目模块配置

项目内置模块可以参考 modules,在比如 uni-aduni-push 等模块时需要获取这些模块需要的 appId 等信息,所以提供了在项目 manifest.json 配置方式。具体字段说明参考如下:

应用版本信息

应用版本信息字段全部在 manifest.json 跟节点设置。

字段名 说明
name 应用名称,会自动替换原生工程的 app_name,默认为 uniapp x
versionName 版本名称,默认为 1.0.0
versionCode 版本号,默认为 100

内置模块信息

内置模块信息字段在 manifest.jsonapp -> distribute -> modules 节点下设置。

字段名 说明
uni-ad uni-ad 模块信息,对象形式。
- gdt uni-ad 模块的 gdt 节点,腾讯优量汇广告联盟配置内容。对象形式,如:"dgt":{}
- gm uni-ad 模块的 gm 节点,穿山甲配置内容。对象形式,如:"gm":{}
- ks uni-ad 模块的 ks 节点,快手配置内容。对象形式,如:"ks":{}
- bd uni-ad 模块的 bd 节点,百度配置内容。对象形式,如:"bd":{}
- sigmob uni-ad 模块的 sigmob 节点,sigmob配置内容。对象形式,如:"sigmob":{}
- DCLOUDUnionId uni-ad 模块的 DCLOUDUnionId 节点,联盟ID值,示例:DCLOUDUnionId: "xxx"。联盟ID位于:uni-AD后台->首页->联盟ID
uni-facialRecognitionVerify uni-facialRecognitionVerify 模块信息,对象形式。如:"uni-facialRecognitionVerify":{}
uni-payment uni-payment 模块信息,对象形式。
- alipay uni-payment 模块的 alipay 节点。对象形式,如:"alipay":{}
- wxpay uni-payment 模块的 wxpay 节点。对象形式,如:"wxpay":{}
uni-push uni-push 模块信息,对象形式。
- GETUI_APPID uni-push 模块的 GETUI_APPID 节点,示例:"GETUI_APPID":"xxx"。参考:uni-push2.0配置
- PUSH_APPID uni-push 模块的 PUSH_APPID 节点,为示例:"PUSH_APPID":"xxx"。参考:uni-push2.0配置
- dcloud_unipush_auto_notification uni-push 模块的 dcloud_unipush_auto_notification 节点,示例:"dcloud_unipush_auto_notification":true。透传时是否自动创建通知,布尔类型。
- MIPUSH_APPID uni-push 模块的 MIPUSH_APPID 节点,示例:"MIPUSH_APPID":"xxx"。参考:uni-push2.0配置
- MIPUSH_APPKEY uni-push 模块的 MIPUSH_APPKEY 节点,示例:"MIPUSH_APPKEY":"xxx"。参考:uni-push2.0配置
- MEIZUPUSH_APPID uni-push 模块的 MEIZUPUSH_APPID 节点,示例:"MEIZUPUSH_APPID":"xxx"。参考:uni-push2.0配置
- MEIZUPUSH_APPKEY uni-push 模块的 MEIZUPUSH_APPKEY 节点,示例:"MEIZUPUSH_APPKEY":"xxx"。参考:uni-push2.0配置
- OPPOPUSH_APPKEY uni-push 模块的 OPPOPUSH_APPKEY 节点,示例:"OPPOPUSH_APPKEY":"xxx"。参考:uni-push2.0配置
- OPPOPUSH_APPSECRET uni-push 模块的 OPPOPUSH_APPSECRET 节点,示例:"OPPOPUSH_APPSECRET":"xxx"。参考:uni-push2.0配置
- HUAWEI_APPID uni-push 模块的 HUAWEI_APPID 节点,示例:"HUAWEI_APPID":"xxx"。参考:uni-push2.0配置
- VIVO_APPID uni-push 模块的 VIVO_APPID 节点,示例:"VIVO_APPID":"xxx"。参考:uni-push2.0配置
- VIVO_APIKEY uni-push 模块的 VIVO_APIKEY 节点,示例:"VIVO_APIKEY":"xxx"。参考:uni-push2.0配置
- HIHONOR_APPID uni-push 模块的 HIHONOR_APPID 节点,示例:"HIHONOR_APPID":"xxx"。参考:uni-push2.0配置
uni-video uni-video 模块信息,对象形式。如:"uni-video":{}
uni-verify uni-verify 模块信息,对象形式。如:"uni-verify":{}
- GETUI_APPID uni-verifyGETUI_APPID 节点,示例:"GETUI_APPID":"xxx"GETUI_APPIDGY_APP_ID开发者中心->一键登录->基础配置->一键登录应用ID,GETUI_APPID与GY_APP_ID取值相同。
- GY_APP_ID uni-verifyGY_APP_ID 节点,示例:"GY_APP_ID":"xxx"GETUI_APPIDGY_APP_ID开发者中心->一键登录->基础配置->一键登录应用ID,GETUI_APPID与GY_APP_ID取值相同。
  • 以上配置内容已被插件视图化操作替代。

已知问题

  • 重复打包时无法自动关闭对话框,需要手动点击 取消。(v1.0.13及以上版本已修复)

隐私、权限声明

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

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

插件不采集任何数据

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

许可协议

MIT协议

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