亚马逊 CodeCatalyst 不再向新买家开放。现有客户可以继续正常使用该服务。有关更多信息，请参阅 [如何从中迁移 CodeCatalyst](migration.md)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 配置并使用 nuget 或 dotnet CLI
<a name="packages-nuget-cli"></a>

您可以使用`NuGet`和之类的 CLI 工具`dotnet`来发布和使用来自的包 CodeCatalyst。本文档提供有关配置 CLI 工具以及使用这些工具来发布或使用程序包的信息。

**Contents**
+ [

## 使用配置 NuGet CodeCatalyst
](#nuget-configure-cli)
+ [

## 使用 CodeCatalyst 存储库中的 NuGet 软件包
](#nuget-consume-cli)
+ [

## 使用来自 NuGet .org 的 NuGet 软件包 CodeCatalyst
](#nuget-consume-nuget-gallery)
+ [

## 将 NuGet 包发布到 CodeCatalyst
](#nuget-publish-cli)

## 使用配置 NuGet CodeCatalyst
<a name="nuget-configure-cli"></a>

要 NuGet 使用进行配置 CodeCatalyst，请在 NuGet 配置文件中添加存储库端点和个人访问令牌，以允许`nuget`或`dotnet`连接到您的 CodeCatalyst 软件包存储库。

**NuGet 使用您的 CodeCatalyst 软件包存储库进行配置**

1. 打开 CodeCatalyst 控制台，[网址为 https://codecatalyst.aws/](https://codecatalyst.aws/)。

1. 在项目的概述页面上，选择**程序包**。

1. 从程序包存储库列表中，选择您的程序包存储库。

1. 选择**连接到存储库**。

1. 在 “**连接到存储库**” 对话框中，从包管理器客户端列表中选择**NuGet**或 **dotnet**。

1. 您需要使用个人访问令牌 (PAT) NuGet 进行身份验证 CodeCatalyst。如果您已有一个 PAT，则可以使用它。如果没有 PAT，您可以在此处创建一个。

   1. 选择**创建令牌**。

   1. 选择**复制**以复制您的 PAT。
**警告**  
关闭此对话框后，您将无法再次查看或复制您的 PAT。

1. 配置`nuget`或`dotnet`以使用存储库的 NuGet 终端节点和 CodeCatalyst PAT。替换以下值。
**注意**  
如果通过控制台指令进行复制，则以下值将进行更新且不应更改。
   + *username*用您的 CodeCatalyst 用户名替换。
   + *PAT*用您的 CodeCatalyst PAT 替换。
   + *space\$1name*替换为您的 CodeCatalyst 空间名称。
   + *proj\$1name*用您的 CodeCatalyst 项目名称替换。
   + *repo\$1name*替换为你的 CodeCatalyst 软件包存储库名称。

   1. 对于 `nuget`，请使用 `nuget sources add` 命令。

      ```
      nuget sources add -name "repo_name" -Source "https://packages.region.codecatalyst.aws/nuget/space_name/proj_name/repo_name/v3/index.json" -username "username" -password "PAT"
      ```

   1. 对于 `dotnet`，请使用 `dotnet nuget add source` 命令。

      **Linux 和 macOS 用户：**由于在非 Windows 平台上不支持加密，因此您必须在以下命令中添加 `--store-password-in-clear-text` 标志。请注意，这会将您的密码以纯文本形式存储在配置文件中。

      ```
      dotnet nuget add source "https://packages.region.codecatalyst.aws/nuget/space_name/proj_name/repo_name/v3/index.json" -n "proj_name/repo_name" -u "username" -p "PAT" --store-password-in-clear-text
      ```

配置 NuGet 完毕后 CodeCatalyst，您可以[使用存储在存储 CodeCatalyst 库或其中一个上游存储库中的软件 NuGet 包](#nuget-consume-cli)，并将[ NuGet 包发布](#nuget-publish-cli)到您的 CodeCatalyst 存储库。

## 使用 CodeCatalyst 存储库中的 NuGet 软件包
<a name="nuget-consume-cli"></a>

[配置 NuGet ](#nuget-configure-cli)完毕后 CodeCatalyst，即可使用存储在存储 CodeCatalyst 库或其上游存储库中的 NuGet 软件包。

要使用 nuget 或 dotnet 使用存储库或其上游存储库中的软件包版本，请运行以下命令。 CodeCatalyst *packageName*替换为要使用的软件包的*packageSourceName*名称以及 NuGet 配置文件中 CodeCatalyst 软件包存储库的源名称，后者应该是存储库名称。

**使用 `dotnet` 安装程序包**

```
dotnet add packageName --source packageSourceName
```

**使用 `nuget` 安装程序包**

```
nuget install packageName --source packageSourceName
```

有关更多信息，请参阅 *Microsoft 文档*中的[使用 nuget CLI 管理程序包](https://docs.microsoft.com/en-us/nuget/consume-packages/install-use-packages-nuget-cli)或[使用 dotnet CLI 安装和管理程序包](https://docs.microsoft.com/en-us/nuget/consume-packages/install-use-packages-dotnet-cli)。

## 使用来自 NuGet .org 的 NuGet 软件包 CodeCatalyst
<a name="nuget-consume-nuget-gallery"></a>

您可以通过 CodeCatalyst 存储库使用 [NuGet.org](https://www.nuget.org/) 中的 NuGet 软件包，方法是将存储库配置为与 **NuGet.** org 的上游连接。从 **NuGet.org** 使用的软件包会被提取并存储在您的 CodeCatalyst 存储库中。

**使用 NuGet .org 中的软件包**

1. 如果还没有，请 NuGet 按照中的步骤使用 CodeCatalyst 软件包存储库配置软件包管理器[使用配置 NuGet CodeCatalyst](#nuget-configure-cli)。

1. 确保您的存储库已将 **NuGet.org** 添加为上游连接。**您可以按照中的[添加上游存储库](packages-upstream-repositories-add.md)说明并选择存储库来检查添加了哪些上游源代码或将 **Nuget.org** 添加为上NuGet 游源。**

## 将 NuGet 包发布到 CodeCatalyst
<a name="nuget-publish-cli"></a>

[配置完毕后 NuGet CodeCatalyst，](#nuget-configure-cli)就可以使用`nuget`或`dotnet`将包版本发布到 CodeCatalyst 存储库。

要将软件包版本推送到 CodeCatalyst 存储库，请运行以下命令，并在 NuGet 配置`.nupkg`文件中包含文件的完整路径和 CodeCatalyst 存储库的源名称。

**使用 `dotnet` 发布程序包**

```
dotnet nuget push path/to/nupkg/SamplePackage.1.0.0.nupkg --source packageSourceName
```

**使用 `nuget` 发布程序包**

```
nuget push path/to/nupkg/SamplePackage.1.0.0.nupkg --source packageSourceName
```