更新记录

0.0.3（2025-09-16） 下载此版本

可自定义输出路径

0.0.2（2025-09-15） 下载此版本

修复路径问题

0.0.1（2025-09-15） 下载此版本

支持根据已有配置重命名插件

平台兼容性

HBuilderX插件通用注意事项

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

# APK 重命名插件使用说明

插件简介

这是一个专为 HBuilderX 开发的插件，用于自动重命名 UniApp 云打包后的 APK 文件。插件可以根据配置自动将 APK 文件重命名为更规范的格式，并复制到指定目录。

功能特性

• ✅ 自动读取 UniApp 项目的 manifest.json 配置
• ✅ 支持自定义 APK 文件命名规则
• ✅ 支持只处理最新生成的 APK 文件
• ✅ 自动创建目标目录并清空旧文件
• ✅ 文件名冲突自动处理（添加序号）
• ✅ 详细的处理日志输出
• ✅ 支持自定义输出路径（交互式选择或配置文件）
• ✅ 路径验证和错误处理

安装方法

1. 将插件文件夹复制到 HBuilderX 的插件目录
2. 在 HBuilderX 中启用插件
3. 重启 HBuilderX

配置说明

1. 创建配置文件

在项目根目录创建 apk-config.json 文件：

{
    "packageName": "com.example.app",
    "versionName": "1.0.0",
    "useDateFolder": true,
    "onlyLatestApk": true,
    "date": "",
    "customOutputPath": "dist/apk"
}

2. 配置参数说明

使用方法

通过 HBuilderX 右键菜单

1. 在 HBuilderX 中打开 UniApp 项目
2. 完成云打包后，在编辑器右键菜单中找到"重命名 APK"选项
3. 点击执行重命名操作

自定义输出路径

插件会从 apk-config.json 配置文件中读取 customOutputPath 字段作为自定义输出路径。如果配置文件中没有设置该字段，则使用默认的输出路径 unpackage/apkremix/。

在 apk-config.json 中添加 customOutputPath 字段：

{
    "packageName": "com.example.app",
    "versionName": "1.0.0",
    "useDateFolder": true,
    "onlyLatestApk": true,
    "date": "",
    "customOutputPath": "dist/apk"
}

路径类型说明：

• 相对路径: 相对于项目根目录，如 dist/apk、output/release
• 绝对路径: 完整的系统路径，如 /Users/username/Desktop/apk、C:\Users\username\Desktop\apk

文件路径说明

默认路径配置

• 源目录: unpackage/release/apk/ - UniApp 云打包生成的 APK 文件目录
• 目标目录: unpackage/apkremix/ - 重命名后的 APK 文件输出目录
• 配置文件: apk-config.json - 插件配置文件

命名规则

默认命名格式

{packageName}-{versionName}-{timestamp}.apk

示例

• 包名: com.example.app
• 版本: 1.0.0
• 时间戳: 20241201143025 (2024 年 12 月 1 日 14 点 30 分 25 秒)

最终文件名: com.example.app-1.0.0-20241201143025.apk

自定义命名

当 useDateFolder 为 false 且 date 字段有值时：

{packageName}-{versionName}-{date}.apk

当 useDateFolder 为 false 且 date 字段为空时：

{packageName}-{versionName}.apk

处理流程

1. 读取配置: 从 apk-config.json 读取配置参数
2. 读取 manifest: 从 manifest.json 读取应用信息
3. 准备目录: 创建并清空目标目录
4. 扫描 APK: 扫描源目录中的所有 APK 文件
5. 筛选文件: 根据 isLastDate 配置决定处理哪些文件
6. 重命名复制: 按照命名规则重命名并复制到目标目录
7. 冲突处理: 如果文件名已存在，自动添加序号

日志输出

插件会输出详细的处理日志，包括：

• 📁 路径信息
• 📱 APK 文件处理状态
• ⚠️ 警告信息
• ❌ 错误信息
• ✔ 成功信息
• 🎉 完成统计

常见问题

Q: 插件无法找到 APK 文件？

A: 请确保已经完成 UniApp 云打包，并且 APK 文件位于 unpackage/release/apk/ 目录中。

Q: 如何修改输出目录？

A: 可以通过构造函数参数或修改代码中的 targetDir 配置来指定自定义输出目录。

Q: 如何处理多个 APK 文件？

A: 将 isLastDate 设置为 false，插件将处理源目录中的所有 APK 文件。

Q: 文件名冲突怎么办？

A: 插件会自动检测文件名冲突，并在重复文件名后添加序号（如 _1, _2 等）。

技术支持

如有问题或建议，请通过以下方式联系：

• 查看 HBuilderX 官方文档: https://hx.dcloud.net.cn
• 提交 Issue 到项目仓库