运行 dotnet tool install --local时,如果不存在清单,则立即创建清单,而不是失败并出现错误。 此更改是通过--create-manifest-if-needed默认启用选项来实现的。 这是一项重大更改,因为用户可能依赖失败行为来检查他们是否需要创建清单。
-d以前添加的dotnet tool install标志用于显示搜索清单的位置。 当没有清单时,在错误中中继了此信息。 由于现在已根据需要创建清单,因此不再显示该错误。 不应再使用该 -d 标志。
已引入的版本
.NET 10 预览版 7
以前的行为
以前,如果尝试在不包含清单的文件夹中将 .NET 工具安装为本地工具,则出现错误:
找不到清单文件。
新行为
从 .NET 10 开始, --create-manifest-if-needed=true 此功能现在默认处于启用状态。 将工具安装为本地工具时,如果清单不存在,则会自动创建清单。 清单是根据选项文档中所述--create-manifest-if-needed的规则创建的。
破坏性变更的类型
此更改为行为更改。
更改原因
此更改默认通过进行 dotnet tool install --local 工作来改善用户体验,而无需用户首先手动创建清单。 以前,人们担心在工作目录中而不是存储库根目录中创建清单,但该工具现在尽可能将清单置于存储库根目录中。
建议的措施
可以通过在调用dotnet tool install --local时传递--create-manifest-if-needed=false来关闭自动清单创建行为。
受影响的 API
N/A