Proje dosyanızda birden çok .NET Framework sürümünü destekleme

  • Makale

Bir projeyi ilk oluşturduğunuzda, en geniş kapsamlı tüketen projelerle uyumluluk sağladığından bir .NET Standard sınıf kitaplığı oluşturmanızı öneririz. .NET Standard'ı kullanarak varsayılan olarak bir .NET kitaplığına platformlar arası destek eklersiniz. Ancak bazı senaryolarda belirli bir çerçeveyi hedefleyen kodu da eklemeniz gerekebilir. Bu makalede, SDK stili projeler için bunu nasıl yapabileceğiniz gösterilir.

SDK stili projeler için, proje dosyanızda birden çok hedef çerçevesi (TFM) için destek yapılandırabilir, ardından paketi oluşturmak için veya msbuild /t:pack kullanabilirsinizdotnet pack.

Not

nuget.exe CLI, SDK stilindeki projeleri paketlemeyi desteklemediğinden yalnızca veya msbuild /t:packkullanmanız dotnet pack gerekir. Bunun yerine genellikle dosyasındaki .nuspec tüm özellikleri proje dosyasına eklemenizi öneririz. SDK stili olmayan bir projede birden çok .NET Framework sürümünü hedeflemek için bkz . Birden çok .NET Framework sürümünü destekleme.

Birden çok .NET Framework sürümünü destekleyen bir proje oluşturma

  1. Visual Studio'da yeni bir .NET Standard sınıf kitaplığı oluşturun veya kullanın dotnet new classlib.

    En iyi uyumluluk için bir .NET Standart sınıf kitaplığı oluşturmanızı öneririz.

  2. Hedef çerçeveleri desteklemek için .csproj dosyasını düzenleyin. Örneğin,

    <TargetFramework>netstandard2.0</TargetFramework>

    yerine şunu yazın:

    <TargetFrameworks>netstandard2.0;net45</TargetFrameworks>

    Tekil olan XML öğesini çoğul olarak değiştirdiğinizden emin olun (hem açık hem de kapalı etiketlere "s" ekleyin).

  3. Yalnızca bir TFM'de çalışan herhangi bir kodunuz varsa, TFM'ye bağımlı kodu ayırmak için veya #if NETSTANDARD2_0 kullanabilirsiniz#if NET45. (Daha fazla bilgi için bkz. Çoklu hedefleme.) Örneğin, aşağıdaki kodu kullanabilirsiniz:

    public string Platform {
   get {
#if NET45
      return ".NET Framework"
#elif NETSTANDARD2_0
      return ".NET Standard"
#else
#error This code block does not match csproj TargetFrameworks list
#endif
   }
}

  4. .csproj dosyasına MSBuild özellikleri olarak istediğiniz NuGet meta verilerini ekleyin.

    Kullanılabilir paket meta verilerinin ve MSBuild özellik adlarının listesi için bkz . paket hedefi. Ayrıca bkz . Bağımlılık varlıklarını denetleme.

    Derlemeyle ilgili özellikleri NuGet meta verilerinden ayırmak istiyorsanız, farklı PropertyGroupbir kullanabilir veya NuGet özelliklerini başka bir dosyaya ekleyip MSBuild'in Import yönergesini kullanarak ekleyebilirsiniz. Directory.Build.Props ve Directory.Build.Targets MSBuild 15.0 ile başlayarak da desteklenir.

  5. Şimdi kullanın dotnet pack ve elde edilen .nupkg hem .NET Standard 2.0 hem de .NET Framework 4.5'i hedefler.

Yukarıdaki adımlar ve .NET Core SDK 2.2 kullanılarak oluşturulan .csproj dosyası aşağıdadır.

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

  <PropertyGroup>
    <TargetFrameworks>netstandard2.0;net45</TargetFrameworks>
    <Description>Sample project that targets multiple TFMs</Description>
  </PropertyGroup>

</Project>

Ayrıca bkz.