Question

我创建了一个简单的控制台应用程序以及一个简单的docfx项目。当我运行DocFX命令生成文档时，我收到以下元数据警告，并告知警告导致文档未生成。

[18-06-05 05：52：41.715]警告：MetadataCommand.ExtractMetadataWorkspace失败：[失败] Msbuild在处理文件时失败＆＃39; E：\ Files \ tmp \ docx \ docfx_project \ src \ src的.csproj＆＃39;消息：C：\ Program Files \ dotnet \ sdk \ 2.1.300 \ Sdks \ Microsoft.NET.Sdk \ targets \ Microsoft.PackageDependencyResolution.targets：（198,5）：加载锁定文件时出错＆＃39; E：\文件\ tmp目录\ DOCX \ docfx_project的\ src \ OBJ \ project.assets.json＆＃39; ：对象引用未设置为对象的实例。

稍后在输出中看到

[18-06-05 05：52：42.467]警告：[MetadataCommand.ExtractMetadata]没有为src生成元数据。

其他人遇到这个问题？如何生成元数据？

重新创建项目非常简单：

转到dotnet cli工具命令行
docfx init
cd src
dotnet new console
cd ..
docfx

我已经安装并使用了dotnet sdk 2.1.300

Answer 1

使用.net 2.1，工具的使用发生了重大变化，现在全局安装和使用，如下所示：

dotnet watch
dotnet user-secrets
dotnet sql-cache
dotnet dev-certs

docfx的开发人员目前正在开发支持.net 2.1（docfx v3）的版本：https://github.com/dotnet/docfx/pull/2829

您可以在此处查看实施的当前状态：https://github.com/dotnet/docfx/projects/1

所以你的问题的答案是：到目前为止，你不能将docfx用于.net 2.1

安装dotnet core 2.1.300

1 个答案: