如何从命令行动态更新Service Fabric清单的多版本号？

我太懂你这个痛点了——Service Fabric把版本号拆成三个地方存，单独用/p:PackageVersion确实只能覆盖一部分，之前我踩过一模一样的坑。下面给你几个从简单到灵活的解决方案，按需选就行：

方案一：MSBuild命令行直接传递多参数 #

Service Fabric的MSBuild工具本身支持单独指定各个版本号的参数，你可以在构建命令里一次性把三个版本都传进去：

• 更新Service Manifest Version：用/p:ServiceManifestVersion=x.y.z
• 更新Code Version：用/p:CodePackageVersion=x.y.z
• 更新Config Version：用/p:ConfigPackageVersion=x.y.z

如果你的所有版本号都想和构建号保持一致，直接把三个参数设成同一个值就行，比如：

msbuild YourApp.sfproj /t:Package /p:ServiceManifestVersion=1.0.$(BuildNumber) /p:CodePackageVersion=1.0.$(BuildNumber) /p:ConfigPackageVersion=1.0.$(BuildNumber)

这个方法适合版本号完全统一的场景，不用改项目文件，简单直接。

方案二：修改.sfproj文件统一管理版本 #

要是不想每次构建都写一堆参数，可以在你的.sfproj里定义一个统一的版本属性，让所有子版本号都引用它：

1. 打开.sfproj，在<PropertyGroup>节点里加自定义版本属性：

<PropertyGroup>
  <BuildVersion>1.0.$(BuildNumber)</BuildVersion>
</PropertyGroup>

2. 找到项目里对应的版本设置节点，替换成引用这个属性：

<ServiceManifestVersion>$(BuildVersion)</ServiceManifestVersion>
<CodePackageVersion>$(BuildVersion)</CodePackageVersion>
<ConfigPackageVersion>$(BuildVersion)</ConfigPackageVersion>

之后构建时只需要传/p:BuildVersion=x.y.z，就能一次性更新所有三个版本号，维护起来更省心。

方案三：多服务场景的批量自动更新 #

如果你的应用包含多个服务，每个服务都有自己的Service Manifest，上面的方法可能要逐个修改。这时候可以用MSBuild的批量任务，自动遍历所有服务的manifest文件替换版本号：
在.sfproj里添加一个目标任务，放在打包前执行：

<Target Name="UpdateAllServiceVersions" BeforeTargets="Package">
  <ItemGroup>
    <ServiceManifests Include="**\ServiceManifest.xml" />
  </ItemGroup>
  <XmlPoke XmlInputPath="%(ServiceManifests.FullPath)"
           Query="/ServiceManifest/@Version"
           Value="$(BuildVersion)" />
  <XmlPoke XmlInputPath="%(ServiceManifests.FullPath)"
           Query="/ServiceManifest/CodePackage/@Version"
           Value="$(BuildVersion)" />
  <XmlPoke XmlInputPath="%(ServiceManifests.FullPath)"
           Query="/ServiceManifest/ConfigPackage/@Version"
           Value="$(BuildVersion)" />
</Target>

这个任务会自动找到所有ServiceManifest.xml，把三个版本号都替换成$(BuildVersion)的值。构建时同样只需要传/p:BuildVersion=x.y.z就行，适合多服务的复杂应用。

小提醒 #

• 确保构建服务器上的MSBuild版本和Service Fabric SDK兼容，一般配套的工具都没问题
• 如果你的Config Package有多个，需要调整XmlPoke的Query路径，比如/ServiceManifest/ConfigPackage[@Name='Config']/@Version来指定特定配置包

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