Nuget(BagGet)使用教程

发布日期:2019-10-14

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.htmlserver2012: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

上传描述

    我们下载下来打来软件。"Ctrl+N"创建新包

    接着我们就是看到如下,需要我们填下包的描述我们来看下这些包描述必填(前面四项)

    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:零个或多个

    frameworkAssemblies : 零个或多个

目前经常用的差不多这些 填写完毕就可以看到下面内容

添加要上传的内容

在工具的右边右击就可以添加给各类东西

build:输出到bin目录content:原样拷贝lib:添加引用src:源码拷贝tools:工具?、

ps:上图可以看下lib的引用的dll信息,这些信息可在vs里面进行设置,包括强签名等。

上传流程

全部工作准备好了,选择菜单“File”,savesavsAs是保存到本地,我们选择publishps:上传需要注册,并拿到key。注册教程(这篇文章内容只关注如何获取key):https://blog.csdn.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)

    我们看下我们引用的包会在哪?

      首先dll肯定在引用里面了

      作为content原样复制,它是在根目录了

      其他的我发现都在我们项目目录底下的“packages”的相对应的目录底下

5. 删除包

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

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

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

"PackageDeletionBehavior":"HardDelete" ,

那附上我自己写的删除winform吧。

链接: https://pan.baidu.com/s/1bLQ_GTh92wr0Vt9z7JhsPQ 提取码:db69

截图

    先填好BagGet的服务器,只需要修改ip即可,再填好NuGetKey,当然你要是想保存在程序里,可以选择保存

    接着刷新,下面的树就会刷新出来,你的nuget服务器上的程序包,以及版本

    选中版本,选中包的信息与要删除的版本就会出现右边,然后点击删除就可以了。