jpackage 自带 --win-dir-chooser 参数，可直接在 Windows MSI 安装流程中插入标准的“目标文件夹选择”对话框，无需手动修改 WiX 源码或引入外部构建流程。该功能支持用户指定非安装目录的运行时工作路径（如用户文档或 AppData），并默认回退至 %APPDATA%。
jpackage 自带 `--win-dir-chooser` 参数，可直接在 windows msi 安装流程中插入标准的“目标文件夹选择”对话框，无需手动修改 wix 源码或引入外部构建流程。该功能支持用户指定非安装目录的运行时工作路径（如用户文档或 appdata），并默认回退至 `%appdata%`。
在使用 jpackage 构建 Java 应用的 Windows MSI 安装包时，若需让用户在安装过程中自定义应用的运行时工作目录（例如日志、缓存或用户数据存储路径），而不强制绑定到安装目录（如 Program Files），最简洁、官方支持的方案是启用内置的 Windows 目录选择器。
✅ 正确做法：使用 --win-dir-chooser
只需在 jpackage 命令中添加以下两个参数：
--win-dir-chooser --win-console
- --win-dir-chooser：启用一个标准 Windows 风格的目录浏览对话框，允许用户在安装向导中选择任意具有读写权限的路径（如 C:UsersAliceMyAppData 或 %APPDATA%MyApp）。
- --win-console（推荐搭配）：确保安装过程以控制台模式运行，避免 GUI 安装界面因权限/上下文问题跳过自定义对话框；同时便于调试输出（尤其在开发验证阶段）。
? 注意：该选项仅适用于 Windows 平台（.msi 输出），且从 JDK 14 起正式支持，JDK 19（如您使用的 19.0.2）完全兼容并稳定可用。
? 如何获取并使用用户选择的路径？
--win-dir-chooser 不会自动修改您的 Java 应用逻辑，但它会将用户选定的路径作为安装属性注入 MSI，并可通过以下方式在运行时访问：
-
在启动脚本中传递（推荐）：
jpackage 生成的 .bat 启动器默认不暴露该路径，因此建议在 --input 目录中提供自定义启动脚本（如 launch.bat），并通过环境变量或 JVM 参数传入：@echo off set APP_WORK_DIR=%1 if "%APP_WORK_DIR%"=="" set APP_WORK_DIR=%APPDATA%MyApp java -Dapp.work.dir="%APP_WORK_DIR%" -jar MyApp.jar
-
在 Java 中安全读取：
String workDir = System.getProperty("app.work.dir"); if (workDir == null || workDir.trim().isEmpty()) { workDir = System.getenv("APPDATA") + "\MyApp"; } Path dataPath = Paths.get(workDir); try { Files.createDirectories(dataPath); // 确保可写 } catch (IOException e) { throw new RuntimeException("无法初始化工作目录: " + workDir, e); }
⚠️ 注意事项与最佳实践
- ❌ 不要尝试手动修改 main.wxs 或注入自定义 WiX 对话框：jpackage 的资源覆盖机制（--resource-dir）不支持新增 .dlg 或扩展 wixhelper.dll 行为，强行修改会导致构建失败或安装异常。
- ✅ 若需更复杂的配置（如多字段表单、网络校验、注册表预设），则应转向完整 WiX Toolset 工程——但对“单目录选择”场景属于过度设计。
- ? 测试建议：在干净的 Windows 用户账户下执行 MSI 安装（避免管理员权限干扰 UAC 和路径解析），并验证 %APPDATA% 回退逻辑是否生效。
- ? 打包命令示例（含关键参数）：
jpackage --type msi --name MyApp --input target/jlink-image --main-jar MyApp.jar --win-dir-chooser --win-console --dest output/installers
综上，--win-dir-chooser 是 jpackage 为 Windows 场景提供的轻量、可靠、零依赖的目录定制方案。它完美契合“用户可选工作路径 + 默认 AppData 回退”的需求，无需脱离 jpackage 生态，也无需维护额外的 WiX 构建流程。
