visual-studio - 每次我在 Visual Studio [2019] [NuGet] 中重建项目时如何关闭 DocFX 构建
问题描述
我尝试开始使用 DocFX,它符合我的要求,但我有一个从长远来看相当麻烦的小问题。
每次我更改项目中的某些内容并启用调试时,DocFX 的 nuget 都会适应新的更改。
这是正确的行为,但我希望能够将其关闭一段时间。不需要很长时间,但是由于频繁的更改,它大大延长了测试任何东西的时间。
我正在查看用户手册: https ://dotnet.github.io/docfx/tutorial/docfx.exe_user_manual.html 我尝试自己做,但除了扔之外我没有找到任何方法从项目中删除。
解决方案
每次我在 Visual Studio [2019] [NuGet] 中重建项目时如何关闭 DocFX 构建
这是 nuget 包的特性,docfx.console
我建议你可以通过这种方式暂时关闭这个 nuget 包:
使用删除docfx
nuget 包的新配置对其进行测试。
1)添加一个名为 test 的新配置
2)如果它是一个带有packages.config的网络框架项目,你应该
在xxx.csproj
文件中更改:
<Import Project="..\packages\docfx.console.2.55.0\build\docfx.console.targets" Condition="Exists('..\packages\docfx.console.2.55.0\build\docfx.console.targets')/>
到
<Import Project="..\packages\docfx.console.2.55.0\build\docfx.console.targets" Condition="Exists('..\packages\docfx.console.2.55.0\build\docfx.console.targets') and '$(Configuration)'!='Test'" />
然后,您可以根据需要切换配置以实现目标。
测试配置不会消耗包,其他配置会消耗它。
==========================
如果是带有PackageReference的网络项目,需要在PackageReference<ExcludeAssets>buildtransitive</ExcludeAssets>
节点下添加,防止消耗包的目标文件:</p>
像这样:
<ItemGroup>
<PackageReference Include="docfx.console" >
<Version>2.55.0</Version>
<IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
<PrivateAssets>all</PrivateAssets>
<ExcludeAssets>buildtransitive</ExcludeAssets>
</PackageReference>
</ItemGroup>