如何统一ClickOnce测试与生产应用的版本号？

问题背景 #

我使用C#开发了一款ClickOnce应用，搭建了测试环境与生产环境两条独立的构建流水线。目前每次构建时，通过PowerShell脚本将应用版本号设置为当前流水线的运行编号，导致测试与生产应用版本号无法统一：例如测试应用版本为1.4.8.18，而生产应用版本为1.4.8.1。需要实现无论构建次数多少，两个环境的版本号始终保持一致。

现有脚本问题分析 #

当前脚本直接使用流水线内置的$(Build.BuildNumber)作为版本号，但测试与生产流水线的运行编号是独立递增的，这是导致版本不一致的核心原因。要统一版本，必须放弃依赖流水线自身的计数，改用统一的版本来源。

修改PowerShell脚本实现版本统一 #

方案1：从已发布的ClickOnce清单读取版本号 #

如果已有生产环境的发布清单，可以直接从该清单中读取完整版本号，赋值给新构建的测试/生产应用：

# 目标项目文件路径
$projectFilePath = "path/to/csproj/file"
# 已发布的生产环境ClickOnce清单路径
$manifestPath = "path/to/production/application.exe.manifest"

# 从清单文件提取版本号
$manifestContent = Get-Content $manifestPath -Raw
$versionMatch = [regex]::Match($manifestContent, '<assemblyIdentity.*version="([\d.]+)"')
if ($versionMatch.Success) {
    $targetVersion = $versionMatch.Groups[1].Value
    Write-Host "从生产清单获取到统一版本号：$targetVersion"
} else {
    Write-Error "无法从清单文件读取版本号"
    exit 1
}

# 更新项目文件中的ApplicationVersion节点
$projectContent = Get-Content $projectFilePath -Raw
$updatedProjectContent = $projectContent -replace '<ApplicationVersion>[\dA-Za-z.%]+</ApplicationVersion>', "<ApplicationVersion>$targetVersion</ApplicationVersion>"

Set-Content $projectFilePath $updatedProjectContent
Write-Host "项目版本已同步为：$targetVersion"

方案2：从共享版本配置文件读取版本号 #

在项目中创建一个共享的版本配置文件（如Version.props），集中维护版本号：

<Project>
  <PropertyGroup>
    <ApplicationVersion>1.4.8.0</ApplicationVersion>
  </PropertyGroup>
</Project>

在主项目的.csproj中引用该文件：

<Import Project="Version.props" />

修改PowerShell脚本，直接读取这个共享文件的版本号，确保两条流水线使用同一来源：

$versionPropsPath = "path/to/Version.props"
$projectFilePath = "path/to/csproj/file"

# 读取共享版本配置
$propsContent = Get-Content $versionPropsPath -Raw
$versionMatch = [regex]::Match($propsContent, '<ApplicationVersion>([\d.]+)</ApplicationVersion>')
if ($versionMatch.Success) {
    $targetVersion = $versionMatch.Groups[1].Value
} else {
    Write-Error "无法读取共享版本配置文件"
    exit 1
}

# 同步项目版本（若已通过Import引用props文件，此步骤可省略）
$projectContent = Get-Content $projectFilePath -Raw
$updatedProjectContent = $projectContent -replace '<ApplicationVersion>[\dA-Za-z.%]+</ApplicationVersion>', "<ApplicationVersion>$targetVersion</ApplicationVersion>"

Set-Content $projectFilePath $updatedProjectContent
Write-Host "项目版本已设置为：$targetVersion"

其他实现版本统一的方法 #

• 流水线参数化构建：将版本号设为流水线的输入参数，测试和生产构建时传入相同的版本号值，彻底摆脱对流水线自身运行编号的依赖。
• Git标签驱动版本：在Git仓库中用标签（如v1.4.8）标记正式版本，两条流水线构建时读取当前Git标签作为版本号，确保版本与代码提交状态绑定。
• 自动化版本工具：使用GitVersion这类工具，根据Git提交记录、分支规则自动生成统一版本号，测试和生产流水线共用同一版本生成逻辑。

内容的提问来源于stack exchange，提问作者Czesław Nowicki