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 密鑰

  1. 登錄您的 nuget.org 帳戶或創建一個帳戶(如果您還沒有)。

    有關創建帳戶的更多信息,請參閱個人帳戶

  2. 選擇您的用戶名(在右上角),然后選擇API Keys。

  3. 選擇Create,為您的密鑰提供一個名稱,選擇Select Scopes > Push。為Glob 模式輸入 * ,然后選擇Create。(有關范圍的更多信息,請參見下文。)

  4. 創建密鑰后,選擇復制以在 CLI 中檢索您需要的訪問密鑰:

    將 API 密鑰復制到剪貼板

  5. 重要提示:將您的密鑰保存在安全位置,因為您以后無法再次復制該密鑰。如果返回 API 密鑰頁面,則需要重新生成密鑰才能進行復制。如果您不想再通過 CLI 推送包,您也可以刪除 API 密鑰。

范圍允許您為不同的目的創建單獨的 API 密鑰。每個密鑰都有其到期時間范圍,並且可以限定為特定的包(或 glob 模式)。每個鍵也適用於特定操作:推送新包和更新、僅推送更新或下架。通過范圍界定,您可以為為您的組織管理包的不同人員創建 API 密鑰,以便他們僅擁有所需的權限。有關更多信息,請參閱作用域 API 密鑰

 

 

 


 

2、下載Nuget.exe並發布項目

點擊下載nuget.exe

https://www.nuget.org/downloads

我這里下載的是5.9.1版本的,版本這里沒有特別的要求。

這里只有6M多一點,下載太慢了,我把下載好的放在gitee上,大家直接點擊下載解壓即可。

下載地址1(git):https://gitee.com/xiongze/nugetexe-file.git

下載地址2(百度網盤):https://pan.baidu.com/s/1RIbJXzn3aoKWURB_VRjx3w     提取碼:xion

 

 


3、NuGet發布到服務器

將下載下來的nuget.exe與剛才新建的類庫放在同一目錄下。

 

 配置發布信息,並將發布路徑指向或拷貝到與剛才新建的類庫放在同一目錄下。

 

 

①、找到vs對應的開發人員命令提示(不能用cmd直接打開)

 

 或者 C:\ProgramData\Microsoft\Windows\Start Menu\Programs\Visual Studio 2019\Visual Studio Tools

 

命令提示定位到Nuget.exe所在的目錄

 雙擊運行 Developer Command Prompt for VS 2019  cd到項目類庫的目錄

 

 ③通過命令 nuget setapikey  xxxxx-xxxx-xxx-xxxx-xxxx-xxxx (我們上面nuget copy的key), 設置API Key

通過命令 nuget setapikey  xxxxx-xxxx-xxx-xxxx-xxxx-xxxx , 設置API Key;

 

 ④生成xxxx.nuspec文件

nuspec是NuGet將項目打包成nupkg的輸入文件,可以通過nuget spec命令產生。
通過命令 nuget spec 生成xxxx.nuspec文件;

 

 ⑤NuGet發布到服務器

通過命令 nuget.exe push xxxxx.nupkg -Source https://www.nuget.org ,將NuGet發布到服務器。

 

打包成功后,這里需要等待3-10分鍾左右,打包成功后nuget就能查詢到我們打包的引用了,如果沒有的多等待一下。


 

使用NuGet包

我們這個時候就可以在NuGet里面搜索到我們的類庫了,我們引入進來使用一下。

 

 在項目中引入我們的nuget包,然后調用得到下面內容

 


參考文獻 

 
歡迎關注訂閱微信公眾號【熊澤有話說】,更多好玩易學知識等你來取
作者:熊澤-學習中的苦與樂
公眾號:熊澤有話說
出處: https://www.cnblogs.com/xiongze520/p/15234581.html
創作不易,任何人或團體、機構全部轉載或者部分轉載、摘錄,請在文章明顯位置注明作者和原文鏈接。  

 

 

 


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM