本文档记录了从零开始下载、安装 InstallBuilder 试用版,并通过图形界面(GUI)和命令行(CLI)成功构建一个跨平台安装程序的完整流程。
一、 下载与安装
获取安装包:访问 InstallBuilder 官网,注册并下载 macOS 版本的安装包(
installer.dmg)。安装软件:双击打开
.dmg文件,将 InstallBuilder 图标拖入Applications(应用程序)文件夹。默认安装路径:安装完成后,软件的核心文件会位于
/Applications/InstallBuilder Enterprise 26.8.0/。其中:bin/Builder.app是图形界面程序。bin/builder是用于 CI/CD 无头构建的命令行工具。
二、 启动与创建 Demo 项目 (GUI)
打开
Builder.app,你将看到欢迎界面。在欢迎界面中,点击"basic demo project"(基础演示项目)链接。
在弹出的
New Project窗口中,你可以保持默认设置(Product Name 为Demo Project,Version 为1.0),直接点击OK。进入主界面后,点击顶部菜单栏的File -> Save As...,将该项目保存到桌面,命名为
demo.xml。
三、 终端命令行构建(Headless Build 验证)
为了验证是否满足 CI/CD 无头构建的要求,我们使用终端通过命令行生成安装包。
打开 macOS 终端(Terminal),进入 InstallBuilder 的 bin 目录:
bash
cd /Applications/InstallBuilder\ Enterprise\ 26.8.0/bin
执行构建命令,指定刚才保存在桌面的
demo.xml:bash
./builder build ~/Desktop/demo.xml
观察终端输出。当进度条达到 100% 并出现
Built with an evaluation version of InstallBuilder时,说明构建成功。查找产物:默认情况下,生成的安装包会保存在软件自身的
output目录下,路径为:/Applications/InstallBuilder Enterprise 26.8.0/output/
你可以看到生成了名为demo-1.0-osx-installer.app的文件。
四、 运行生成的安装程序 (原生体验验证)
双击运行
demo-1.0-osx-installer.app。你将看到一个完全原生风格的 Mac 安装向导。向导包含欢迎界面、安装路径选择、准备安装等标准步骤。这证明了它生成的程序具有原生的 UI 体验。
五、 进阶:一键跨平台构建 (CI/CD 核心场景)
InstallBuilder 的强大之处在于,你可以在一台 Mac 上,通过命令行一次性生成 Windows 和 Linux 的安装包。
在终端中,继续执行以下命令,指定目标平台为
windows-x64,并指定输出到桌面:bash
./builder build ~/Desktop/demo.xml windows-x64 --setvars project.outputDirectory=~/Desktop/output
接着执行以下命令,指定目标平台为
linux-x64:bash
./builder build ~/Desktop/demo.xml linux-x64 --setvars project.outputDirectory=~/Desktop/output
完成上述两条命令后,打开桌面的
output文件夹。你会发现里面同时包含了:Mac 安装包:
demo-1.0-osx-installer.appWindows 安装包:
demo-1.0-windows-x64-installer.exeLinux 安装包:
demo-1.0-linux-x64-installer.run
六、 结论与评估建议
通过以上流程,验证了 InstallBuilder 具备以下特性:
高度可用:图形界面直观,易于上手创建项目。
原生体验:生成的安装包 UI 完全适配目标操作系统。
无头构建支持:命令行 (
./builder) 运行稳定,支持--setvars动态注入变量,完美适配 CI/CD 流水线(如 Jenkins, GitLab CI)。强大的跨平台能力:支持从单一构建机(Mac)一键输出 Windows、Linux、Mac 全平台产物。
待确认事项:当前使用的是试用版,生成的安装包包含 "evaluation version" 水印。正式投入生产前,需采购企业版 License,并在 CI 流水线中通过--license参数挂载 License 文件。