已移除 Microsoft.DotNet.PlatformAbstractions 套件

我們不會再產生新版本的 Microsoft.DotNet.PlatformAbstractions NuGet 套件。

變更描述

過去，新版本的 Microsoft.DotNet.PlatformAbstractions 程式庫會隨著新版本的 .NET Core 一同產生。 我們未來將不會再新增新功能到程式庫，也不會推出任何新的主要版本。 不過，現有版本的程式庫將繼續運作並接收服務。

Microsoft.DotNet.PlatformAbstractions 程式庫和已經在 System.* 命名空間中建立的 API 重疊。 此外，部分 Microsoft.DotNet.PlatformAbstractions API 的設計未採用與其餘 System.* API 相同層級的監督和長期可支援性。 舉例來說，Microsoft.DotNet.PlatformAbstractions 會使用 Platform 列舉來描述目前的作業系統平台。 設計 RuntimeInformation.IsOSPlatform(OSPlatform) API 時便已明確拒絕此列舉設計，以便接納新平台並提升未來的彈性。

現在，不必使用這個方法也能藉由 Microsoft.DotNet.PlatformAbstractions 實現此案例。 現有的版本將繼續正常運作 (包括 .NET 5 和更新版本)，也將與舊版的 .NET Core 一同接受服務。 不過，我們將不會在程式庫新增功能。 相反地，新的功能會新增到其他城市庫和 API。

導入的版本

5.0

建議的動作

• 如果舊版程式庫能滿足您的需求，您還是可以繼續使用。

• 如果舊版程式庫不能滿足您的需求，請以建議的取代項取代使用 PlatformAbstractions API。

  PlatformAbstractions API	建議的取代項
  ApplicationEnvironment.ApplicationBasePath	AppContext.BaseDirectory
  HashCodeCombiner	System.HashCode
  RuntimeEnvironment.GetRuntimeIdentifier()	RuntimeInformation.RuntimeIdentifier
  RuntimeEnvironment.OperatingSystemPlatform	RuntimeInformation.IsOSPlatform(OSPlatform)
  RuntimeEnvironment.RuntimeArchitecture	RuntimeInformation.ProcessArchitecture
  RuntimeEnvironment.OperatingSystem	RuntimeInformation.OSDescription
  RuntimeEnvironment.OperatingSystemVersion	RuntimeInformation.OSDescription 和 Environment.OSVersion

  注意

  RuntimeEnvironment.OperatingSystem 和 RuntimeEnvironment.OperatingSystemVersion 的大多數使用案例都是用於顯示用途，例如向使用者顯示內容、記錄和遙測。 我們不建議根據作業系統 (OS) 版本制定執行階段決策。 Environment.OSVersion 現在會為 Windows 和 macOS 作業系統傳回正確的版本。 不過，對於大多數 Unix 發行版本而言，定義何謂「OS 版本」並不簡單。 舉例來說，OS 版本可以是 Linux 核心版本，也可以是發行版本。 對大多數的 Unix 平台來說，Environment.OSVersion 和 RuntimeInformation.OSDescription 會傳回由 uname 傳回的版本。 如要取得 Linux 發行版本名稱和版本資訊，建議的做法是閱讀 /etc/os-release 檔案。

受影響的 API

• Microsoft.DotNet.PlatformAbstractions.ApplicationEnvironment.ApplicationBasePath
• Microsoft.DotNet.PlatformAbstractions.HashCodeCombiner
• Microsoft.DotNet.PlatformAbstractions.RuntimeEnvironment.GetRuntimeIdentifier()
• Microsoft.DotNet.PlatformAbstractions.RuntimeEnvironment.OperatingSystem
• Microsoft.DotNet.PlatformAbstractions.RuntimeEnvironment.OperatingSystemPlatform
• Microsoft.DotNet.PlatformAbstractions.RuntimeEnvironment.OperatingSystemVersion
• Microsoft.DotNet.PlatformAbstractions.RuntimeEnvironment.RuntimeArchitecture