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

# 適用於 Python 的 AWS Encryption SDK
<a name="python"></a>

本主題說明如何安裝及使用 適用於 Python 的 AWS Encryption SDK。如需使用 進行程式設計的詳細資訊 適用於 Python 的 AWS Encryption SDK，請參閱 GitHub 上的 [aws-encryption-sdk-python](https://github.com/aws/aws-encryption-sdk-python/) 儲存庫。如需 API 文件，請參閱[閱讀相關文件](https://aws-encryption-sdk-python.readthedocs.io/en/latest/)。

**Topics**
+ [先決條件](#python-prerequisites)
+ [安裝](#python-installation)
+ [範例](python-example-code.md)

## 先決條件
<a name="python-prerequisites"></a>

安裝 之前 適用於 Python 的 AWS Encryption SDK，請確定您有下列先決條件。

**支援的 Python 版本**  
3.2.0 版和更新 適用於 Python 的 AWS Encryption SDK 版本需要 Python 3.8 或更新版本。  
[AWS 密碼編譯材料提供者程式庫](https://github.com/aws/aws-cryptographic-material-providers-library) (MPL) 是 4.*x* 版中 適用於 Python 的 AWS Encryption SDK 引入之 的選用相依性。如果您想要安裝 MPL，則必須使用 Python 3.11 或更新版本。
舊版 AWS Encryption SDK 支援 Python 2.7 和 Python 3.4 及更新版本，但建議您使用最新版本的 AWS Encryption SDK。  
若要下載 Python，請參閱 [Python 下載](https://www.python.org/downloads/)。

**適用於 Python 的 pip 安裝工具**  
`pip` 包含在 Python 3.6 和更新版本中，但您可能想要升級。如需升級或安裝 的詳細資訊`pip`，請參閱 `pip` 文件中的[安裝](https://pip.pypa.io/en/latest/installation/)。

## 安裝
<a name="python-installation"></a>

安裝最新版本的 適用於 Python 的 AWS Encryption SDK。

**注意**  
所有 適用於 Python 的 AWS Encryption SDK 早於 3.0.0 的 版本都處於[end-of-support階段](https://docs.aws.amazon.com/sdkref/latest/guide/maint-policy.html#version-life-cycle)。  
您可以從 2.0.*x* 版和更新版本安全地更新至最新版本的 ， AWS Encryption SDK 而不需要變更任何程式碼或資料。不過，2.0.*x* 版中引進[的新安全功能](about-versions.md#version-2)無法回溯相容。若要從 1.7.*x* 之前的版本更新至 2.0.*x* 及更新版本，您必須先更新至最新的 1 AWS Encryption SDK.*x* 版本。如需詳細資訊，請參閱[遷移您的 AWS Encryption SDK](migration.md)。

使用 `pip` 安裝 適用於 Python 的 AWS Encryption SDK，如下列範例所示。

**若要安裝最新版本**  

```
pip install "aws-encryption-sdk[MPL]"
```
`[MPL]` 尾碼會安裝[AWS 密碼編譯物料提供者程式庫 ](https://github.com/aws/aws-cryptographic-material-providers-library)(MPL)。MPL 包含用於加密和解密資料的建構。MPL 是 4.*x* 版中 適用於 Python 的 AWS Encryption SDK 引入之 的選用相依性。我們強烈建議您安裝 MPL。不過，如果您不打算使用 MPL，您可以省略`[MPL]`尾碼。

如需使用 pip 來安裝及升級套件的詳細資訊，請參閱[安裝套件](https://packaging.python.org/tutorials/installing-packages/)。

在所有平台上 適用於 Python 的 AWS Encryption SDK 都需要[密碼編譯程式庫](https://cryptography.io/en/latest/) (pyca/cryptography)。所有版本的 `pip`會自動在 Windows 上安裝和建置程式`cryptography`庫。 `pip` 8.1 和更新版本會自動在 Linux `cryptography`上安裝和建置 。如果您使用的是舊版 ，`pip`而且 Linux 環境沒有建置程式`cryptography`庫所需的工具，則需要安裝它們。如需詳細資訊，請參閱[在 Linux 上建置密碼編譯](https://cryptography.io/en/latest/installation.html#building-cryptography-on-linux)。

密碼[編譯](https://cryptography.io/en/latest/)相依性介於 2.5.0 和 3.3.2 之間的 適用於 Python 的 AWS Encryption SDK PIN 版本 1.10.0 和 2.5.0。其他版本的 適用於 Python 的 AWS Encryption SDK 安裝最新版本的密碼編譯。如果您需要 3.3.2 之後的加密版本，建議您使用最新的 主要版本。 適用於 Python 的 AWS Encryption SDK

如需 的最新開發版本 適用於 Python 的 AWS Encryption SDK，請前往 GitHub 中的 [aws-encryption-sdk-python](https://github.com/aws/aws-encryption-sdk-python/) 儲存庫。

安裝 之後 適用於 Python 的 AWS Encryption SDK，請先查看本指南中的 [Python 範例程式碼](python-example-code.md)。