Nuget（BagGet）使用教程

2023-11-17 16:19:16

Nuget（BagGet）使用教程

1. 服务器安装ASP.NET Core

网上有很多教程，不多讲，链接给你：https://www.cnblogs.com/Agui520/p/8331499.html

只需要安装SDK和Runtime即可。安装成功在命令窗口界面输入命令“dotnet -v”便可看到下面内容。

2. 部署BagGet环境

接着我们就部署环境了。服务器当然要装IIS。这就不会废话了。
安装教程：
server2008:https://www.cnblogs.com/luckly-hf/p/4073657.html
server2012:https://jingyan.baidu.com/article/90895e0ffb5c1764ec6b0bbb.html

正题：

添加应用程序池（BagGet是Core，所以应用程序池的托管模式为“无托管代码”）

添加网站（Core的默认端口为5000，所以我们这边端口设置为5000，防火墙若是开启状态，请开放5000端口）

运行网站
网站添加完毕，浏览“http://localhost:5000/”或者“http://IP:5000/”，便可以看到以下画面，BetGet就算是安装完成了。

3. 上传包

上传包我们使用官方的上传工具 下载地址：https://github.com/NuGetPackageExplorer/NuGetPackageExplorer

上传描述
1. 我们下载下来打来软件。"Ctrl+N"创建新包
2. 接着我们就是看到如下，需要我们填下包的描述
  
  我们来看下这些包描述
  必填（前面四项）
  - id:不区分大小写的包标识符，在 nuget.org 或包驻留的任意库中必须是唯一的。 ID 不得包含空格或对 URL 无效的字符，通常遵循 .NET 命名空间规则。
  - version:遵循 major.minor.patch 模式的包版本。版本号可能包括预发布后缀，如包版本控制中所述。
  - description:用于 UI 显示的包的详细说明。
  - authors：作者。
  - title：明了易用的包标题，通常用在 UI 显示中，如 nuget.org 上和 Visual Studio 中包管理器上的那样。如果未指定，则使用包 ID。
  - owners ：包拥有者，使用 nuget.org 上的配置文件名称的包创建者的逗号分隔列表。
  - projectUrl：包的主页 URL，通常显示在 UI 中以及 nuget.org 中。
  - licenseUrl：许可证Url。
  - iconUrl： 64x64 透明背景图像的 URL，用作 UI 显示中包的图标。请确保此元素包含直接图像 URL，而不是包含图像的网页的 URL。
  - requireLicenseAcceptance：一个布尔值，用于指定客户端是否必须提示使用者接受包许可证后才可安装包。
  - developmentDependency：一个布尔值，用于指定包是否被标记为仅开发依赖项，从而防止包作为依赖项包含到其他包中。
  - summary 用于 UI 显示的包的简要说明。如果省略，则使用 description 的截断版本。
  - releaseNotes：此版本包中所作更改的说明，通常代替包说明用在 UI 中，如 Visual Studio 包管理器的“更新”选项卡。
  - copyright：包的版权详细信息。
  - language：包的区域设置 ID。
  - tags：以空格分隔的标记和关键字列表，描述包并通过搜索和筛选辅助包的可发现性。
  - serviceable：可维护性，仅限内部使用。
  - minClientVersion: 指定可安装此包的最低 NuGet 客户端版本，并由 nuget.exe 和 Visual Studio 程序包管理器强制实施。
  - dependencies：零个或多个元素的集合，用来指定包的依赖项。每个 dependency 都具有 id、version、include (3.x+) 和 exclude (3.x+) 特性。（点击进去可看到下图，再点击下图红框进入下下图，可根据包源地址进行筛选）
  - frameworkAssemblies ：零个或多个 <frameworkassembly> 元素的集合，用来标识此包要求的 .NET Framework 程序集引用，从而确保引用添加到使用该包的项目。
目前经常用的差不多这些 填写完毕就可以看到下面内容
添加要上传的内容

在工具的右边右击就可以添加给各类东西
- build：输出到bin目录
- content：原样拷贝
- lib：添加引用
- src：源码拷贝
- tools：工具？
ps：上图可以看下lib的引用的dll信息，这些信息可在vs里面进行设置，包括强签名等。
上传流程

全部工作准备好了，选择菜单“File”，save，savsAs是保存到本地，我们选择publish。
ps：上传需要注册，并拿到key。注册教程（这篇文章内容只关注如何获取key）：https://blog.****.net/wangwenru6688/article/details/50276405

上传成功后，我们就可以在我们BagGet的web看到我们上传好的包了。

这样，我们就将nuget包上传到我们自己的服务器了。（同个包不同版本的id应该是一样的）

4. 项目引用包

接下来，我们要怎么去引用这样些nuget包呢？

首先要先添加我们自己服务器的nuget包源。
工具=>选项=>nuget包管理器=>程序包源=>新增一条（http://192.168.101.188:5000/v3/index.json）=>点击更新
选中要引用包的项目（类库）进入nuget包管理器（怎么进的，就不解释了，自己百度去）。就可以看到我们上传的包，按照平常那样引用或者更新就可以了。（**当然你熟悉引用命令也可以直接用命令引用(原本命令与core命令都可以用)，具体就不解释了，附上教程：https://www.cnblogs.com/zhaogaojian/p/8398531.html）
我们看下我们引用的包会在哪？
1. 首先dll肯定在引用里面了
2. 作为content原样复制，它是在根目录了
3. 其他的我发现都在我们项目目录底下的“packages”的相对应的目录底下

5. 删除包

ps：若是我们上传同样的包或是怎么样的呢？这边会报409的状态异常的错误包，上传工具并不会提醒你上传失败，或者已有此包。

所以我们若是要重新上传或更新已有的版本，或者上传错误，想要删除肯定要删除我们已经上传的包。但是我发现大佬只做了接口，并没有集成在页面，页面是用来node.js和React，表示是个前端渣，但不懂，不懂得修改，所以就自己做了个winform来删除包源。

但是要注意下，这边大佬是分软删除和硬删除的，软删除只是网页看不见了，但其实你知道包id还是同样可以引用，更坑的是，软删除，nuget管理器还是可以看到你的包。硬删除就是大家所理解的将包真的删除掉了。
那么如何开启呢，BagGet采用的是Core，所以配置项并不是在Web.config中，而是appsettings.json,只需要在配置加上这句话，就成了硬删除了，若是要软删除，就去掉这句话。

"PackageDeletionBehavior":"HardDelete" ,