Zielframeworks

NuGet verwendet Zielframeworkverweise an verschiedenen Stellen, um frameworkabhängige Komponenten eines Pakets gezielt zu identifizieren und zu isolieren:

• Projektdatei: Für PROJEKTE im SDK-Stil enthält csproj die Zielframeworkverweise.
• .nuspec manifest: Ein Paket kann je nach Zielframework des Projekts unterschiedliche Pakete angeben, die in einem Projekt enthalten sein sollen.
• .nupkg-Ordnername: Die Ordner innerhalb des Ordners eines Pakets lib können gemäß dem Zielframework benannt werden, von denen jede die DLLs und andere Inhalte enthält, die für dieses Framework geeignet sind.
• packages.config: Das targetframework Attribut einer Abhängigkeit gibt die Variante eines zu installierenden Pakets an.

Die kanonische Liste aller unterstützten Zielframeworks und deren TFM-Syntax finden Sie unter Target Frameworks in SDK-Formatprojekten.

TargetFramework-Werte sind Aliase

Die TargetFramework Eigenschaft in einer Projektdatei ist ein Anzeigename – ein Alias – der in eine kanonische Frameworkidentität übersetzt wird. Das .NET SDK führt diese Übersetzung durch Festlegen der TargetFrameworkMoniker (TFM) und ggf. der TargetPlatformMoniker Eigenschaften durch.

Wenn Sie z. B. schreiben <TargetFramework>net10.0-windows</TargetFramework>, übersetzt das .NET SDK folgendes in:

• TargetFrameworkMoniker = .NETCoreApp,Version=v10.0
• TargetPlatformMoniker = Windows,Version=7.0

NuGet verwendet diese Moniker-Eigenschaften – nicht die TargetFramework Zeichenfolge – für Paketkompatibilitätsprüfungen. Dies bedeutet, dass der TargetFramework Wert selbst eine beliebige Zeichenfolge sein kann, solange die Moniker-Eigenschaften richtig festgelegt sind. Das folgende Projekt ist beispielsweise gültig:

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>banana</TargetFramework>
  </PropertyGroup>

  <PropertyGroup Condition=" '$(TargetFramework)' == 'banana' ">
    <TargetFrameworkIdentifier>.NETCoreApp</TargetFrameworkIdentifier>
    <TargetFrameworkVersion>v10.0</TargetFrameworkVersion>
    <TargetFrameworkMoniker>.NETCoreApp,Version=v10.0</TargetFrameworkMoniker>
  </PropertyGroup>
</Project>

Dieses Projekt stellt .NET 10.0 wiederhergestellt und builds her, auch wenn der TargetFramework Wert lautet banana. Das .NET SDK basiert bereits auf diesem Aliasingmechanismus für osspezifische TFMs wie net8.0-ios und net8.0-android, wo der kurze TFM in den vollständigen Moniker mit Plattforminformationen übersetzt wird.

Multiadressierung mit doppelten Frameworks

Ab NuGet 7.6 / .NET SDK 10.0.300 können mehrere TargetFrameworks Aliase in dasselbe effektive Framework aufgelöst werden. Dies ermöglicht Szenarien wie Multi-RID-Builds und Die Zielbestimmung für die Multiversionserweiterung. Ausführliche Informationen dazu, wie dies mit Wiederherstellungs-, Pack-, Sperrdateien und Projektreferenzen funktioniert, finden Sie unter "Zielgruppenadressierung mehrerer Frameworks".

Unterstützte Frameworks

Auf ein Framework wird in der Regel von einem kurzen Zielframework-Moniker oder TFM verwiesen. In .NET Standard wird dies auch auf TxM generalisiert, um einen einzelnen Verweis auf mehrere Frameworks zuzulassen.

Die NuGet-Clients unterstützen die Frameworks in der folgenden Tabelle. Entsprechungen werden in eckigen Klammern [] angezeigt. Beachten Sie, dass einige Tools wie z dotnet. B. Variationen von kanonischen TFMs in einigen Dateien verwenden können. Wird z. B dotnet pack.NETCoreApp2.0 . in einer .nuspec Datei anstelle von netcoreapp2.0. Die verschiedenen NuGet-Clienttools behandeln diese Variationen ordnungsgemäß, sollten jedoch beim direkten Bearbeiten von Dateien immer kanonische TFMs verwenden.

Veraltete Frameworks

Die folgenden Frameworks sind veraltet. Pakete für diese Frameworks sollten zu den angegebenen Ersetzungen migriert werden.

Vorrang

Eine Reihe von Frameworks bezieht sich auf und ist miteinander kompatibel, aber nicht notwendigerweise gleichwertig:

NET Standard

.NET Standard vereinfacht Verweise zwischen binärkompatiblen Frameworks, sodass ein einzelnes Zielframework auf eine Kombination anderer verweisen kann. (Hintergrund finden Sie unter .NET Primer.)

Das NuGet Get Nearest Framework Tool simuliert, was NuGet verwendet, um ein Framework aus vielen verfügbaren Frameworkressourcen in einem Paket basierend auf dem Framework des Projekts auszuwählen.

Die dotnet Reihe von Monikern sollte in NuGet 3.3 und früher verwendet werden; die netstandard Monikersyntax sollte in v3.4 und höher verwendet werden.

Portable Klassenbibliotheken

Um ein Zielframework zu definieren, das sich auf mehrere untergeordnete Zielframeworks bezieht, wird das portable Schlüsselwort verwendet, das zum Präfix der Liste der referenzierten Frameworks verwendet wird. Vermeiden Sie künstliches Einschließen von zusätzlichen Frameworks, die nicht direkt kompiliert werden, da sie zu unbeabsichtigten Nebenwirkungen in diesen Frameworks führen kann.

Zusätzliche von Drittanbietern definierte Frameworks bieten Kompatibilität mit anderen Umgebungen, auf die auf diese Weise zugegriffen werden kann. Darüber hinaus gibt es Kurzprofilnummern, die zur Referenz auf diese Kombinationen verwandter Frameworks verfügbar sind, Profile#aber dies ist keine empfohlene Methode, diese Zahlen zu verwenden, da sie die Lesbarkeit der Ordner und .nuspecder .

Darüber hinaus können NuGet-Pakete für Xamarin zusätzliche Xamarin-definierte Frameworks verwenden: