WiX 安装包制作最佳实践:Id、UpgradeCode 应该怎么设置?

2023-10-22 11:37:54 浏览数 (2)

在 WiX 安装包制作时,Product.wxs 文件中的 Product 标签中存在一些属性,这些属性应该如何设置才是比较合适的呢?

本文是对我另一篇入门教程博客的一点补充:

  • 用 WiX 制作安装包:创建一个简单的 msi 安装包

Id、Version

  • Id:产品 Id。
  • Version:产品版本。

关于这两个值的变化:

  • 如果这两个值都没有更改而构建出一个新的 MSI 安装包,那么 Windows Installer 会认为这两个包之间属于“小型更新”(Update)。
  • 如果 Version 属性更改,而 Id 属性没有更改,那么 Windows Installer 会认为这两个包之间属于“次要升级”(Upgrade)。
  • 如果这两个值都更改了,那么 Windows Installer 会认为这两个包之间属于“主要升级”(MajorUpgrade)。

特别把这几种升级类型的英文名称拿出来说,是因为我们在 Product.wxs 中配置升级策略时会使用到这些名称。了解这些升级方式有助于我们写出符合预期的升级策略。

如果保持 Product.wxs 文件的 Product 元素的 Id 属性为 *,那么每次构建一个 MSI 文件都会视为一次“主要升级”(MajorUpgrade)。

在没有配置升级策略的情况下,如果有两个不同的 MSI 包设置了相同的 Id 和 Version,那么当安装了其中一个之后,另一个将无法安装。双击 msi 文件时,Windows Installer 将弹出错误框:

UpgradeCode

对于同一个产品,无论其产品 Id、Version 如何变化,都应该保持 UpgradeCode 不变,以便 Windows Installer 能准确认为这是同一个产品的“主要升级”(MajorUpgrade)。

参考资料

  • 修补和升级 - Win32 apps - Microsoft Docs
  • Product Identification (ProductCode and UpgradeCode)
  • In WiX, where is the ProductCode specified? - Stack Overflow
  • ProductCode 属性 - Win32 apps - Microsoft Docs

本文会经常更新,请阅读原文: https://blog.walterlv.com/post/windows-installer-using-wix-best-practice-product-id-and-upgrade-code.html ,以避免陈旧错误知识的误导,同时有更好的阅读体验。

本作品采用 知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议 进行许可。欢迎转载、使用、重新发布,但务必保留文章署名 吕毅 (包含链接: https://blog.walterlv.com ),不得用于商业目的,基于本文修改后的作品务必以相同的许可发布。如有任何疑问,请 与我联系 ([email protected]) 。

0 人点赞