使用 WiX 创建桌面快捷方式

Posted 2023-02-16

【中文标题】使用 WiX 创建桌面快捷方式

【英文标题】：Create shortcut to desktop using WiX

【发布时间】：2012-08-05 19:09:13

【问题描述】：

如何通过 wix 设置项目在桌面上创建快捷方式？

【问题讨论】：

这就是我对这些天这么多微软“技术”的感受。这一评论是在将近三年后发表的。很明显，最先进的技术并没有提高。

【参考方案1】：

快捷方式是非广告的，希望这对某人有所帮助。 请记住将组件放在您的功能标签中。

<Directory Id="TARGETDIR" Name="SourceDir">
    <Directory Id="DesktopFolder" Name="Desktop">
        <Component Id="ApplicationShortcutDesktop" Guid="*">
            <Shortcut Id="ApplicationDesktopShortcut"
                Name="Text under your icon"
                Description="Comment field in your shortcut"
                Target="[MYAPPDIRPROPERTY]MyApp.exe"
                WorkingDirectory="MYAPPDIRPROPERTY"/>
            <RemoveFolder Id="DesktopFolder" On="uninstall"/>
            <RegistryValue
                Root="HKCU"
                Key="Software\MyCompany\MyApplicationName"
                Name="installed"
                Type="integer"
                Value="1"
                KeyPath="yes"/>
        </Component>
    </Directory>

    <Directory Id="ProgramFilesFolder" Name="PFiles">
        <Directory Id="MyCompany" Name="MyCompany">
            <Directory Id="MYAPPDIRPROPERTY" Name="MyAppName">
                <!-- main installation files -->
            </Directory>
        </Directory>
    </Directory>
</Directory>

【讨论】：

不要发布硬编码的 GUID。将 Guid="*" 改为自动生成 guid，或使用 PUT-GUID-HERE

注册表值是什么？

@BatteryBackupUnit 快捷方式不能是组件的关键路径，因此注册表值用于此目的。 WiX 文档中使用了相同的技术：wixtoolset.org/documentation/manual/v3/howtos/…

最好为 Target 属性放置文件 id 而不是“[MYAPPDIRPROPERTY]MyApp.exe”。

我必须在功能标签下添加这个：

【参考方案2】：

我相信使用“当前用户”(HKCU) 注册表项作为密钥路径会导致多用户机床出现问题。因为注册表项只为当前用户创建，当其他用户登录时，安装的自动修复就会启动。

【参考方案3】：

经过太多努力，我是这样用的：

<Product ...>
    <Feature Id="ProductFeature" Title="SetupProject" Level="1">
      ...
      ...
      <ComponentRef Id="cmpDesktopShortcut" />
    </Feature>

    <Component Id="cmpDesktopShortcut" Guid="PUT-GUID-HERE" Directory="DesktopFolder" >
        <Shortcut Id="MyDesktopShortcut" 
                  Name="Setup Project" 
                  Description="Opens the program." 
                  Directory="DesktopFolder" 
                  Target="[INSTALLFOLDER]App.exe"
                  WorkingDirectory="INSTALLFOLDER"/>
        <RegistryValue Root="HKCU" Key="Software\My Company\Sample Application" Name="installed" Type="integer" Value="1" KeyPath="yes" />
    </Component>
</Product>

【参考方案4】：

documentation 似乎更容易。

首先，您必须指向您的 DesktopFolder，

   <Fragment>
    <Directory Id="TARGETDIR" Name="SourceDir">
      <Directory Id="DesktopFolder" Name="Desktop"/>

然后你应该为你想要创建快捷方式的文件创建快捷方式组件。

  <Component Id="PutYourComponentIdHere" Directory="FileDirectory" Guid="*">
    <File Id="NotYourComponentId" KeyPath="yes" Source="..\YourFileSource\YourExecutable.exe">
      <Shortcut Id="desktopServer" Directory="DesktopFolder" Name="YourShourtcutName" WorkingDirectory='WhereShouldYourShortcutPoint' Advertise="yes"/>
    </File>
  </Component>

它对我有用。我需要放图标，但这很容易。希望它有效。

【参考方案5】：

例如，谢谢。在 WIX 3.8 中，它仍然提出： “错误 3 ICE43：组件...具有非广告快捷方式。它应该使用 HKCU 下的注册表项作为其 KeyPath，而不是文件。”

所以我在一个具有特征的文件中这样做了：

   <Component Id="cmp79F6D61F01DD1060F418A05609A6DA70" 
              Directory="dirBin" Guid="*">
      <File Id="fil34B100315EFE9D878B5C2227CD1454E1" KeyPath="yes"
            Source="$(var.SourceDir)\FARMS.exe" >
        <Shortcut Id="DesktopShortcut"
                  Directory="DesktopFolder"
                  Name="FARMS $(var.FarmsVersion)"
                  Description="Local Land Services desktop application"
                  WorkingDirectory="INSTALLFOLDER"
                  Icon="FARMS.exe"
                  IconIndex="0"
                  Advertise="yes" >
           <Icon Id="FARMS.exe" SourceFile="$(var.SourceDir)\FARMS.exe" />
        </Shortcut>
        </File>
    </Component>

并在带有产品定义的文件中提到桌面文件夹：

  <Fragment>
    <Directory Id="TARGETDIR" Name="SourceDir">
      <Directory Id="DesktopFolder" Name="Desktop" />

      <Directory Id="ProgramFilesFolder">
        <Directory Id="INSTALLFOLDER" Name="FARMS" >
        </Directory>
      </Directory>
    </Directory>
  </Fragment>

【参考方案6】：

我觉得我的方法更简单，不需要你创建注册表项：

<Directory Id="TARGETDIR" Name="SourceDir">
  <Directory Id="DesktopFolder" SourceName="Desktop" />
  <Directory Id="MergeRedirectFolder">
    <Component Id="MyExeComponent" Guid="PUT-GUID-HERE">
      <File Id="MyExeFile" Source="$(var.ExeSourcePath)" KeyPath="yes">
        <Shortcut
          Id="DesktopShortcut"
          Directory="DesktopFolder"
          Name="$(var.ShortcutName)"
          WorkingDirectory="MergeRedirectFolder" />
      </File>
    </Component>
  </Directory>
</Directory>

【讨论】：

来自documentation 关于注册表项：“这是必需的，因为在为当前用户安装非广告快捷方式时，快捷方式不能用作组件的 KeyPath。”

文件组件本身就是keypath，快捷方式“继承”了文件属性。但是，当您尝试在许多文件中追踪该桌面快捷方式时，这种方式可能会有点令人困惑。我认为用户偏好是紧凑还是可追溯性？

在大多数情况下，您不希望将快捷方式的工作目录设置为应用安装到的目录。

此答案显示了如何根据 Windows Installer 文档创建有效的快捷方式。 Wix 将构建一个包 (MSI)，其中将包含一个快捷方式记录，其 Directory_ 字段引用特殊的 DesktopFolder 文件夹，Target 字段携带值 [#<ID-of-MyExeFile>]。我看到的唯一缺点是文件和快捷方式都是单个组件的一部分，因此不能单独安装一个。显然，没有目标文件安装快捷方式是没有意义的，但现在你也不能有“将快捷方式放在桌面上”选项。

我错过的另一个缺点是，由于 keypath 是快捷方式链接到的文件，因此安装的修复不会总是像用户预期的那样 - 如果文件在那里，丢失的快捷方式将获胜'不被修复（阅读：已安装），因为该组件被认为存在（文件已到位）。