我认为通常优良的做法是将包含在NuGet包中的C#build生成的
XML文档文件与DLL一起包含,以便为消费者提供智能感知文档.
但是,我不清楚在使用VS 2017的项目文件格式构建软件包时如何做到这一点.
这可能吗?
显然我可以切换到维护一个nuspec文件,但VS2017格式非常方便将版本和依赖项保存在一个地方.
只要在csproj文件中设置GenerateDocumentationFile,就像这样:
<Project Sdk="Microsoft.NET.Sdk"> <PropertyGroup> <TargetFramework>netstandard2.0</TargetFramework> <GenerateDocumentationFile>true</GenerateDocumentationFile> </PropertyGroup> </Project>
然后所有默认值将在正确的位置生成文档文件,它将包含在NuGet包中.
如果Visual Studio添加了DocumentationFile或其他元素,则可以删除它们并将其替换为单个GenerateDocumentationFile属性.