告别环境配置地狱！UniApp Android Docker本地一键打包神器UniApp本地打包还在为环境配置、SDK

🚀 UniApp Android 一键打包神器：3步搞定离线打包

不想再为 Java、SDK、Gradle 配环境而浪费时间？
用这个 Docker 工具，3步就能打出 APK，不用装任何依赖！

🔗 项目地址： github.com/luckymiaow/…
🐳 Docker 镜像： luckymiaow/uni-builder:latest

⚡ 一键打包：3 步快速开始

无需任何复杂配置，只要 3 步：

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

# 2. 替换你的资源（config.json + 前端资源 + keystore）

# 3. 一键打包
docker run --rm -v ${PWD}:/workspace luckymiaow/uni-builder:latest

✅ 打包完成后，APK 会自动生成在 output/ 目录。
👉 不需要安装 Java / Android SDK / Gradle，直接用 Docker 一键完成！

镜像中没有内置 gradle，所以每次都会下载，可以使用

# 将gradle缓存到本机用户目录 -v $env:USERPROFILE/.gradle:/root/.gradle
docker run --rm -v $env:USERPROFILE/.gradle:/root/.gradle -v ${PWD}:/workspace luckymiaow/uni-builder:latest

🧰 替换你的项目资源

在 test 模板的基础上，你只需替换几处内容即可完成项目定制：

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 dist/* override/simpleDemo/src/main/assets/apps/__UNI__你的APPID/

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

🤔 为什么 3 步就能打包？

因为这个工具把 HBuilder 离线打包的全部复杂流程都封装进了 Docker，所有环境、依赖和配置都已集成，不受本机系统影响。

🛠️ 传统打包流程（8 步）：

安装 Java、SDK、Gradle
生成 keystore
配置签名信息
获取 appid 和离线 key
导出前端资源
修改 XML/Gradle 配置
配置环境、命令行打包
调试各种环境和版本问题

✅ Docker 方案（3 步）：

下载模板
替换配置
一键打包

所有复杂的 Java / Android SDK / Gradle 环境都预装在镜像里，一次配置，全平台通用。

📋 传统流程 vs Docker 化方案

项目	传统 HBuilder 离线打包	Docker 化方案
环境配置	手动安装 Java、SDK、Gradle	不需要
步骤数量	8 步，容易出错	3 步，全自动
团队协作	各自环境不同	完全一致
重复劳动	每个项目都要配置	模板化复用
错误排查	环境问题多且难查	容器内统一环境
上手时间	半天～一天	10 分钟

💡 实际应用场景

🚀 快速验证原型

5 分钟出 Demo：

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

👨‍💻 团队协作标准化

# 所有成员基于相同模板
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

🤖 CI/CD 自动化集成

直接嵌入 GitHub Actions / Jenkins，无需配置任何环境：

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

🧪 调试 & 进阶用法

1. 调试模式

查看容器内的完整构建日志：

docker run --rm -e DEBUG=true -v ${PWD}:/workspace luckymiaow/uni-builder:latest

2. 打包已有 Android 项目

如果你已经有完整的 Android 项目，也可以直接用这个镜像：

docker run --rm -v /path/to/your-android-project:/workspace luckymiaow/uni-builder:latest

📦 开始使用

# 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/ 目录

资源链接：

✅ 总结

🚀 3 步出 APK：模板化流程，一键构建
🛠️ 零环境配置：无需安装任何依赖
👨‍💻 团队统一环境：解决“我这里能跑”问题
🤖 支持 CI/CD：自动化打包无缝集成

如果你正在被 HBuilder 离线打包的环境问题折磨，这个工具就是你最省心的解决方案！

⭐ 觉得有用请点 Star 支持一下！
📬 有问题可直接提 Issue 反馈。

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