快速入門:在 Visual Studio for Mac 中安裝和使用套件

NuGet 套件包含可重複使用的程式碼,由其他開發人員提供您在專案中使用。 請參閱什麼是 NuGet?了解背景知識。 套件會使用 NuGet 封裝管理員 安裝到Visual Studio for Mac專案中。 本文示範使用熱門 的 Newtonsoft.Json 套件和 .NET Core 主控台專案的程式。 相同的程式適用于任何其他 Xamarin 或 .NET Core 專案。

安裝之後,請使用 using <namespace> 參考程式碼中的套件,其中 <namespace> 為您使用的套件專用。 建立參考之後,您可以透過其 API 呼叫套件。

提示

從 nuget.org 開始:流覽 nuget.org 是 .NET 開發人員通常會尋找可在自己的應用程式中重複使用的元件。 您可以直接搜尋 nuget.org,或在 Visual Studio 中尋找並安裝套件,如此文章所示。 如需一般資訊,請參閱尋找和評估 NuGet 套件

必要條件

  • Visual Studio 2019 for Mac。

您可以從 visualstudio.com 免費安裝 2019 Community Edition,或使用 Professional Edition 或 Enterprise Edition。

如果您在Windows上使用Visual Studio,請參閱在Visual Studio (Windows僅) 安裝並使用套件

建立專案

假設 NuGet 套件 支援與專案相同的目標架構,則該套件就可安裝到任何的 .NET 專案中。

在本逐步解說中,請使用簡單的 .NET Core 主控台應用程式。 使用 [檔案 > 新增方案...] 在 Visual Studio for Mac中建立專案,然後選取.NET Core > 應用程式 > 主控台應用程式範本。 按一下 [下一步] 。 出現提示時,接受 Target Framework 的預設值。

Visual Studio 隨即建立專案,而專案會在 [方案總管] 中開啟。

新增 Newtonsoft.Json NuGet 套件

若要安裝套件,請使用 NuGet 封裝管理員。 當您安裝套件時,NuGet 會在您的專案檔或 packages.config 檔案中 (視專案格式而定) 記錄相依性。 如需詳細資訊,請參閱套件使用概觀和工作流程

NuGet 套件管理員

  1. 在方案總管中,以滑鼠右鍵按一下 [相依性],然後選擇 [新增套件...]。

    Manage NuGet Packages command for project References

  2. 選擇 [nuget.org] 作為對話方塊左上角的 [套件來源 ],然後搜尋 Newtonsoft.Json、在清單中選取該套件,然後選取 [ 新增套件...]:

    Locating Newtonsoft.Json package

    如果您想要NuGet 封裝管理員的詳細資訊,請參閱使用 Visual Studio for Mac 來安裝和管理套件

在應用程式中使用 Newtonsoft.Json API

在專案中使用 Newtonsoft.Json 套件,您可以呼叫其 JsonConvert.SerializeObject 方法,將物件轉換成人類可閱讀的字串。

  1. Program.cs開啟位於Solution Pad) 中的檔案 (,並以下列程式碼取代檔案內容:

    using System;
    using Newtonsoft.Json;
    
    namespace NuGetDemo
    {
        public class Account
        {
            public string Name { get; set; }
            public string Email { get; set; }
            public DateTime DOB { get; set; }
        }
    
        class Program
        {
            static void Main(string[] args)
            {
                Account account = new Account()
                {
                    Name = "Joe Doe",
                    Email = "joe@test.com",
                    DOB = new DateTime(1976, 3, 24)
                };
                string json = JsonConvert.SerializeObject(account);
                Console.WriteLine(json);
            }
        }
    }
    
  2. 選取 [ 執行 > 開始偵錯],以建置並執行應用程式:

  3. 應用程式執行之後,您會看到序列化的 JSON 輸出出現在主控台中:

Output of the Console app

下一步

恭喜,您安裝並使用了您的第一個 NuGet 套件!

若要深入探索 NuGet 所提供的功能,請選取下列連結。