每次我在 Visual Studio [2019] [NuGet] 中重建项目时如何关闭 DocFX 构建

How to turn off DocFX build each time i rebuild project in Visual Studio [2019] [NuGet]

我尝试开始使用 DocFX,它满足了我的要求,但我有一个小问题,在漫长的 运行.

中非常麻烦

每次我在项目中更改某些内容并启用调试时,DocFX 的 nuget 都会适应新的更改。

这是正确的行为,但我希望能够将其关闭一段时间。 不需要很长时间,但由于频繁更改,它显着延长了测试任何内容的时间。

我在看用户手册: https://dotnet.github.io/docfx/tutorial/docfx.exe_user_manual.html 我试着自己做,但我没有找到任何方法来做到这一点,除了把 nuget 扔出项目。

How to turn off DocFX build each time i rebuild project in Visual Studio [2019] [NuGet]

这是nuget包的特性docfx.console,我建议你可以通过这种方式暂时关闭这个nuget包:

使用删除 docfx nuget 包的新配置对其进行测试。

1) 添加一个名为 test 的新配置

2)如果是packages.config的net framework项目,应该

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的net工程,应该在PackageReference节点下添加<ExcludeAssets>buildtransitive</ExcludeAssets>,防止消耗包目标文件:

像这样:

<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>