如何让MSI安装包阻止安装到ProgramFiles目录（jpackage实现）

核心思路 #

要实现类似Spiral Knights的安装目录限制，核心是通过jpackage配置+自定义MSI脚本，把默认安装路径锁定到用户可读写的目录（比如%APPDATA%\Roaming\your_app_name），同时在用户选择其他目录时自动检查权限，无权限则报错终止安装。

具体操作步骤 #

1. 锁定默认安装路径到用户可读写目录 #

直接用jpackage的--install-dir参数指定默认路径为用户AppData漫游文件夹，确保用户默认选择的路径本身就具备读写权限：

jpackage \
  --type msi \
  --name YourAppName \
  --install-dir "%APPDATA%\Roaming\YourAppName" \
  # 补充你的其他必要参数，比如--main-jar、--main-class等

2. 自定义MSI权限检查逻辑 #

jpackage支持通过--resource-dir引入自定义WiX脚本片段，用来添加目录权限校验逻辑：

步骤2.1：创建WiX自定义片段文件

在你的资源目录下新建custom_permission_check.wxs，内容如下：

<?xml version="1.0" encoding="UTF-8"?>
<Wix xmlns="http://schemas.microsoft.com/wix/2006/wi">
  <Fragment>
    <!-- 调用WiX内置的目录权限检查动作 -->
    <CustomAction Id="CheckDirWriteAccess" BinaryKey="WixCA" DllEntry="WixCheckDirPermissions" Return="check" />
    
    <!-- 在安装流程的目录计算完成后执行检查 -->
    <InstallExecuteSequence>
      <Custom Action="CheckDirWriteAccess" After="CostFinalize">NOT Installed</Custom>
    </InstallExecuteSequence>
    
    <!-- 定义权限不足时的错误提示 -->
    <UI>
      <Error Id="10001">您选择的目录没有读写权限，请选择默认的AppData文件夹或其他有权限的目录。</Error>
    </UI>
    
    <!-- 权限检查失败时抛出错误 -->
    <CustomAction Id="ThrowPermissionError" Error="10001" />
    <InstallExecuteSequence>
      <Custom Action="ThrowPermissionError" After="CheckDirWriteAccess">CheckDirWriteAccess = 3</Custom>
    </InstallExecuteSequence>
  </Fragment>
</Wix>

步骤2.2：在jpackage命令中引用资源目录

修改jpackage命令，添加--resource-dir参数指向存放上述脚本的目录：

jpackage \
  --type msi \
  --name YourAppName \
  --install-dir "%APPDATA%\Roaming\YourAppName" \
  --resource-dir ./your-resource-folder \
  # 其他必要参数

3. 可选：限制用户仅能选择默认目录的子目录 #

如果想进一步缩小可选范围，只允许用户在默认目录下选择子目录，可以在资源目录添加subdir_validation.wxs脚本：

<?xml version="1.0" encoding="UTF-8"?>
<Wix xmlns="http://schemas.microsoft.com/wix/2006/wi">
  <Fragment>
    <UI>
      <DialogRef Id="BrowseDlg" />
      <!-- 点击浏览目录的确定按钮时触发校验 -->
      <Publish Dialog="BrowseDlg" Control="OK" Event="DoAction" Value="ValidateSubDir">1</Publish>
    </UI>
    <CustomAction Id="ValidateSubDir" Script="vbscript">
      <![CDATA[
        Dim targetPath, defaultPath
        targetPath = Session.Property("TARGETDIR")
        defaultPath = Session.Property("APPDATA") & "\Roaming\YourAppName"
        
        ' 检查目标路径是否是默认路径的子目录
        If InStr(LCase(targetPath), LCase(defaultPath)) = 0 Then
          MsgBox "请选择默认目录下的子目录或保持默认路径。", vbExclamation, "目录选择错误"
          ' 重置回默认路径
          Session.Property("TARGETDIR") = defaultPath
        End If
      ]]>
    </CustomAction>
  </Fragment>
</Wix>

效果验证 #

生成MSI后测试两个核心场景：

• 直接安装：默认路径为%APPDATA%\Roaming\YourAppName，正常完成安装
• 尝试选择Program Files等系统保护目录：安装程序触发权限检查，弹出错误提示并终止安装

内容的提问来源于stack exchange，提问作者hidden_machine