dotnet core PackageReference 与 DotNetCliToolReference

Question

我正在尝试从我的命令行运行dotnet aspnet-codegenerator。第一次尝试，报错No executable found matching command "dotnet-aspnet-codegenerator"

我意识到我需要将aspnet-codegenerator 安装为“dotnet CLI 工具”（如果我在 csproj 文件中包含正确的<DotNetCliToolReference> 元素，他们的extensibility model 的一部分允许添加 CLI 命令。）¹

This answer 告诉我需要哪个<DotNetCliToolReference>，即<DotNetCliToolReference Include="Microsoft.VisualStudio.Web.CodeGeneration.Tools" Version="1.0.1" />，但它给我留下了几个问题：

1. 我可以使用命令行而不是手动编辑来安装它吗 csproj？
   • 我注意到我可以使用命令dotnet add package 安装软件包，但这会添加元素<PackageReference>，我需要<DotNetCliToolReference>；
   • 即运行命令会产生这个（错误的）元素：<PackageReference Include="Microsoft.VisualStudio.Web.CodeGeneration.Tools" Version="1.0.1" />
2. 这两个元素有什么区别？
   • 我可以将它们添加到同一个<ItemGroup> 吗？
   • 如果我有一个csproj，其第一个也是唯一一个<ItemGroup> 包含<DotNetCliToolReference>，那么任何后续dotnet add package 命令都会失败：error: Invalid restore input. Invalid restore input. DotnetCliToolReference-BundlerMinifier.Core Input files:。
   • 我的解决方法是：
     1. 删除任何现有的DotNetCliToolReference 元素
     2. 运行dotnet add package
     3. 完成后，将我删除的内容添加回来。

¹（我在 Visual Studio Code 中并使用最新的；所以我们使用的是 csproj，而不是 project.json）

Answer 1

1. 目前添加 DotNetCliToolReference 项目只能通过手动编辑 csproj 文件来实现。该功能在 .NET Core 3.0 中已被弃用，因为它导致了难以调试的奇怪不兼容性。见：https://github.com/dotnet/sdk/issues/3115

2. 逻辑上的区别在于PackageReferences 将成为您的应用程序的一部分 - 您可以使用代码中的软件包附带的 dll，它将与您的应用程序一起部署。 DotNetCliToolReference 包将从提要中恢复，但不会添加到您应用的“依赖关系图”中。当 CLI 运行命令时，它还会查看 csproj 文件，并通过 DotNetCliToolReference 项将命令名称解析为相应的 dll 文件。

3. 这两种项目类型在哪个项目组中并不重要。 MSBuild 非常动态，您可以根据需要重新排列文件。 CLI 和 NuGet 都使用 MSBuild API 来评估文件并查询项目的项目。

4. 当DotNetCliToolReference 已经存在时，您看到dotnet add package 失败的错误是已为即将发布的2.0 版本修复的错误：https://github.com/NuGet/Home/issues/4771