[聚合文章] nuget服务器搭建,以及如何发布一个Nuget包

.Net 2017-12-17 28 阅读

本文章主要介绍如何将本地dll打包成为一个Nuget包,并如何发布到自己的nuget服务器,示例代码下载。章节如下

1. 本地dll如何打包,以及版本的更新

2. 在linux上搭建nuget.server

3. 在windows上搭建nuget.server

4. nuget常用命令

一、本地dll如何打包,以及版本的更新

本小节主要介绍两种方式将本地dll打包为Nuget包,

1.1 利用nuget.exe进行打包(应用于.net framework)

1. 下载nuget.exe

nuget.exe下载地址:https://www.nuget.org/downloads。
下载完成后,不需要安装。请将nuget.exe复制到需要打包的项目文件夹中

2. 打包成.nupkg包

image

  • 首先运行.\nuget sepc 生成.nuspec配置文件,用于nuget的配置项
  • 然后运行.\nuget pack packageName 发布成nuget包

3. 注意

此类库更新版本之后,再打包成.nuget文件,是不会重新生成.nuspec文件。

1.2 使用dotnet 进行打包(应用于.net core )

  • 运行 dotnet pack即可对当前项目打包,必须在当前项目文件夹中支持(还有.csproj文件的目录)
  • 对项目进行版本行,可以配置.csprojc文件,如下所示:
<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>netstandard2.0</TargetFramework>
    <Version>1.0.1.1</Version>
    <AssemblyVersion>1.2.0.0</AssemblyVersion>
    <FileVersion>1.3.0.0</FileVersion>
  </PropertyGroup>
</Project>

此处需要注意的时候,默认创建的dll是没Version, AssemblyVersion, FileVersion节点,需要自己手动添加;以及在更新版本后 .nuspec文件会根据版本重新创建一个:
image

1.3 配置nuget源

1. 本地文件包的方式

配置本地Nuget源。在工具 nuget包管理器 -> 程序包源,做如下配置
image
然后把发布的.nupkg包放在此文件夹即可

2. 配置自己服务器的源

 image

注意,如果用的是linux版本,测源地址中不需要加nuget子目录。

1.4 使用

引入界面如下:
image

二、在linux上搭建nuget.server

本小节介绍如何使用docker来搭建属于自己的Nuget仓库

2.1. 运行docker镜像

docker run -d  -p 8080:80 -v $PWD/nuget/db:/var/www/db -v $PWD/nuget/packages:/var/www/packagefiles  -e NUGET_API_KEY=ee28314c-f7fe-2550-bd77-e09eda3d0119  sunside/simple-nuget-server

-v nuget:当前目录下nuget文件夹映射为 nuget-server的包,其中要有packages文件夹。他也有映射
nuget_api_key:表示此Nuget仓库的索引Key。push的要用的

2.2 创建一项目打包和发布

  • 创建一个 classlib 库文件(web,或者webapi是不能打包的)
dotnet new classlib -n Nu.Common
  • 打包 进入到项目根目录,也就是包含.csproj文件的目录
dotnet pack

命令成功后,会在bin/Debug目录下创建.nupkg文件
image

  • 发布包 必须进入到.nupkg包所在位置
..\..\nuget.exe push -Source http://localhost:8080 -ApiKey ee28314c-f7fe-2550-bd77-e09eda3d0119 Nu.Common.1.0.0.nupkg

image

2.3. 引用包

  • 在vs中的引用

 image

  • 在vscode中的引用
    配置nuget.config配置文件
<?xml version="1.0" encoding="utf-8"?>
<configuration>
 <packageSources> 
    <add key="mySource" value="http://localhost:8080" />
 </packageSources>
</configuration>

然后运行dotnet add package Nu.Common(包名)即可.
image

三、在windows上搭建

此方式更为简单,因为nuget上有现在的nuget.server这包,就是用于做这件事情的。步骤如下(此nuget包不支持.net core版本):

3.1  搭建项目

  • 创建一个mvc 项目(空) 此项目必须的.net Framework版本必须>=4.6。
    image
  • 引入nuget.server这个nuget包 image
  • 更改配置
  • 注:本文内容来自互联网,旨在为开发者提供分享、交流的平台。如有涉及文章版权等事宜,请你联系站长进行处理。