从Jar到服务：使用Advanced Installer打造一体化Windows EXE安装包

1. 为什么需要将Jar包转为EXE安装包

当你开发了一个Spring Boot应用，最终会得到一个可执行的Jar文件。这个Jar文件在开发环境中运行很简单，只需要在命令行执行java -jar your-app.jar就能启动。但在实际生产环境中，特别是面向普通用户部署时，这种方式就显得不够友好和专业了。

想象一下，你需要给客户部署一个Java应用。如果只是简单地把Jar文件发给他们，客户可能会遇到这些问题：不知道如何启动、需要手动配置Java环境、每次重启电脑后都要手动重新启动应用。更糟糕的是，如果客户完全没有技术背景，可能连命令行都不知道怎么打开。

这就是为什么我们需要将Jar包打包成专业的Windows安装包（EXE）并注册为系统服务。这样做的好处很明显：

• 一键安装：用户只需双击安装包，就能完成所有配置和安装
• 自动环境检测：安装程序可以自动检测并安装必要的Java运行环境
• 后台服务运行：应用可以作为Windows服务自动启动，无需用户干预
• 专业形象：给用户提供标准的安装体验，提升产品专业度

Advanced Installer正是解决这个问题的利器。它不仅能打包EXE安装包，还能帮我们处理Java环境依赖、设置环境变量、注册系统服务等一系列复杂操作。

2. Advanced Installer基础配置

2.1 创建新项目

首先打开Advanced Installer，选择"新建项目"。在项目类型中选择"安装程序"，然后选择"通用模板"。建议给项目起一个清晰的名字，比如"YourAppInstaller"。

在产品信息页面，需要填写一些基本信息：

• 产品名称：用户看到的应用程序名称
• 版本号：遵循语义化版本规范（如1.0.0）
• 发布者：你的公司或组织名称
• 软件图标：建议上传一个专业的ICO图标文件

这些信息不仅会显示在安装过程中，还会写入系统的"添加/删除程序"列表，所以要认真填写。

2.2 添加应用程序文件

在"资源"模块中，我们需要添加应用程序的Jar文件和其他必要资源。点击"文件和文件夹"选项卡，右键"应用程序文件夹"，选择"添加文件"，然后选择你的Spring Boot Jar文件。

这里有个实用技巧：如果你有多个相关文件（如配置文件、脚本文件等），可以创建一个子文件夹来组织它们。右键点击"应用程序文件夹"，选择"新建文件夹"，命名为"bin"或"lib"之类的名称，然后把相应文件放进去。

特别重要的是：确保勾选"同步磁盘中的文件夹内容"选项。这样当你的源文件发生变化时，Advanced Installer会自动更新打包内容，不需要每次都手动重新添加。

3. 配置Java运行环境

3.1 设置必要条件

Java应用需要JRE或JDK才能运行，我们需要确保目标机器上有合适的Java环境。在"必要条件"模块中，选择"基于特征→新建包的运行环境"。

这里有几个关键配置：

1. 选择准备好的JDK/JRE安装包（可以是离线安装包或在线下载链接）
2. 在"安装命令行"中填写"/s"实现静默安装
3. 设置Windows版本要求（通常只选64位系统）
4. 添加Java环境检测条件：
   • 注册表项：HKLM\SOFTWARE\JavaSoft\Java Runtime Environment
   • 注册表值：HKLM\SOFTWARE\JavaSoft\Java Runtime Environment\CurrentVersion

建议勾选"只有在所有条件错误时才安装"和"评估64位计算机上的条件是使用64位的设置"这两个选项，这样可以避免不必要的Java环境重复安装。

3.2 配置环境变量

为了让系统能找到Java命令，我们需要设置PATH环境变量。在"系统更改"模块中，右键点击"环境变量"，选择"新建变量"。

配置如下：

• 名称：Path
• 值：C:\Program Files\Java\jre1.8.0_311\bin（根据你的Java版本调整）
• 组件：java8（或其他有意义的名称）
• 勾选"系统变量"

这样安装程序会自动将Java的bin目录添加到系统PATH中，确保任何地方都能执行java命令。

4. 注册Windows服务

4.1 准备服务脚本

要将Spring Boot应用注册为Windows服务，我们需要准备一个批处理脚本。创建一个install.bat文件，内容大致如下：

@echo off set SERVICE_NAME=YourAppService set JAR_PATH=%~dp0your-app.jar set JAVA_HOME="C:\Program Files\Java\jre1.8.0_311" sc create %SERVICE_NAME% binPath= "%JAVA_HOME%\bin\java.exe -jar %JAR_PATH%" start= auto sc description %SERVICE_NAME% "Your Application Description" net start %SERVICE_NAME%

同样，创建一个uninstall.bat用于卸载服务：

@echo off set SERVICE_NAME=YourAppService net stop %SERVICE_NAME% sc delete %SERVICE_NAME%

将这些脚本文件添加到Advanced Installer的"资源"模块中，放在应用程序文件夹内。

4.2 配置自定义操作

在"自定义行为"模块中，我们需要设置安装和卸载时执行这些脚本。点击"自定义操作"，然后"添加自定义操作→启动文件"。

对于安装脚本：

1. 选择install.bat文件
2. 重命名为有意义的名称，如"InstallService"
3. 勾选"隐藏程序窗口"和"以管理员身份运行"
4. 执行时间：立即
5. 执行选项：自定义操作来完成，然后继续等待
6. 执行序列条件：勾选"安装"和"第一次安装"

对于卸载脚本，配置类似，但执行序列条件改为勾选"卸载"和"定期卸载"。

5. 构建和测试安装包

5.1 构建配置

在"构建"模块中，有几个重要设置：

• 封装类型：选择"单个EXE"（最简单方便）
• 安装包生成位置：选择一个输出目录
• 安装包名称：如YourApp_Setup.exe
• 图标：可以选择一个专业的安装程序图标

建议勾选"以管理员身份运行"，因为注册服务和修改环境变量都需要管理员权限。

5.2 测试安装包

构建完成后，强烈建议在干净的测试环境中进行安装测试。检查以下几个方面：

1. 安装过程是否流畅，没有错误提示
2. Java环境是否正确安装（如果没有的话）
3. 应用程序是否成功注册为Windows服务
4. 服务是否自动启动
5. 环境变量是否正确设置
6. 卸载程序是否能完全清理

我遇到过的一个常见问题是服务启动失败，通常是因为Java路径不正确或Jar文件路径包含空格。这时候可以查看Windows事件查看器中的应用程序日志，里面通常会有详细的错误信息。

6. 进阶技巧和问题排查

6.1 处理依赖组件

如果你的应用依赖MySQL、Redis等组件，也可以通过Advanced Installer打包。基本思路是：

1. 将这些组件的安装程序作为资源添加
2. 创建静默安装的批处理脚本
3. 在"自定义行为"中设置适当的执行顺序

不过要注意组件之间的依赖关系，比如数据库应该先于应用服务安装。

6.2 服务启动失败排查

当服务启动失败时，可以尝试以下排查步骤：

1. 手动执行java -jar命令，看是否有错误输出
2. 检查服务的登录身份是否有足够权限
3. 查看Windows事件查看器中的错误日志
4. 确保Jar文件的路径不包含中文或特殊字符

一个实用的调试技巧是在批处理脚本中添加日志输出，将关键信息写入文本文件，这样即使服务启动失败也能看到原因。

6.3 版本升级策略

当发布新版本时，需要考虑升级策略：

1. 在"产品信息"中更新版本号
2. 设置升级规则（通常是卸载旧版本后安装新版本）
3. 考虑数据迁移问题（如果有配置文件或数据库）

可以在"安装参数"中设置"升级代码"，这样Windows安装程序会自动处理版本升级。