SDK スタイルのプロジェクトでのターゲット フレームワークTarget frameworks in SDK-style projects

• 12/03/2019
• • 
  • 
  • 
  • 

アプリまたはライブラリでフレームワークをターゲットに設定するときは、アプリまたはライブラリで使用できるようにする API のセットを指定します。When you target a framework in an app or library, you're specifying the set of APIs that you'd like to make available to the app or library. プロジェクト ファイルでターゲット フレームワークを指定するには、ターゲット フレームワーク モニカー (TFM) を使います。You specify the target framework in your project file using Target Framework Monikers (TFMs).

アプリまたはライブラリでは、.NET Standard のバージョンをターゲットにできます。An app or library can target a version of .NET Standard. .NET Standard のバージョンは、.NET のすべての実装で標準化された API のセットを表します。.NET Standard versions represent standardized sets of APIs across all .NET implementations. たとえば、ライブラリは、.NET Standard 1.6 をターゲットにして、.NET Core と .NET Framework で機能する API に同じコードベースを使ってアクセスできます。For example, a library can target .NET Standard 1.6 and gain access to APIs that function across .NET Core and .NET Framework using the same codebase.

また、アプリまたはライブラリは、.NET の特定の実装をターゲットにして、実装固有の API にアクセスすることもできます。An app or library can also target a specific .NET implementation to gain access to implementation-specific APIs. たとえば、Xamarin.iOS (たとえば Xamarin.iOS10) をターゲットにするアプリは Xamarin が提供する iOS 10 用の iOS API ラッパーにアクセスでき、ユニバーサル Windows プラットフォーム (UWP、uap10.0) をターゲットにするアプリは Windows 10 を実行するデバイス用にコンパイルできる API にアクセスできます。For example, an app that targets Xamarin.iOS (for example, Xamarin.iOS10) gets access to Xamarin-provided iOS API wrappers for iOS 10, or an app that targets the Universal Windows Platform (UWP, uap10.0) has access to APIs that compile for devices that run Windows 10.

一部のターゲット フレームワーク (.NET Framework など) では、API はフレームワークがシステムにインストールするアセンブリによって定義され、アプリケーション フレームワーク API (たとえば ASP.NET) を含む場合があります。For some target frameworks (for example, the .NET Framework), the APIs are defined by the assemblies that the framework installs on a system and may include application framework APIs (for example, ASP.NET).

パッケージ ベースのターゲット フレームワーク (.NET Standard、.NET Core など) では、API はアプリまたはライブラリに含まれるパッケージによって定義されます。For package-based target frameworks (for example, .NET Standard and .NET Core), the APIs are defined by the packages included in the app or library. "メタパッケージ" は、それ独自の内容はなく、依存するもの (他のパッケージ) のリストを保持している NuGet パッケージです。A metapackage is a NuGet package that has no content of its own but is a list of dependencies (other packages). NuGet パッケージ ベースのターゲット フレームワークでは、全体としてフレームワークを構成するすべてのパッケージを参照するメタパッケージが暗黙的に指定されます。A NuGet package-based target framework implicitly specifies a metapackage that references all the packages that together make up the framework.

最新のターゲット フレームワークのバージョンLatest target framework versions

次の表では、最も一般的なターゲット フレームワーク、それらの参照方法、およびそれらが実装する .NET Standard のバージョンを定義します。The following table defines the most common target frameworks, how they're referenced, and which version of the .NET Standard they implement. これらのターゲット フレームワークのバージョンは、最新の安定したバージョンです。These target framework versions are the latest stable versions. プレリリース バージョンは記載されていません。Pre-release versions aren't shown. ターゲット フレームワーク モニカー (TFM) は、.NET アプリまたはライブラリのターゲット フレームワークを指定するための標準化されたトークン形式です。A Target Framework Moniker (TFM) is a standardized token format for specifying the target framework of a .NET app or library.

サポートされるターゲット フレームワークのバージョンSupported target framework versions

ターゲット フレームワークは、通常、TFM によって参照されます。A target framework is typically referenced by a TFM. 次の表では、.NET Core SDK および NuGet クライアントによってサポートされるターゲット フレームワークを示します。The following table shows the target frameworks supported by the .NET Core SDK and the NuGet client. 同等のものがかっこ内に示されています。Equivalents are shown within brackets. たとえば、win81 は netcore451 と同等の TFM です。For example, win81 is an equivalent TFM to netcore451.

ターゲット フレームワークを指定する方法How to specify target frameworks

ターゲット フレームワークはプロジェクト ファイルで指定します。Target frameworks are specified in your project file. 単一のターゲット フレームワークを指定するときは、TargetFramework 要素を使います。When a single target framework is specified, use the TargetFramework element. 次のコンソール アプリのプロジェクト ファイルでは、.NET Core 3.0 をターゲットにする方法が示されています。The following console app project file demonstrates how to target .NET Core 3.0:

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>netcoreapp3.0</TargetFramework>
  </PropertyGroup>

</Project>

複数のターゲット フレームワークを指定するときは、各ターゲット フレームワークに対するアセンブリを条件付きで参照できます。When you specify multiple target frameworks, you may conditionally reference assemblies for each target framework. コードでは、プリプロセッサ シンボルと if-then-else ロジックを使うことで、これらのアセンブリに対して条件付きでコンパイルできます。In your code, you can conditionally compile against those assemblies by using preprocessor symbols with if-then-else logic.

次のライブラリ プロジェクト ファイルは、.NET Standard (netstandard1.4) の API と、.NET Framework (net40 および net45) の API をターゲットにしています。The following library project file targets APIs of .NET Standard (netstandard1.4) and APIs of the .NET Framework (net40 and net45). ターゲット フレームワークが複数あるときは、複数形の TargetFrameworks 要素を使います。Use the plural TargetFrameworks element with multiple target frameworks. ライブラリが 2 つの .NET Framework TFM に対してコンパイルされるときに Condition 属性で実装固有のパッケージを指定する方法に注意してください。Note how the Condition attributes include implementation-specific packages when the library is compiled for the two .NET Framework TFMs:

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <TargetFrameworks>netstandard1.4;net40;net45</TargetFrameworks>
  </PropertyGroup>

  <!-- Conditionally obtain references for the .NET Framework 4.0 target -->
  <ItemGroup Condition=" '$(TargetFramework)' == 'net40' ">
    <Reference Include="System.Net" />
  </ItemGroup>

  <!-- Conditionally obtain references for the .NET Framework 4.5 target -->
  <ItemGroup Condition=" '$(TargetFramework)' == 'net45' ">
    <Reference Include="System.Net.Http" />
    <Reference Include="System.Threading.Tasks" />
  </ItemGroup>

</Project>

ライブラリまたはアプリ内では、各ターゲット フレームワーク用にコンパイルするための条件付きコードを記述します。Within your library or app, you write conditional code to compile for each target framework:

public class MyClass
{
    static void Main()
    {
#if NET40
        Console.WriteLine("Target framework: .NET Framework 4.0");
#elif NET45  
        Console.WriteLine("Target framework: .NET Framework 4.5");
#else
        Console.WriteLine("Target framework: .NET Standard 1.4");
#endif
    }
}

SDK スタイル プロジェクトを使用する場合、ビルド システムは、「サポートされるターゲット フレームワークのバージョン」の表で示されているターゲット フレームワークを表すプリプロセッサ シンボルを認識します。The build system is aware of preprocessor symbols representing the target frameworks shown in the Supported target framework versions table when you're using SDK-style projects. .NET Standard または .NET Core の TFM を表すシンボルを使うときは、ドットをアンダースコアに置き換え、小文字を大文字に変更します (たとえば、netstandard1.4 のシンボルは NETSTANDARD1_4 です)。When using a symbol that represents a .NET Standard or .NET Core TFM, replace the dot with an underscore and change lowercase letters to uppercase (for example, the symbol for netstandard1.4 is NETSTANDARD1_4).

.NET Core ターゲット フレームワークのプリプロセッサ シンボルの完全な一覧を次に示します。The complete list of preprocessor symbols for .NET Core target frameworks is:

非推奨のターゲット フレームワークDeprecated target frameworks

次のターゲット フレームワークは非推奨とされます。The following target frameworks are deprecated. これらのターゲット フレームワークをターゲットにするパッケージは、指定されている代替フレームワークに移行する必要があります。Packages targeting these target frameworks should migrate to the indicated replacements.

参照See also

• クロス プラットフォーム ツールによるライブラリの開発Developing Libraries with Cross Platform Tools
• .NET Standard.NET Standard
• .NET Core バージョン管理.NET Core Versioning
• dotnet/standard GitHub リポジトリdotnet/standard GitHub repository
• NuGet Tools GitHub リポジトリNuGet Tools GitHub Repository
• .NET のフレームワーク プロファイルFramework Profiles in .NET