运行docfx以生成针对.net标准2.0项目的文档 - msbuild错误

时间:2017-06-20 15:51:49

标签: visual-studio visual-studio-2017 docfx

我有一个.net标准2.0类库。我安装了VS 2017和VS 2017预览版(适用于net core 2.0)。

我正在尝试运行docfx来为我的库生成文档。

我首先遇到了一个问题,我收到了以下消息:

C:\ docfx \ SDKS \ Microsoft.NET.Sdk \ SDK \ Sdk.props

看来这是因为当docfx运行MSBuild时,它无法找到dot net core 2.0预览SDK。我发现这可以通过创建一个名为MSBuildDSKsPath的环境变量并将其设置为适当的值来修复。这让我超过了上述错误,现在我遇到了这个错误:

找不到导入的项目“C:\ Program Files(x86)\ MSBuild \ 2.0 \ Microsoft.Common.props”。

这来自Sdk.props文件,因为在该文件中是这个引用:

MSBuildExtensionsPath值是正确的,但是看起来MSBuildToolsVersion是错误的。它应该是14或15(不确定哪个,但这些是我已经安装的)。

我尝试了一些事情。我尝试在docfx.json文件中设置MSBuildToolsVersion,我也尝试设置MSBuildToolsVersion环境变量。都没有工作。

有关如何让它运行的任何建议吗?

2 个答案:

答案 0 :(得分:0)

issue跟踪此信息。目前的解决方法是将env.MSBuildSDKsPath设置到正确的位置,例如$ set MSBuildSDKsPath=C:\Program Files\dotnet\sdk\1.0.0-rc4-004771\Sdks

答案 1 :(得分:0)

可能设置csproj文件中的ToolsVersion可以正常工作 <Project Sdk="Microsoft.NET.Sdk" ToolsVersion="14.0"> 版本值必须可用