如何在TFS 2017构建中读取package.json的版本号

我来帮你搞定这个在TFS 2017持续集成流程里读取package.json版本号的问题。先聊聊你遇到的错误——大概率是PowerShell脚本里的路径没处理对，毕竟TFS构建有自己的工作目录上下文，相对路径很容易踩坑。不过别担心，我给你整理了几种靠谱的解决办法：

1. 修正原PowerShell脚本的路径问题 #

你的核心思路没问题，只是路径可能没适配TFS的构建环境。TFS构建的默认工作目录是$(Build.SourcesDirectory)，也就是代码仓库的根目录，所以你需要用绝对路径来定位package.json：

# 拼接绝对路径
$packagePath = Join-Path -Path $(Build.SourcesDirectory) -ChildPath "Path/package.json"

# 先检查文件是否存在，避免报错
if (Test-Path $packagePath) {
    $SemverVersion = (Get-Content -Raw -Path $packagePath | ConvertFrom-Json).version
    # 把版本号设为TFS构建变量，方便后续步骤使用
    Write-Host "##vso[task.setvariable variable=SemverVersion;]$SemverVersion"
} else {
    throw "package.json 文件未找到，路径：$packagePath"
}

这段脚本会先确认文件存在，然后把读取到的版本号设置为TFS的构建变量SemverVersion，后续步骤直接用$(SemverVersion)就能引用了。

2. 用Node.js脚本读取（如果构建环境已安装Node.js） #

如果你的构建代理已经装了Node.js，这种方法更简单直接，不用处理PowerShell的路径问题。写一个小脚本get-version.js：

const fs = require('fs');
const packageJson = JSON.parse(fs.readFileSync('./Path/package.json', 'utf8'));
console.log(packageJson.version);

然后在TFS构建里加一个命令行步骤，执行以下命令直接把版本号设为构建变量：

##vso[task.setvariable variable=SemverVersion;]$(node get-version.js)

3. 使用TFS扩展任务（无需手写脚本） #

如果你的TFS服务器允许安装扩展，可以找专门的「版本号读取」类扩展，比如Package Version Reader这类任务。这类扩展只需要你配置package.json的路径，就能自动把版本号提取到构建变量里，完全不用自己写脚本，适合不想折腾代码的场景。注意要找支持TFS 2017版本的扩展哦。

4. 通过MSBuild任务读取（适合.NET Core项目） #

如果你的项目是用MSBuild构建的，可以直接在项目文件（.csproj或.vbproj）里添加一个目标任务，在构建过程中读取版本号：

<Target Name="ExtractPackageVersion" BeforeTargets="Build">
  <!-- 读取package.json内容 -->
  <ReadLinesFromFile File="Path/package.json">
    <Output TaskParameter="Lines" ItemName="PackageJsonContent" />
  </ReadLinesFromFile>
  <!-- 用正则提取版本号 -->
  <PropertyGroup>
    <PackageVersion>$([System.Text.RegularExpressions.Regex]::Match('@(PackageJsonContent)', '"version":\s*"([^"]+)"').Groups[1].Value)</PackageVersion>
  </PropertyGroup>
  <!-- 输出版本号到构建日志 -->
  <Message Text="提取到的package版本号：$(PackageVersion)" Importance="high" />
  <!-- 设置为构建变量 -->
  <PropertyGroup>
    <BuildVersion>$(PackageVersion)</BuildVersion>
  </PropertyGroup>
</Target>

这样在构建过程中，$(PackageVersion)变量就会被自动填充，后续的构建步骤可以直接引用这个变量。

内容的提问来源于stack exchange，提问作者Boubakr Chieb