告别环境配置地狱！UniApp Android 本地 一键打包神器

🚀 告别环境配置地狱！UniApp Android 一键打包神器

UniApp本地打包还在为环境配置、SDK版本、签名证书而头疼？这个Docker工具让你一条命令搞定所有问题！

🔗 项目地址：github.com/luckymiaow/...

🐳 Docker镜像：luckymiaow/uni-builder:latest

😵‍💫 UniApp本地打包的痛点

UniApp开发者都知道，HBuilder离线打包虽然灵活，但环境配置是个大坑：

• 环境复杂：Java、Android SDK、Gradle版本匹配困难
• HBuilder流程繁琐：获取appid → 配置平台信息 → 生成证书 → 导出资源 → 手动修改配置...
• 团队协作难：每个人环境不同，"我这里能跑"成了常态
• 重复劳动：每个项目都要重新配置一遍

💡 解决方案：Docker化的HBuilder离线打包

这个工具将HBuilder离线打包流程完全Docker化，让复杂的环境配置变成一条命令！

🎯 核心优势

• 零环境配置：无需安装Java、Android SDK、Gradle
• 流程标准化：将HBuilder离线打包流程模板化
• 配置驱动：JSON文件管理所有配置，告别手动修改
• 开箱即用：项目自带完整的测试模板

🛠️ 完整的HBuilder离线打包流程

传统HBuilder离线打包步骤

1. HBuilder中获取appid → __UNI__6309AD2
2. 后台管理配置 → dev.dcloud.net.cn/pages/app/d...
3. 生成签名证书 → 创建.keystore文件
4. 平台信息配置 → 录入证书信息，获取离线key
5. 导出前端资源 → 发行→原生app本地打包→生成本地打包app资源
6. 手动修改配置 → 各种XML、gradle文件
7. 环境配置构建 → 配置Java、SDK、Gradle环境
8. 执行打包命令 → gradle assembleRelease

Docker化的简化流程

只需3步，基于test模板快速开始：

# 1. 获取项目模板
git clone https://github.com/luckymiaow/uni-builder.git
cp -r uni-builder/test my-uniapp-project
cd my-uniapp-project

# 2. 替换你的资源（参考下面的详细说明）
# 3. 一键打包
docker run --rm -v ${PWD}:/workspace luckymiaow/uni-builder:latest

test模板包含：

• ✅ 完整配置示例 (config.json)
• ✅ 测试签名证书 (test.keystore)
• ✅ UniApp前端资源模板
• ✅ 已构建的示例APK

📋 如何替换成你的项目资源

基于test模板，你需要替换以下文件来打包你的UniApp项目：

1. 更新config.json配置

{
  "appName": "appName",
  "packageName": "com.unibuild.app",
  "compileSdkVersion": 30,
  "buildToolsVersion": "30.0.3",
  "versionCode": 20250101,
  "versionName": "1.0.0",
  "minSdkVersion": 21,
  "targetSdkVersion": 29,
  "multiDexEnabled": true,
  "sourceCompatibility": "1_8",
  "targetCompatibility": "1_8",
  "signingConfig": {
    "keyAlias": "testalias",
    "keyPassword": "test001",
    "storeFile": "test.keystore",
    "storePassword": "test001",
    "v1SigningEnabled": true,
    "v2SigningEnabled": true
  },
  "dcloudControl": {
    "appid": "__UNI__6309AD2",
    "appver": ""
  },
  "metaData": [
    {
      "name": "dcloud_appkey",
      "value": "903f19b802f544d2954a5dfeb0a6604c"
    }
  ]
}

2. 替换关键文件

# 复制你的签名证书
cp your-release.keystore override/simpleDemo/

# 复制HBuilder导出的前端资源
cp -r 你的前端资源目录/* override/simpleDemo/src/main/assets/apps/__UNI__你的APPID/

# 替换应用图标（可选）
cp your-icon.png override/simpleDemo/src/main/res/drawable/icon.png

3. 核心配置说明

• appid: HBuilder开发工具中获取
• dcloud_appkey: HBuilder后台"创建离线key"获取
• 签名证书: 使用keytool生成或HBuilder生成

🎯 实际应用场景

场景1：快速验证想法

# 5分钟出Demo
cp -r uni-builder/test quick-demo
cd quick-demo
# 只改appName和packageName
docker run --rm -v ${PWD}:/workspace luckymiaow/uni-builder:latest

场景2：团队协作标准化

# 团队成员基于同一模板工作
git clone https://github.com/luckymiaow/uni-builder.git
cp -r uni-builder/test team-project
cd team-project
# 每个人修改同样的config.json格式
# 环境完全一致，避免"我这里能跑"问题
docker run --rm -v ${PWD}:/workspace luckymiaow/uni-builder:latest

场景3：CI/CD自动化打包

# GitHub Actions / Jenkins 等CI系统
# 一条命令集成，无需复杂环境配置
docker run --rm -v ${{ github.workspace }}:/workspace luckymiaow/uni-builder:latest

� 与传统HBuilder离线打包对比

对比项	传统HBuilder离线打包	Docker化方案
环境配置	需要配置Java、Android SDK、Gradle	零配置，Docker一键解决
流程复杂度	8个步骤，容易遗漏	3个步骤，模板化
团队协作	环境不一致问题频出	环境完全一致
重复劳动	每个项目重新配置	模板复用，配置标准化
上手时间	半天到一天	10分钟
错误排查	环境、配置、版本问题复杂	问题定位简单

🌟 进阶技巧

1. 调试模式

# 查看完整项目结构，排查配置问题
docker run --rm -e DEBUG=true -v ${PWD}:/workspace luckymiaow/uni-builder:latest

2. 外部项目打包

# 如果你已有完整的Android项目
docker run --rm -v /path/to/your-android-project:/workspace luckymiaow/uni-builder:latest

3. CI/CD集成

# GitHub Actions示例
- name: Build UniApp Android
  run: docker run --rm -v ${{ github.workspace }}:/workspace luckymiaow/uni-builder:latest

🎯 总结

这个工具将复杂的HBuilder离线打包流程Docker化，实现了：

✅ 环境零配置 ：告别Java、SDK、Gradle配置地狱

✅ 流程标准化 ：8步骤简化为3步骤，模板化操作

✅ 团队协作 ：统一环境，解决"我这里能跑"问题

✅ 开箱即用：test目录提供完整示例，新手友好

如果你正在被HBuilder离线打包的环境问题折磨，强烈推荐试试这个工具！

🔗 立即开始

项目地址： github.com/luckymiaow/...

# 30秒体验
git clone https://github.com/luckymiaow/uni-builder.git
cd uni-builder/test
docker run --rm -v ${PWD}:/workspace luckymiaow/uni-builder:latest
# APK已生成在output/目录！

相关资源：

• 🐳 Docker镜像
• 📖 完整文档
• 🎯 模板配置

---

觉得有用就Star一下项目吧！遇到问题欢迎提Issue～