10分钟学会Visual Studio将自己创建的类库打包到NuGet进行引用(net,net core,C#)

2023-07-22 381

版权

本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。

简介： 10分钟学会Visual Studio将自己创建的类库打包到NuGet进行引用(net,net core,C#)

前言

　　NuGet就是一个包（package）管理平台，确切的说是 .net平台的包管理工具，它提供了一系列客户端用于生成，上传和使用包（package），以及一个用于存储所有包的中心库。

　　对于一个现代化的开发平台，建立一种让开发者创建，分享与使用可复用代码的机制是十分必要的。这种“可复用代码”被打包后的文件通常被称作“包”（package），

对于.NET（包括 .NET Core）平台来说这个机制的实现就是NuGet平台。

　　NuGet的实现均为开源项目，包括了客户端工具，服务器，官方网站以及各语言的文档等。

　　NuGet包的本质是一个以nupkg为后缀的zip压缩文件（你可以将后缀改为.zip后解压查看里面的内容），其中包含了编译后的Dll文件以及其他相关文件。

　　　　　　　　　　　　图1：显示nuget包从创建，上传到被使用的流程

对于引用大家都会使用，但是对于创建NuGet引用就不怎么会了，我们下面就介绍怎么打包dll类库到NuGet平台进行引用。

创建类库方法

我们首先创建一个可调用的类库，以“繁简体相互转换”为例，当然你也可以创建其他的，比如获取配置文件、http请求帮助类等。

这里使用的环境是vs2019， .NET Core2.1，使用.NET也可以，这里可根据自己的使用环境创建。

注意：类库是什么环境，引用也需要什么环境。（.NET Core和.NET不能相互混用）。

创建一个.NET Core类库项目，命名为“XiongZeUtils”（自定义命名），然后在类库项目下创建一个繁简体项目转换的类，命名为“xzUtils”（自定义）。

注意，繁简体相互转换需要现在NuGet引入包ChineseConverter，然后在类里面引用using Microsoft.International.Converters.TraditionalChineseToSimplifiedConverter，如下：

创建完成后记得需要先编译生成dll文件

using Microsoft.International.Converters.TraditionalChineseToSimplifiedConverter;
using System;
namespace XiongZeUtils
{
    public static class xzUtils
    {
        /// <summary> 
        /// 简体转换为繁体
        /// </summary> 
        /// <param name="str">简体字</param> 
        /// <returns>繁体字</returns> 
        public static string GetTraditional(string str)
        {
            string r = string.Empty;
            r = ChineseConverter.Convert(str, ChineseConversionDirection.SimplifiedToTraditional);
            return r;
        }
        /// <summary> 
        /// 繁体转换为简体
        /// </summary> 
        /// <param name="str">繁体字</param> 
        /// <returns>简体字</returns> 
        public static string GetSimplified(string str)
        {
            string r = string.Empty;
            r = ChineseConverter.Convert(str, ChineseConversionDirection.TraditionalToSimplified);
            return r;
        }
    }
}

创建完成后记得需要先编译生成dll文件

NuGet发布到服务器

1、登录NuGet账号获取API keys

官网地址：https://www.nuget.org/

如果你有Microsoft 帐户，直接登录即可。如果没有则需去创建一个。

NuGet登录快捷入口：https://www.nuget.org/users/account/LogOn

（注册地址入口比较难找，下面快捷入口直接点击即可注册）

NuGet注册账号快捷入口：https://signup.live.com/?lic=1

备用方案：

NuGet.org 上的个人帐户：https://docs.microsoft.com/en-us/nuget/nuget-org/individual-accounts

获取您的 API 密钥：https://docs.microsoft.com/en-us/nuget/quickstart/create-and-publish-a-package-using-visual-studio?tabs=netcore-cli

获取您的 API 密钥

登录您的 nuget.org 帐户或创建一个帐户（如果您还没有）。
有关创建帐户的更多信息，请参阅个人帐户。
选择您的用户名（在右上角），然后选择API Keys。
选择Create，为您的密钥提供一个名称，选择Select Scopes > Push。为Glob 模式输入 * ，然后选择Create。（有关范围的更多信息，请参见下文。）
创建密钥后，选择复制以在 CLI 中检索您需要的访问密钥：
重要提示：将您的密钥保存在安全位置，因为您以后无法再次复制该密钥。如果返回 API 密钥页面，则需要重新生成密钥才能进行复制。如果您不想再通过 CLI 推送包，您也可以删除 API 密钥。

范围允许您为不同的目的创建单独的 API 密钥。每个密钥都有其到期时间范围，并且可以限定为特定的包（或 glob 模式）。每个键也适用于特定操作：推送新包和更新、仅推送更新或下架。通过范围界定，您可以为为您的组织管理包的不同人员创建 API 密钥，以便他们仅拥有所需的权限。有关更多信息，请参阅作用域 API 密钥。