將套件發佈至 Azure Artifacts 摘要

Azure Artifacts 可讓開發人員有效率地從單一摘要管理其所有相依性。 Azure Artifacts 中的摘要可作為組織存放庫,以儲存、管理及共用小組、跨組織或公開在因特網上的套件。 Azure Artifacts 摘要支援各種不同的套件類型,包括 NuGet、npm、Python、Maven、Cargo 和通用套件。

本文將逐步引導您完成將第一個套件發佈至 Azure Artifacts 摘要的程式。 您也可以選擇使用 GitHub Copilot 來簡化此程式,並探索 Visual Studio Code 中 GitHub Copilot Chat 的功能。

必要條件

建立摘要

  1. 登入您的 Azure DevOps 組織,然後瀏覽至您的專案。

  2. 選取 [ 成品],然後選取 [ 建立摘要]。

  3. 提供摘要的描述性 名稱 ,並設定其 可見度 (誰可以在您的摘要中檢視套件)。 定義摘要的範圍,如果您想要包含來自公用來源的套件,請核取 [上游來源] 複選框。

  4. 完成後,選取 [建立]

    顯示如何在 Azure DevOps Services 中建立新摘要的螢幕快照。

  1. 登入您的 Azure DevOps 伺服器,然後流覽至您的專案。

  2. 選取 [ 成品],然後選取 [ 建立摘要]。

  3. 提供摘要的描述性 名稱 ,並設定其 可見度 (誰可以在您的摘要中檢視套件)。 定義摘要的範圍,如果您想要包含來自公用來源的套件,請核取 [上游來源] 複選框。

  1. 完成後,選取 [建立]

    顯示如何在 Azure DevOps Server 2022 中建立新摘要的螢幕快照。

  1. 完成後,選取 [建立]

    顯示如何在 Azure DevOps Server 2020 中建立新摘要的螢幕快照。

準備程序代碼

請遵循下列步驟,從命令行建立基本類別庫專案、設定套件的元數據,以及產生 NuGet 套件:

  1. 在您的本機計算機上,建立新的資料夾,併為其命名。

  2. 開啟命令提示字元視窗,並流覽至您建立的資料夾。

  3. 執行下列命令以建立新的類別庫專案:

    .NET CLI
    dotnet new classlib
    
  4. 開啟您的 csproj 檔案,並在標記中 <PropertyGroup> 新增套件元數據。 您的檔案結構應該如下所示:

    XML
    <Project Sdk="Microsoft.NET.Sdk">
    
      <PropertyGroup>
        <TargetFramework>net8.0</TargetFramework>
        <RootNamespace>demo_class_library</RootNamespace>
        <ImplicitUsings>enable</ImplicitUsings>
        <Nullable>enable</Nullable>
    
        <PackageId>YOUR_PACKAGE_NAME</PackageId>
        <Version>YOUR_PACKAGE_VERSION</Version>
        <Authors>YOUR_NAME</Authors>
        <Company>YOUR_COMPANY</Company>
    
      </PropertyGroup>
    
    </Project>
    
  5. 執行下列命令來封裝項目併產生 .nupkg 成品。 您的 NuGet 套件會在 目錄中產生 bin\release

    .NET CLI
    dotnet pack
    

聯機到摘要

  1. 選取 [ 成品] ,然後從下拉功能表中選取您的摘要。

  2. 選取 [連線至摘要],然後從 [NuGet] 區段中選取 dotnet

  3. 請遵循 Project 安裝程式中的指示來設定 nuget.config 檔案。 您的檔案結構看起來應該如下所示:

    • 專案範圍的摘要

      XML
      <?xml version="1.0" encoding="utf-8"?>
      <configuration>
        <packageSources>
          <clear />
          <add key="<FEED_NAME>" value="https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json" />
        </packageSources>
      </configuration>
      
    • 組織範圍的摘要

      XML
      <?xml version="1.0" encoding="utf-8"?>
      <configuration>
        <packageSources>
          <clear />
          <add key="<FEED_NAME>" value="https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json" />
        </packageSources>
      </configuration>
      
  1. 登入您的 Azure DevOps 集合,然後流覽至您的專案。

  2. 選取 [ 成品],然後從下拉功能表中選取您的摘要。

  3. 選取 [ 連線至摘要],然後從左側瀏覽窗格中選取 dotnet

  4. 請遵循 Project 安裝程式一節中的指示來設定 nuget.config 檔案,並連線到您的摘要。

    顯示如何在 Azure DevOps Server 2020 和 2022 中使用 dotnet 連線到摘要的螢幕快照。

提示

您可以詢問 GitHub Copilot「如何將新的套件來源新增至現有的 nuget.config 檔案」。 Copilot 會引導您使用 nuget sources Add 命令將新的摘要來源 URL 新增至 nuget.config 檔案。

發佈套件

從您的項目目錄執行下列命令來發佈套件。 ApiKey 是必要的,但您可以在發佈至 Azure Artifacts 摘要時使用任何字串值。

.NET CLI
dotnet nuget push --source <FEED_NAME> --api-key az <PACKAGE_PATH>

下一步