ターゲット フレームワーク

NuGet では、さまざまな場所でターゲット フレームワーク参照を使用して、パッケージのフレームワークに依存するコンポーネントを具体的に識別して分離します。

• プロジェクト ファイル: SDK スタイルのプロジェクトの場合、 .csproj にはターゲット フレームワーク参照が含まれています。
• .nuspec マニフェスト: パッケージは、プロジェクトのターゲット フレームワークに応じて、プロジェクトに含める個別のパッケージを示すことができます。
• .nupkg フォルダー名: パッケージの lib フォルダー内のフォルダーには、ターゲット フレームワークに従って名前を付けることができます。各フォルダーには、そのフレームワークに適した DLL とその他のコンテンツが含まれています。
• packages.config: 依存関係の targetframework 属性は、インストールするパッケージのバリアントを指定します。

サポートされているすべてのターゲット フレームワークとその TFM 構文の正規リストについては、 SDK スタイルのプロジェクトのターゲット フレームワークに関するページを参照してください。

TargetFramework 値はエイリアスです

プロジェクト ファイル内の TargetFramework プロパティは、正規フレームワーク ID に変換されるフレンドリ名 (別名) です。 .NET SDK は、 TargetFrameworkMoniker (TFM) を設定し、該当する場合は TargetPlatformMoniker プロパティを設定することで、この変換を実行します。

たとえば、 <TargetFramework>net10.0-windows</TargetFramework>を記述すると、.NET SDK によって次のように変換されます。

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

NuGet は、パッケージの互換性チェックのために、 TargetFramework 文字列ではなく、これらのモニカー プロパティを使用します。 つまり、モニカーのプロパティが正しく設定されている限り、 TargetFramework 値自体は任意の文字列にすることができます。 たとえば、次のプロジェクトは有効です。

<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>

このプロジェクトは、 TargetFramework 値が bananaされている場合でも、.NET 10.0 用に復元およびビルドされます。 .NET SDK は、 net8.0-ios や net8.0-androidなどの OS 固有の TFM に対して、このエイリアシング メカニズムに既に依存しています。短い TFM はプラットフォーム情報を使用して完全なモニカーに変換されます。

重複するフレームワークを使用したマルチターゲット

NuGet 7.6 / .NET SDK 10.0.300 以降では、複数のTargetFrameworksエイリアスを同じ効果的なフレームワークに解決できます。 これにより、マルチ RID ビルドやマルチバージョン拡張機能のターゲット設定などのシナリオが可能になります。 復元、パック、ロック ファイル、およびプロジェクト参照での動作の詳細については、「 複数のフレームワークのターゲット設定」を参照してください。

サポートされているフレームワーク

フレームワークは通常、短いターゲット フレームワーク モニカーまたは TFM によって参照されます。 .NET Standard では、これは TxM に一般化され、複数のフレームワークへの 1 つの参照が可能になります。

NuGet クライアントは、次の表のフレームワークをサポートしています。 同等の値は角かっこ [] 内に表示されます。 dotnetなどの一部のツールでは、一部のファイルで正規の TFM のバリエーションが使用される場合があることに注意してください。 たとえば、dotnet packでは、netcoreapp2.0ではなく、.nuspec ファイル内の.NETCoreApp2.0が使用されます。 さまざまな NuGet クライアント ツールはこれらのバリエーションを適切に処理しますが、ファイルを直接編集するときは常に正規の TFM を使用する必要があります。

非推奨のフレームワーク

次のフレームワークは非推奨です。 これらのフレームワークを対象とするパッケージは、指定された置換に移行する必要があります。

優先順位

多くのフレームワークは相互に関連し、互換性がありますが、必ずしも同等であるとは限りません。

NET Standard

.NET Standard では、バイナリ互換フレームワーク間の参照が簡略化され、1 つのターゲット フレームワークが他のフレームワークの組み合わせを参照できるようになります。 (背景については、 .NET 入門を参照してください)。

NuGet Get Nearest Framework ツールは、NuGet がプロジェクトのフレームワークに基づいてパッケージ内の多数の利用可能なフレームワーク資産から 1 つのフレームワークを選択するために使用するものをシミュレートします。

nuGet 3.3 以前では、 dotnet 一連のモニカーを使用する必要があります。 netstandard モニカー構文は v3.4 以降で使用する必要があります。

ポータブル クラス ライブラリ

複数の子ターゲット フレームワークを参照するターゲット フレームワークを定義するには、 portable キーワードを使用して、参照されるフレームワークの一覧の前に付けます。 これらのフレームワークでは意図しない副作用が発生する可能性があるため、直接コンパイルされない追加のフレームワークを人為的に含めないでください。

サード パーティによって定義された追加のフレームワークは、この方法でアクセスできる他の環境との互換性を提供します。 さらに、関連するフレームワークのこれらの組み合わせを Profile#として参照できる短縮形のプロファイル番号がありますが、フォルダーと .nuspecの読みやすさが低下するため、これらの数値を使用することは推奨されません。

さらに、Xamarin を対象とする NuGet パッケージでは、追加の Xamarin 定義フレームワークを使用できます。