示例:在Nuget发布自己的包的步骤

一、目的:很多时候都在用第三方的Nuget包,现成的轮子可以减少很多工作量,同时我们也可以造轮子供自己和其他人使用,本示例主要演示如何发布dll到Nuget上

 

 

二、环境:

Win10、VS2019、nuget.exe、nuget.org 帐户

 

三、步骤:

 

1、创建nuget.org 帐户

    注册地址 https://www.nuget.org/

 

2、下载nuget.exe

    下载地址:https://dist.nuget.org/win-x86-commandline/latest/nuget.exe

    将nuget.exe 设置系统环境变量,方便使用命令,也可以不设置,不设置则要使用全路径

3、创建一个程序集

      设置程序集描述信息,这些会生成在nuget包中

// 有关程序集的一般信息由以下
// 控制。更改这些特性值可修改
// 与程序集关联的信息。
[assembly: AssemblyTitle("我的标题")]
[assembly: AssemblyDescription("我的说明")]
[assembly: AssemblyConfiguration("")]
[assembly: AssemblyCompany("我的公司")]
[assembly: AssemblyProduct("我的产品")]
[assembly: AssemblyCopyright("Copyright ©  2019")]
[assembly: AssemblyTrademark("")]
[assembly: AssemblyCulture("")]

// 将 ComVisible 设置为 false 会使此程序集中的类型
//对 COM 组件不可见。如果需要从 COM 访问此程序集中的类型
//请将此类型的 ComVisible 特性设置为 true。
[assembly: ComVisible(false)]

// 如果此项目向 COM 公开,则下列 GUID 用于类型库的 ID
[assembly: Guid("70dabedf-1206-4a25-a55a-d54ec5ec14a5")]

// 程序集的版本信息由下列四个值组成: 
//
//      主版本
//      次版本
//      生成号
//      修订号
//
//可以指定所有这些值,也可以使用“生成号”和“修订号”的默认值
//通过使用 "*",如下所示:
// [assembly: AssemblyVersion("1.0.*")]
[assembly: AssemblyVersion("1.0.0.0")]
[assembly: AssemblyFileVersion("1.0.0.0")]

    确保修改后重新生成程序集

4、生成nuget清单文件(.nuspec )

主要通过三个命令:nuget spec、nuget packnuget push

在解决方案.csject目录下执行cmd命令 nuget spec

示例:

C:\Users\Hebiangu\source\repos\hebiangu.nugettest\hebiangu.nugettest>nuget spec
已成功创建“hebiangu.nugettest.nuspec”。

此时,在同级目录下生成了一个清单文件,内容如下:

<?xml version="1.0"?>
<package >
  <metadata>
    <id>$id$</id>
    <version>$version$</version>
    <title>$title$</title>
    <authors>$author$</authors>
    <owners>$author$</owners>
    <licenseUrl>http://LICENSE_URL_HERE_OR_DELETE_THIS_LINE</licenseUrl>
    <projectUrl>http://PROJECT_URL_HERE_OR_DELETE_THIS_LINE</projectUrl>
    <iconUrl>http://ICON_URL_HERE_OR_DELETE_THIS_LINE</iconUrl>
    <requireLicenseAcceptance>false</requireLicenseAcceptance>
    <description>$description$</description>
    <releaseNotes>Summary of changes made in this release of the package.</releaseNotes>
    <copyright>Copyright 2019</copyright>
    <tags>Tag1 Tag2</tags>
  </metadata>
</package>

 

  5、执行打包命令,生成.nupkg文件

在解决方案.csject目录下执行cmd命令 nuget pack

示例:

C:\Users\HeBianGu\source\repos\hebiangu.nugettest\hebiangu.nugettest>nuget pack
正在尝试从“hebiangu.nugettest.csproj”生成程序包。
MSBuild auto-detection: using msbuild version '16.0.462.64354' from 'D:\Program Files (x86)\Microsoft Visual Studio\2019\Community\MSBuild\Current\bin'.
正在打包“C:\Users\HeBianGu\source\repos\hebiangu.nugettest\hebiangu.nugettest\bin\Debug”中的文件。
正在对元数据使用“hebiangu.nugettest.nuspec”。
Successfully created package 'C:\Users\HeBianGu\source\repos\hebiangu.nugettest\hebiangu.nugettest\hebiangu.nugettest.1.0.0.nupkg'.

 

此时在同级目录下会生成一个.nupkg文件,此时打包任务已经完成

 

6、上传发布Nuget包

首先、获取密钥:登录nuget.org 帐户,在右上角下拉菜单中找到API Key,点击Create创建一个密钥,输入Key Name,输入Glob Pattern 为 *,点击创建,完后点击Copy复制密钥 如: oy2lfjcetwxsiutysnje9867c5s83hnf6aj5q,注意需要自己保存密钥

 

 

 

 

 

其次、上传包

在同级目录执行如下命令即可

nuget push hebiangu.nugettest.1.0.0.nupkg oy2lfjcetwxsiutysnje9867c5s83hnf6aj5q -Source https://api.nuget.org/v3/index.json

hebiangu.nugettest.1.0.0.nupkg :是打包最终生成的.nupkg文件

oy2lfjcetwxsiutysnje9867c5s83hnf6aj5q:是产品密钥,产品密钥需要在注册nuget.org 帐户

示例:

C:\Users\HeBianGu\source\repos\hebiangu.nugettest\hebiangu.nugettest>nuget push hebiangu.nugettest.1.0.0.nupkg oy2lfjcetwxsiutysnje9867c5s83hnf6aj5q -Source https://api.nuget.org/v3/index.json
Pushing hebiangu.nugettest.1.0.0.nupkg to 'https://www.nuget.org/api/v2/package'...
  PUT https://www.nuget.org/api/v2/package/
警告: <licenseUrl> element will be deprecated,please consider switching to specifying the license in the package. Learn more: https://aka.ms/deprecateLicenseUrl.
  Created https://www.nuget.org/api/v2/package/ 1831ms
Your package was pushed.

以上就是发布的全部过程

 

注意:

1、创建的 hebiangu.nugettest.1.0.0 名称不能和服务器上已有的包名重复,否则会报403错误,检查方式是到nuget上搜索一下有没有该名称的包

2、上传的包会通过审查,需要等一段时间大概一个小时以内才能搜索到

 

3、创建一个批处理文件一键发布

    创建文件:nuget-push.bat

    文件内容如下,将批处理文件放到程序集目录下执行即可一键发布:

cd  %~dp0

nuget spec

nuget pack

nuget push  hebiangu.nugettest.1.0.0.nupkg oy2leteteymeerertetedc3aufgfool4is6aj5q -Source https://api.nuget.org/v3/index.json

pause

 

 

此时在nuget.org和VS中可以搜索并应用自己的包了

 

 

 

 

 

 

 

 

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章