Das Paket Microsoft.DotNet.PlatformAbstractions wurde entfernt

Es werden keine neuen Versionen des NuGet-Pakets "Microsoft.DotNet.PlatformAbstractions" erstellt.

Änderungsbeschreibung

Zuvor wurden neue Versionen der Microsoft.DotNet.PlatformAbstractions Bibliothek zusammen mit neuen Versionen von .NET Core erstellt. In Zukunft werden der Bibliothek keine neuen Funktionen hinzugefügt, und es werden keine neuen Hauptversionen veröffentlicht. Vorhandene Versionen der Bibliothek funktionieren jedoch weiterhin und werden gewartet.

Die Microsoft.DotNet.PlatformAbstractions Bibliothek überlappt mit APIs, die bereits in den System.*-Namespaces eingerichtet sind. Außerdem werden einige Microsoft.DotNet.PlatformAbstractions-APIs nicht mit dem gleichen Maß an Genauigkeit und langfristiger Unterstützbarkeit wie die übrigen System.*-APIs entworfen. Microsoft.DotNet.PlatformAbstractions verwendet beispielsweise die Platform-Enumeration, um die aktuelle Betriebssystemplattform zu beschreiben. Dieser Enumerationsentwurf wurde explizit abgelehnt, wenn die RuntimeInformation.IsOSPlatform(OSPlatform) API entworfen wurde, um neue Plattformen und zukünftige Flexibilität zu ermöglichen.

Die szenarien, die von der Microsoft.DotNet.PlatformAbstractions Bibliothek aktiviert werden, sind jetzt ohne dies möglich. Vorhandene Versionen funktionieren auch in .NET 5 und höher weiterhin und werden zusammen mit früheren Versionen von .NET Core gewartet. Neue Funktionen werden der Bibliothek jedoch nicht hinzugefügt. Stattdessen werden neue Funktionen anderen Bibliotheken und APIs hinzugefügt.

Eingeführte Version

5.0

Empfohlene Aktion

• Sie können weiterhin ältere Versionen der Bibliothek verwenden, wenn sie Ihren Anforderungen entsprechen.

• Wenn die älteren Versionen Ihre Anforderungen nicht erfüllen, ersetzen Sie die Verwendung der PlatformAbstractions APIs durch die empfohlenen Ersetzungen.

  PlatformAbstractions-API	Empfohlene Ersetzung
  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 und Environment.OSVersion

  Hinweis

  Die meisten Anwendungsfälle für RuntimeEnvironment.OperatingSystem und RuntimeEnvironment.OperatingSystemVersion sind für Anzeigezwecke, beispielsweise zur Anzeige an einen Benutzer, zur Protokollierung und zur Telemetrie. Es wird nicht empfohlen, Laufzeitentscheidungen basierend auf einer Betriebssystemversion (Os) zu treffen. Environment.OSVersion gibt jetzt die richtige Version für Windows- und macOS-Betriebssysteme zurück. Jedoch ist für die meisten Unix-Distributionen nicht eindeutig, was als "Betriebssystemversion" gilt. Beispielsweise könnte es sich um die Linux-Kernelversion oder um die Distro-Version sein. Für die meisten Unix-Plattformen geben Environment.OSVersion und RuntimeInformation.OSDescription die von uname zurückgegebene Version zurück. Um den Linux-Distronamen und Versionsinformationen abzurufen, empfiehlt es sich, die Datei "/etc/os-release " zu lesen.

Betroffene APIs

• 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