将包发布到 Azure Artifacts 源

Azure Artifacts 使开发人员能够从单个源有效地管理其所有依赖项。 Azure Artifacts 中的源充当组织存储库，用于在团队中、跨组织或公开在 Internet 中存储、管理和共享包。 Azure Artifacts 源支持各种包类型，包括 NuGet、npm、Python、Maven、Cargo 和通用包。

本文将指导完成将第一个包发布到 Azure Artifacts 源的过程。 还可以选择使用 GitHub Copilot 简化此过程，并探索 Visual Studio Code 中 GitHub Copilot Chat 的功能。

先决条件

• 创建 Azure DevOps 组织和项目（如果尚未创建）。

• 安装 .NET Core SDK。

• 安装 Azure Artifacts 凭据提供程序。

• （可选） 设置 GitHub Copilot 和 Visual Studio Code。 如果尚未注册，可以使用 30 天 GitHub Copilot 免费试用版。

创建源

1. 登录到 Azure DevOps 组织，并导航到你的项目。

2. 选择“项目”，然后选择“创建源”。

3. 为源提供描述性 名称 并设置其 可见性 （谁可以查看源中的包）。 定义源的范围，如果要包含来自公共源的包，请选中“上游源”复选框。

4. 完成操作后，选择“创建”。

   

准备代码

不使用 GitHub Copilot

按照以下步骤从命令行创建基本类库项目、设置包的元数据并生成 NuGet 包：

1. 在本地计算机上，创建新文件夹并为其命名。

2. 打开命令提示符窗口并导航到创建的文件夹。

3. 运行以下命令以创建新的类库项目：

   dotnet new classlib
   

4. 打开 csproj 文件，并在标记中添加<PropertyGroup>包元数据。 文件结构应如下所示：

   <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 。

   dotnet pack
   

使用 GitHub Copilot

将包发布到之前创建的源之前，必须先打包项目并准备发布。

以下示例逐步讲解如何使用 GitHub Copilot 创建示例 .NET Core 类库，并从命令行生成 NuGet 包。 还可以使用 GitHub Copilot 生成其他类型的项目，例如 npm 或 Python 项目。

1. 打开 Visual Studio Code，然后从左侧导航面板中选择聊天图标以打开 GitHub Copilot Chat。

2. 在提示框中。 询问 GitHub copilot：“如何实现创建 .NET Core 项目并将其打包为 NuGet 包？”。 GitHub Copilot 的响应可能类似于以下内容：

   

3. 按照提供的步骤生成项目、定义包 ID 和版本以及打包项目。

还可以要求 GitHub Copilot 使用 @workspace 命令解释项目结构，这样就可以与当前工作区中的文件和文件夹进行交互。

@workspace 说明应用结构

了解新源代码的另一个有用方法是询问 GitHub Copilot 项目内特定文件的相关程度。 例如，可以询问 csproj 文件与Class1.cs文件相关的方式：

#file：artifacts-github-copilot.csproj #file:Class1.cs 这些文件的相关方式

连接到源

1. 选择“项目”，然后从下拉菜单中选择源。

2. 选择“连接到源”，然后从“NuGet”部分选择 dotnet。

3. 按照 Project 设置中的说明设置 nuget.config 文件。 文件的结构应如下所示：

   • 项目范围的源：

     <?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 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>
     

提示

可以询问 GitHub Copilot，“如何将新包源添加到现有 nuget.config 文件”。 Copilot 将指导你完成使用 nuget sources Add 命令将新的源源 URL 添加到 nuget.config 文件。

发布包

从项目目录中运行以下命令以发布包。 ApiKey 是必需的，但在发布到 Azure Artifacts 源时可以使用任何字符串值。

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

后续步骤

监视项目存储共享包公开管理权限