当使用 jpackage 为 Java 应用程序创建 Windows 安装包时，默认的安装路径通常是固定的。本教程将指导您如何通过利用 `--win-dir-chooser` 选项，让用户在安装过程中能够自定义选择安装目录，从而为您的 Java 应用程序提供灵活且用户友好的安装体验。
理解 jpackage 与安装路径管理
jpackage 是 Java 14 及更高版本提供的一个强大工具，用于将 Java 应用程序打包成平台特定的安装包（如 Windows 上的 MSI、macOS 上的 DMG、Linux 上的 DEB/RPM）。在 Windows 环境下，默认情况下，jpackage 生成的安装程序会将应用程序安装到预设的目录，这通常位于 C:\Program Files 或 C:\Users\<username>\AppData\Local 下，具体取决于打包时的配置和权限。
许多用户希望在安装软件时能够自行选择安装目录，这不仅提供了灵活性，也符合常见的软件安装习惯。直接尝试使用 --dest "C:\Program Files" 这样的选项并不能解决用户自定义安装路径的问题，因为 --dest 参数是用来指定 jpackage 工具将生成的安装包文件（例如 .msi 文件）放置在哪里，而不是控制应用程序的最终安装位置。同时，尝试将安装包输出到受保护的系统目录（如 C:\ 或 C:\Program Files）通常会因为权限不足而失败。
解决方案：使用 --win-dir-chooser 选项
为了让最终用户在安装您的 Java 应用程序时能够选择安装目录，jpackage 提供了一个专门针对 Windows 平台的选项：--win-dir-chooser。
当您在 jpackage 命令中包含此选项时，生成的 Windows 安装程序（如 MSI）将在安装向导中提供一个界面，允许用户浏览并选择他们希望安装应用程序的目录。
实际操作示例
以下是一个完整的 jpackage 命令示例，演示了如何使用 --win-dir-chooser 选项来创建支持自定义安装路径的 Windows MSI 安装包：
jpackage --type msi \
--app-version "2.0" \
--input . \
--dest output \
--main-jar FitnessGUI.jar \
--main-class Main \
--win-shortcut \
--win-menu \
--win-dir-chooser命令参数解析：
- --type msi: 指定生成 Windows Installer (MSI) 格式的安装包。
- --app-version "2.0": 设置应用程序的版本号。
- --input .: 指定应用程序资源（如 JAR 文件、其他依赖项）的输入目录。这里的 . 表示当前目录。
- --dest output: 指定 jpackage 工具将生成的 MSI 安装包文件放置的目录。在本例中，它会创建一个名为 output 的子目录，并将 MSI 文件放在其中。请注意，这个目录是用来存放安装包本身的，而不是应用程序的最终安装位置。
- --main-jar FitnessGUI.jar: 指定应用程序的主 JAR 文件。
- --main-class Main: 指定应用程序的入口类（包含 main 方法的类）。
- --win-shortcut: 在 Windows 桌面上创建应用程序快捷方式。
- --win-menu: 在 Windows "开始" 菜单中创建应用程序条目。
- --win-dir-chooser: 核心选项。启用此选项后，生成的 MSI 安装程序将包含一个步骤，允许用户在安装过程中选择应用程序的安装目录。
执行上述命令后，jpackage 会在 output 目录下生成一个 FitnessGUI-2.0.msi（或类似名称）的安装包文件。当用户运行此 MSI 文件进行安装时，他们将看到一个额外的界面，可以浏览并选择应用程序的安装路径。
注意事项与最佳实践
- --dest 与 --win-dir-chooser 的区别： 务必区分这两个选项的作用。--dest 控制的是 jpackage 工具输出安装包文件的位置，而 --win-dir-chooser 控制的是安装包执行时应用程序的安装位置。
- 权限问题： 避免将 --dest 设置为受系统保护的目录（如 C:\ 或 C:\Program Files），因为 jpackage 在尝试写入这些目录时会遇到权限错误。始终将生成的安装包输出到一个用户有写入权限的目录，例如当前工作目录的子目录。
- 用户体验： 启用目录选择器可以显著提升用户体验，让用户对软件的安装位置有更多控制权。
- 平台特定性： --win-dir-chooser 是 Windows 平台特有的选项。对于 macOS 或 Linux，jpackage 提供了其他平台特定的选项来管理安装行为。
- 捆绑运行时： jpackage 默认会捆绑一个 Java 运行时环境（JRE），确保您的应用程序在没有预装 Java 的系统上也能运行。
总结
通过在 jpackage 命令中简单地添加 --win-dir-chooser 选项，您可以轻松地为您的 Windows Java 应用程序安装包提供用户自定义安装目录的功能。这不仅解决了默认安装路径的限制，也极大地提升了最终用户的安装体验，使您的应用程序更加灵活和易用。
