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 版本”并不是那么简单。 例如，它可以是 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