🚀 UniApp Builder - 高效多端打包与运行工具

UniApp Builder 是一款专为 UniApp 开发者打造的 Visual Studio Code 扩展插件。它打破了传统必须依赖 HBuilderX 图形界面进行打包的限制，让您直接在 VS Code 中即可完成从开发到多端发布的全流程。

✨ 核心亮点

• 🚫 无需 HBuilderX：彻底摆脱对 HBuilderX IDE 的依赖，所有打包和运行操作均在 VS Code 内完成，保持开发环境统一。
• 🔒 免登录 & 内网友好：不需要登录 DCloud 账号即可进行本地打包，完美支持内网/离线环境开发，保障代码安全与合规。
• 🌐 全平台支持：一键覆盖主流平台，包括：
  • ⚡️ 小程序：微信、支付宝、百度、字节跳动、QQ 等
  • 🌍 Web：H5
  • 📱 移动端：Android / iOS App (云打包或本地打包)
• ⚙️ 智能配置读取：自动解析项目根目录下的 manifests.json，根据您现有的 UniApp 配置自动匹配打包参数。
• 📦 支持条件编译：支持读取 package.json 中的自定义条件编译配置，灵活应对复杂的多端构建场景。

🛠️ 快速开始

1. 前置准备

在使用本插件前，请确保您的开发环境中已安装HBuilderX（仅作为底层引擎使用，无需打开界面）。

2. 关键配置 (必读)

插件需要知道 HBuilderX 的安装位置以调用底层构建能力。请在 VS Code 中进行以下设置：

1. 打开 VS Code 设置 (Ctrl + , 或 Cmd + ,)。
2. 搜索 uniapp-builder。
3. 找到 **Hbuilder X Path
4. 根据您的操作系统填入正确的路径：
   • Windows: 例如 D:\Program Files\HBuilderX
   • macOS: 例如 /Applications/HBuilderX.app

   💡 提示：路径错误将导致打包失败，请务必仔细核对。

3. 使用方式

• 打包项目：打开项目中任意文件右击鼠标，选择uniapp发布
• 运行预览：打开项目中任意文件右击鼠标，选择uniapp运行
• 自定义构建：插件会自动读取 manifests.json 和 package.json 中的配置，无需额外编写复杂的构建脚本。

📝 适用场景

• 团队协作：统一使用 VS Code 作为唯一开发工具，降低切换成本。
• 安全合规：企业内网环境无法访问外网或禁止登录第三方账号时的首选方案。
• CI/CD 集成：易于集成到自动化构建流程中，实现脚本化打包。
• 轻量级开发：不喜欢重型 IDE，偏好 VS Code 轻量、插件化体验的开发者。

❓ 常见问题

Q: 为什么还需要安装 HBuilderX？ A: 本插件调用的是 HBuilderX 底层的 CLI 构建引擎，这是目前 UniApp 官方最稳定的编译核心。您只需安装它作为“编译器”，日常开发完全不需要打开 HBuilderX 界面。

Q: 支持自定义 H5 域名配置吗？ A: 支持。插件会直接读取您项目中 manifests.json 的配置，请确保该文件配置正确。