Pacote Microsoft.DotNet.PlatformAbstractions removido

Não serão produzidas novas versões do pacote NuGet Microsoft.DotNet.PlatformAbstractions .

Alterar descrição

Anteriormente, novas versões da Microsoft.DotNet.PlatformAbstractions biblioteca eram produzidas juntamente com novas versões do .NET Core. No futuro, nenhuma nova funcionalidade será adicionada à biblioteca e nenhuma nova versão principal será lançada. No entanto, as versões existentes da biblioteca continuarão a funcionar e a ser atendidas.

A Microsoft.DotNet.PlatformAbstractions biblioteca se sobrepõe a APIs que já estão estabelecidas nos namespaces System.*. Além disso, algumas Microsoft.DotNet.PlatformAbstractions APIs não foram projetadas com o mesmo nível de escrutínio e capacidade de suporte de longo prazo que o resto das APIs do Sistema.*. Por exemplo, Microsoft.DotNet.PlatformAbstractions usa a Platform enumeração para descrever a plataforma atual do sistema operacional. Esse design de enumeração foi explicitamente rejeitado quando a RuntimeInformation.IsOSPlatform(OSPlatform) API foi projetada, para permitir novas plataformas e flexibilidade futura.

Os cenários habilitados Microsoft.DotNet.PlatformAbstractions pela biblioteca agora são possíveis sem ela. As versões existentes continuarão a funcionar, mesmo no .NET 5 e posterior, e serão atendidas juntamente com as versões anteriores do .NET Core. No entanto, novas funcionalidades não serão adicionadas à biblioteca. Em vez disso, novas funcionalidades serão adicionadas a outras bibliotecas e APIs.

Versão introduzida

5.0

Ação recomendada

• Você pode continuar a usar versões mais antigas da biblioteca se elas atenderem aos seus requisitos.

• Se as versões mais antigas não atenderem aos seus requisitos, substitua o uso das APIs PlatformAbstractions pelas substituições recomendadas.

  PlatformAbstractions API (Interface de Programação de Aplicações)	Substituição recomendada
  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 e Environment.OSVersion

  Observação

  A maioria dos casos de uso para RuntimeEnvironment.OperatingSystem e RuntimeEnvironment.OperatingSystemVersion são para fins de exibição, por exemplo, exibição para um usuário, registro em log e telemetria. Não é recomendado tomar decisões em tempo de execução com base numa versão do sistema operativo (SO). Environment.OSVersion agora retorna a versão correta para os sistemas operacionais Windows e macOS. No entanto, para a maioria das distribuições Unix, o que é considerado a "versão do sistema operacional" não é tão simples. Por exemplo, pode ser a versão do kernel Linux, ou pode ser a versão distro. Para a maioria das plataformas Unix, Environment.OSVersion e RuntimeInformation.OSDescription retornam a versão retornada por uname. Para obter o nome da distro Linux e informações de versão, a abordagem recomendada é ler o arquivo /etc/os-release .

APIs afetadas

• 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