在 Visual Studio for Mac 中安装和管理 NuGet 包
适用于: Visual Studio for Mac
Visual Studio
通过 Visual Studio for Mac 中的 NuGet 包管理器 UI,可轻松安装、卸载和更新项目和解决方案中的 NuGet 包。 可以搜索包和将包添加到 .NET Core、ASP.NET Core 和 Xamarin 项目。
本文介绍如何在项目中包括 NuGet 包并演示实现此流程无缝的工具链。
有关在 Visual Studio for Mac 中使用 NuGet 的简介,请参阅快速入门:在 Visual Studio for Mac 中安装和使用包
查找并安装包
对于 Visual Studio for Mac 中打开的项目,右键单击“解决方案窗口”中的“依赖项”文件夹(如果使用 Xamarin 项目,则为“包”文件夹)并选择“管理 NuGet 包...” 。
“管理NuGet包”对话框出现。 确保对话框左下角的 “包源”下拉列表设置为
nuget.org
“,以便搜索中心NuGet包存储库。例如,使用右上角的 搜索 框查找特定包
EntityFramework
。 找到要使用的包后,请选择它并选择 “添加包 ”按钮以开始安装。下载包后,会将其添加到项目中。 解决方案将根据正在编辑的项目类型而发生变化:
Xamarin 项目
- “引用”节点包含属于 NuGet 包的所有程序集列表。
- “包” 节点显示已下载的每个NuGet包。 可以更新该列表中的包,或从列表中删除包。
.NET Core 项目
- 依赖项> NuGet 节点显示已下载的每个NuGet包。 可以更新该列表中的包,或从列表中删除包。
使用 NuGet 包
添加 NuGet 包并更新项目引用后,可以如针对任何项目引用一样根据 API 对其进行编程。
请确保将任何所需的 using
指令添加到文件顶部:
using Newtonsoft.Json;
更新包
通过右键单击“依赖项”节点(对于 Xamarin 项目为“包”节点)可以一次性完成所有包更新,也可以在每个包上单独进行包更新。 当新版本的 NuGet 包可用时,将显示
右键单击“依赖项”,以访问上下文菜单,然后选择“更新”以更新所有包:
- 管理 NuGet 包 - 打开窗口,将更多包添加到项目。
- 更新 - 检查每个包的源服务器并下载任何更新版本。
- 还原 - 下载任何缺少的包(无需将现有包升级到更新版本)。
更新 和 还原 选项也可以在解决方案级别使用,并影响解决方案中的所有项目。
更新为包的预发行版本
若要更新为包的较新预发行版本,可以右键单击“依赖项”以打开上下文菜单,然后选择“管理 NuGet 包...”菜单 。
选中对话框底部的 “包括预发布” 复选框。
最后,从对话框的“ 更新 ”选项卡中,选择要更新的包,然后从“ 新版本 ”下拉列表中选择新的预发行版本,然后选择“ 更新包”。
查找过时的包
在 解决方案 窗口中,可以查看当前安装的包版本。 右键单击要更新的包。
当包的新版本可用时,你还将看到包名称旁边的通知。 可以决定是否要更新它。
显示的菜单中包含两个选项:
- 更新 - 检查源服务器并下载更新版本(如果存在)。
- 删除 - 从此项目中删除包,并从项目引用中删除相关的程序集。
管理解决方案的包
管理解决方案的包是同时处理多个项目的便捷方式。
右键单击解决方案,并选择“管理 NuGet 包…”:
管理解决方案包时,UI 允许你选择受操作影响的项目:
“合并”选项卡
使用多个项目的解决方案时,请确保在每个项目中使用同一NuGet包的任何位置,也使用相同的包版本号。 Visual Studio for Mac当你选择管理解决方案的包时,通过在 程序包管理器 UI 中提供 “合并”选项卡来帮助简化。 使用 “合并 ”选项卡,可以轻松查看解决方案中不同项目使用具有不同版本号的包的位置:
在此示例中,NuGetDemo 项目使用的是 Microsoft.EntityFrameworkCore 3.1.23,而 NuGetDemo.Shared 使用的是 Microsoft.EntityFrameworkCore 5.0.2。 若要合并包版本,请执行以下步骤:
- 在项目列表中选择要更新的项目。
- 选择要在 新版本 列表中所有这些项目中使用的版本,例如 Microsoft.EntityFrameworkCore 6.0.3。
- 选择“合并包”按钮。
包管理器将选定的包版本安装到所有选定的项目中,之后包不再显示在“合并”选项卡上。
添加包源
最初从 nuget.org 检索安装包。然而,可以将其他包位置添加到 Visual Studio for Mac。 它可用于测试正在开发的你自己的NuGet包,或使用公司或组织内的专用NuGet服务器。
在 Visual Studio for Mac 中,导航到“Visual Studio”>“首选项”>“NuGet”>“源”,查看和编辑包源的列表。 源 可以是由 URL) 或本地目录指定的远程服务器 (。
选择 “添加” 以设置新源。 输入友好 名称和****位置, (包源的 URL 或文件路径) 。 如果源是安全的 Web 服务器,则输入 用户名和密码,否则请将这些条目留空:
搜索包时可以选择不同的源:
版本控制
NuGet 文档讨论了在不将包提交到源控件的情况下使用 NuGet。 如果不希望将二进制文件和未使用信息存储到源代码管理中,可以将 Visual Studio for Mac 配置为自动从服务器还原包。 当开发人员第一次从源代码管理检索项目时,Visual Studio for Mac将自动下载并安装所需的包。
有关如何使 packages
目录不受跟踪的详细信息,请参阅特定的源控件文档。