本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
遷移您的 AWS Encryption SDK
AWS Encryption SDK 支援多個可互通的程式設計語言實作，每個都是在 GitHub 上的開放原始碼儲存庫中開發。最佳實務是，建議您 AWS Encryption SDK 針對每種語言使用最新版本的 。
您可以安全地從 2.0.x 版或更新版本升級至 AWS Encryption SDK 最新版本。不過， 的 2.0.x 版本 AWS Encryption SDK 引進了重要的新安全功能，其中有些正在中斷變更。若要從 1.7.x 之前的版本升級至 2.0.x 及更新版本，您必須先升級至最新的 1.x 版本。本節中的主題旨在協助您了解變更、為您的應用程式選取正確的版本，以及安全且成功地遷移至最新版本的 AWS Encryption SDK。
如需 重要版本的相關資訊 AWS Encryption SDK，請參閱 的版本 AWS Encryption SDK。
重要
在未先升級至最新的 1.x 版本之前，請勿直接從 1.7.x 版升級至 2.0.x 版或更新版本。如果您直接升級至 2.0.x 版或更新版本，並立即啟用所有新功能， AWS Encryption SDK 則 將無法解密在舊版 下加密的加密文字 AWS Encryption SDK。
注意
for .NET AWS Encryption SDK 的最早版本是 3.0.x 版。 AWS Encryption SDK 適用於 .NET 的所有版本都支援 2.0.x 中引入的安全最佳實務。 AWS Encryption SDK您可以安全地升級至最新版本，而不需要變更任何程式碼或資料。
AWS Encryption CLI：閱讀此遷移指南時，請使用 AWS Encryption CLI 1.8.x 的 1.7.x 遷移說明，並使用 AWS Encryption CLI 2.1.x 的 2.0.x 遷移說明。如需詳細資訊，請參閱 AWS 加密 CLI 的版本。
新的安全功能最初已在 AWS Encryption CLI 1.7.x 和 2.0.x 版中發行。不過， AWS Encryption CLI 1.8.x 版取代了 1.7.x 版，而 AWS Encryption CLI 2.1.x 版取代了 2.0.x。如需詳細資訊，請參閱 GitHub 上 aws-encryption-sdk-cli
- 新使用者
-
如果您是初次使用 AWS Encryption SDK， AWS Encryption SDK 請為您的程式設計語言安裝最新版本的 。預設值會啟用 的所有安全功能 AWS Encryption SDK，包括使用簽署、金鑰衍生和金鑰承諾進行加密。 AWS Encryption SDK
- 目前使用者
-
建議您盡快從目前版本升級至最新的可用版本。所有 1.x 版本 AWS Encryption SDK 都處於end-of-support階段，某些程式設計語言的更新版本也是如此。如需程式設計語言 AWS Encryption SDK 中 支援和維護狀態的詳細資訊，請參閱 支援和維護。
AWS Encryption SDK 2.0.x 版和更新版本提供新的安全功能，以協助保護您的資料。不過，2.0.x AWS Encryption SDK 版包含無法向後相容的重大變更。為了確保安全的轉換，請從您程式設計語言中從目前版本遷移到最新的 1.x 開始。當您最新的 1.x 版本完全部署且成功運作時，您可以安全地遷移至 2.0.x 版和更新版本。這個兩步驟程序對於分散式應用程式尤其重要。
如需這些變更基礎 AWS Encryption SDK 之安全功能的詳細資訊，請參閱 AWS 安全部落格中的改善用戶端加密：明確 KeyIds 和金鑰承諾
尋找 適用於 JAVA 的 AWS Encryption SDK 搭配 使用 的協助 AWS SDK for Java 2.x？ 請參閱 先決條件。
