使用Chocolatey打包MSI软件包的完整解决方案及技术总结

在Windows系统上使用Chocolatey管理软件包是一种高效且自动化的方式，尤其是针对MSI格式的软件包。然而，在实际操作中，我们可能会遇到各种问题，例如检测旧版本、卸载旧版本以及处理多个匹配记录等。本文将详细记录从问题发现到最终解决的全过程，并分享最终的Chocolatey打包脚本，希望能为软件仓库维护人员解决类似问题提供启发。

问题背景

我们希望通过Chocolatey将一个MSI软件包打包成可安装的Chocolatey包，并实现以下功能：

检测是否存在旧版本。
如果存在旧版本，先卸载旧版本。
安装新版本的MSI软件包。
确保整个过程自动化且无用户干预。

问题与解决过程

1. 检测旧版本耗时过长

问题：
起初，我们尝试使用以下命令检测是否存在已安装的软件：

Get-WmiObject -Class Win32_Product | Where-Object { $_.Name -like "*Your Software Name*" }

然而，这个命令会触发所有已安装MSI软件的一致性检查，导致系统卡顿甚至长时间无响应。

解决方案：
改用注册表查询的方式，通过以下路径快速检索已安装的软件信息：

64位应用程序路径：HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall
32位应用程序路径：HKLM:\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall

优化后的查询命令如下：

Get-ChildItem -Path HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall | 
Get-ItemProperty | 
Where-Object { $_.DisplayName -like "*Your Software Name*" }

2. 检测到多个匹配记录

问题：
在注册表中查询时，可能会返回多个匹配记录（例如同一软件的不同版本或不同语言包）。这可能导致脚本只处理第一个匹配项，而忽略其他记录。

解决方案：
通过遍历所有匹配记录，逐一处理每个已安装的软件。具体实现如下：

$installedSoftwareList = Get-ChildItem -Path $path | Get-ItemProperty | Where-Object { $_.DisplayName -like "*Your Software Name*" }foreach ($installedSoftware in $installedSoftwareList) {# 针对每个匹配的软件进行处理
}

3. 卸载旧版本失败

问题：
在尝试卸载旧版本时，我们直接使用 UninstallString 作为 Start-Process 的 -FilePath 参数，但由于 UninstallString 包含了路径和参数，导致报错 InvalidOperationException。

例如：

MsiExec.exe /X{GUID}

解决方案：
将 UninstallString 拆分为可执行文件路径和参数，然后分别传递给 Start-Process 的 -FilePath 和 -ArgumentList 参数。具体实现如下：

if ($uninstallString -match '^(.*\.exe)(.*)$') {$exePath = $matches[1]$arguments = $matches[2].Trim()$arguments = $arguments -replace '/I', '/X'  # 替换为卸载参数$arguments += ' /qn'  # 添加静默卸载参数Start-Process -FilePath $exePath -ArgumentList $arguments -Wait -NoNewWindow
}

最终完整的Chocolatey打包脚本

以下是经过优化后的完整脚本，能够检测并卸载旧版本，然后静默安装新版本的MSI软件包：

$ErrorActionPreference = 'Stop'# 定义软件名称和新版本号
$softwareName = 'Your Software Name'  # 替换为实际的软件名称
$newVersion = '1.2.3'  # 替换为新版本号# 定义注册表路径
$registryPaths = @("HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall","HKLM:\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall"
)# 检查是否存在旧版本并卸载
foreach ($path in $registryPaths) {$installedSoftwareList = Get-ChildItem -Path $path | Get-ItemProperty | Where-Object { $_.DisplayName -like "*$softwareName*" }foreach ($installedSoftware in $installedSoftwareList) {$oldVersion = $installedSoftware.DisplayVersionWrite-Host "Found installed version: $oldVersion"if ([version]$oldVersion -lt [version]$newVersion) {$uninstallString = $installedSoftware.UninstallStringif ($uninstallString -match '^(.*\.exe)(.*)$') {$exePath = $matches[1]$arguments = $matches[2].Trim()$arguments = $arguments -replace '/I', '/X'  # 替换为卸载参数$arguments += ' /qn'  # 添加静默卸载参数Write-Host "Uninstalling version $oldVersion..."try {Start-Process -FilePath $exePath -ArgumentList $arguments -Wait -NoNewWindow}catch {Write-Host "Error uninstalling version $oldVersion: $_"continue  # 继续处理下一个版本}}}else {Write-Host "Version $oldVersion is up to date. No action needed."}}
}# 安装新版本的MSI
$packageArgs = @{packageName    = $env:ChocolateyPackageNamefileType       = 'MSI'url            = 'https://example.com/your-software.msi'  # 替换为实际的下载URLsoftwareName   = $softwareNamechecksum       = '1234567890ABCDEF1234567890ABCDEF1234567890ABCDEF1234567890ABCDEF'  # 替换为实际的checksum值checksumType   = 'sha256'silentArgs     = "/qn /norestart ALLUSERS=1"  # 添加ALLUSERS=1以确保所有用户都能访问validExitCodes = @(0, 3010, 1641)
}Install-ChocolateyPackage @packageArgs