第 4 版 (V4) 適用於 .NET 的 AWS SDK 已發行！

如需有關中斷變更和遷移應用程式的資訊，請參閱[遷移主題](https://docs.aws.amazon.com/sdk-for-net/v4/developer-guide/net-dg-v4.html)。

 [https://docs.aws.amazon.com/sdk-for-net/v4/developer-guide/net-dg-v4.html](https://docs.aws.amazon.com/sdk-for-net/v4/developer-guide/net-dg-v4.html)

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 使用 NuGet 安裝 AWSSDK 套件
<a name="net-dg-install-assemblies"></a>

[NuGet](https://www.nuget.org/) 是適用於 .NET 平台的套件管理系統。使用 NuGet，您可以將 [AWSSDK 套件](https://www.nuget.org/profiles/awsdotnet)以及其他數個擴充功能安裝到您的專案。如需詳細資訊，請參閱 GitHub 網站上的 [aws/dotnet](https://github.com/aws/dotnet) 儲存庫。

NuGet 一律具有最新版本的 AWSSDK 套件，以及先前的版本。NuGet 知道套件之間的相依性，並自動安裝所有必要的套件。

**警告**  
NuGet 套件清單可能包含一個名為「AWSSDK」的套件 （沒有附加識別符）。請勿安裝此 NuGet 套件；它是舊版的，不應用於新專案。

與 NuGet 一起安裝的套件會與您的專案一起存放，而不是存放在中央位置。這可讓您安裝給定應用程式的特定組件版本，無需為其他應用程式產生相容性問題。如需 NuGet 的詳細資訊，請參閱 [NuGet 說明文件](https://learn.microsoft.com/en-us/nuget/)。

**注意**  
如果您無法或無法依專案下載並安裝 NuGet 套件，您可以取得 AWSSDK 組件並將其存放在本機 （或內部部署）。  
如果這適用於您，而且您尚未取得 AWSSDK 組件，請參閱 [取得 AWSSDK 組件](net-dg-obtain-assemblies.md)。若要了解如何使用本機存放的組件，請參閱 [安裝不含 NuGet 的 AWSSDK 組件](net-dg-install-without-nuget.md)。

## 從命令提示字元或終端機使用 NuGet
<a name="package-install-nuget"></a>

1. 前往 [ NuGet 上的 AWSSDK 套件](https://www.nuget.org/profiles/awsdotnet)，並判斷專案中需要哪些套件；例如 **[AWSSDK.S3](https://www.nuget.org/packages/AWSSDK.S3/)**。

1. 從該套件的網頁複製 .NET CLI 命令，如下列範例所示。

   **`dotnet add package AWSSDK.S3 --version 3.3.110.19`**

1. 在專案的 目錄中，執行該 .NET CLI 命令。NuGet 也可以安裝任何的相依性，如 [AWSSDK.Core](https://www.nuget.org/packages/AWSSDK.Core)。

**注意**  
如果您只想要最新版本的 NuGet 套件，您可以從 命令中排除版本資訊，如下列範例所示。  
**`dotnet add package AWSSDK.S3`**

## 從 Visual Studio Solution Explorer 使用 NuGet
<a name="package-install-gui"></a>

1. 在**方案總管**，按右鍵選取您的專案，從內容功能表中選擇**管理 NuGet 套件**。

1. 在 **NuGet Package Manager (NuGet 套件管理員)** 的左窗格中，選擇 **Browse (瀏覽)**。然後，您可以使用搜尋方塊來搜尋要安裝的套件。NuGet 也可以安裝任何的相依性，如 [AWSSDK.Core](https://www.nuget.org/packages/AWSSDK.Core)。

   下圖顯示 **AWSSDK.S3 **套件的安裝。  
![NuGet 套件管理員中顯示的 AWSSDK.S3 套件。](http://docs.aws.amazon.com/zh_tw/sdk-for-net/v4/developer-guide/images/nuget-install-vs-dlg.png)

## 使用套件管理員主控台的 NuGet
<a name="package-install-cmd"></a>

在 Visual Studio 中，選擇**工具**、**NuGet 套件管理員**、**套件管理員主控台**。

您可以使用 **`Install-Package`**命令，從套件管理員主控台安裝您想要的 AWSSDK 套件。例如，若要安裝 [AWSSDK.S3](https://www.nuget.org/packages/AWSSDK.S3)，請使用下列命令。

```
PM> Install-Package AWSSDK.S3
```

NuGet 也可以安裝任何的相依性，如 [AWSSDK.Core](https://www.nuget.org/packages/AWSSDK.Core)。

如果您需要安裝舊版的套件，請使用 `-Version`選項並指定您想要的套件版本，如下列範例所示。

```
PM> Install-Package AWSSDK.S3 -Version 3.3.106.6
```

如需套件管理員主控台命令的詳細資訊，請參閱 Microsoft [NuGet 文件](https://learn.microsoft.com/en-us/nuget/)中的 [PowerShell 參考](https://learn.microsoft.com/en-us/nuget/reference/powershell-reference)。