Microsoft.DotNet.PlatformAbstractions-paketet har tagits bort

Inga nya versioner av NuGet-paketet Microsoft.DotNet.PlatformAbstractions kommer att produceras.

Ändra beskrivning

Tidigare producerades nya versioner av Microsoft.DotNet.PlatformAbstractions biblioteket tillsammans med nya versioner av .NET Core. Framöver kommer inga nya funktioner att läggas till i biblioteket och inga nya huvudversioner kommer att släppas. Befintliga versioner av biblioteket fortsätter dock att fungera och underhållas.

Biblioteket Microsoft.DotNet.PlatformAbstractions överlappar API:er som redan har upprättats i system.* namnområden. Microsoft.DotNet.PlatformAbstractions Vissa API:er har inte heller utformats med samma nivå av granskning och långsiktig support som resten av System.* API:er. Använder Platform till exempel Microsoft.DotNet.PlatformAbstractions uppräkningen för att beskriva den aktuella operativsystemplattformen. Den här uppräkningsdesignen avvisades uttryckligen när API:et RuntimeInformation.IsOSPlatform(OSPlatform) utformades för att möjliggöra nya plattformar och framtida flexibilitet.

De scenarier som aktiveras av Microsoft.DotNet.PlatformAbstractions biblioteket är nu möjliga utan det. Befintliga versioner fortsätter att fungera, även i .NET 5 och senare, och kommer att betjänas tillsammans med tidigare versioner av .NET Core. Nya funktioner läggs dock inte till i biblioteket. I stället läggs nya funktioner till i andra bibliotek och API:er.

Version introducerad

5,0

Rekommenderad åtgärd

• Du kan fortsätta att använda äldre versioner av biblioteket om de uppfyller dina krav.

• Om de äldre versionerna inte uppfyller dina krav ersätter du användningen av PlatformAbstractions API:erna med de rekommenderade ersättningarna.

  PlatformAbstractions API	Rekommenderad ersättning
  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 och Environment.OSVersion

  Kommentar

  De flesta användningsfall för RuntimeEnvironment.OperatingSystem och RuntimeEnvironment.OperatingSystemVersion är för visningsändamål, till exempel visning för en användare, loggning och telemetri. Vi rekommenderar inte att du fattar körningsbeslut baserat på en operativsystemversion (OS). Environment.OSVersion returnerar nu rätt version för Windows- och macOS-operativsystem. Men för de flesta Unix-distributioner är det som anses vara "OS-versionen" inte lika enkelt. Det kan till exempel vara Linux-kernelversionen, eller så kan det vara distributionsversionen. För de flesta Unix-plattformar Environment.OSVersion och RuntimeInformation.OSDescription returnera den version som returneras av uname. För att hämta information om Linux-distributionens namn och version rekommenderar vi att du läser filen /etc/os-release .

Berörda API:er

• 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