Aracılığıyla paylaş

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

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 framework (TFM) için destek yapılandırabilir ve ardından paketi oluşturmak için dotnet pack veya msbuild /t:pack kullanabilirsiniz.

Uyarı

nuget.exe CLI, SDK stilindeki projeleri paketlemeyi desteklemediğinden, yalnızca dotnet pack veya msbuild /t:pack kullanmanız 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, değiştir

    <TargetFramework>netstandard2.0</TargetFramework>

    to:

    <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 #if NET45 veya #if NETSTANDARD2_0 kullanabilirsiniz. (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 bakınız

  • Last updated on