.NET uygulamalarında bağımlılıkları yönetme

Bu makalede paket, proje ve derleme bağımlılıklarının nasıl ekleneceği ve kaldırılacağı açıklanmaktadır.

Paket bağımlılıkları ekleme ve kaldırma

Proje dosyanızı düzenleyerek veya .NET CLI komutları aracılığıyla bağımlılıkları ekleyebilir ve kaldırabilirsiniz.

CLI'yi kullan

Bağımlılık eklemek için SDK sürümünüz için komutunu çalıştırın dotnet package :

dotnet package add Microsoft.EntityFrameworkCore

Bağımlılığı kaldırmak için SDK sürümünüz için komutunu çalıştırın dotnet package :

dotnet package remove Microsoft.EntityFrameworkCore

Proje dosyasını düzenleme

Bağımlılık eklemek için bir <PackageReference> öğesini <ItemGroup> öğesinin içine ekleyin. Mevcut <ItemGroup> bir öğeye ekleyebilir veya yeni bir tane oluşturabilirsiniz.

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

  <PropertyGroup>
    ...
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="Microsoft.EntityFrameworkCore" Version="3.1.2" />
  </ItemGroup>

</Project>

Include özniteliği, projeye eklenecek paketin kimliğini belirtir. Version özniteliği, alınacak sürümü belirtir. Sürümler NuGet sürüm kurallarına göre belirtilir.

Aşağıdaki örnekte gösterildiği gibi yalnızca belirli bir hedefte kullanılabilen bir bağımlılık eklemek için koşulları kullanın:

<PackageReference Include="PACKAGE_ID" Version="PACKAGE_VERSION" Condition="'$(TargetFramework)' == 'netcoreapp2.1'" />

Yukarıdaki örnekteki bağımlılık yalnızca söz konusu hedef için derleme gerçekleştiriliyorsa geçerli olacaktır. $(TargetFramework) koşulunda, projede ayarlanan bir MSBuild özelliğidir. En yaygın .NET uygulamaları için bunu yapmanız gerekmez.

Bir bağımlılığı kaldırmak için, proje dosyasından <PackageReference> öğesini kaldırın.

PackageReference öğesi hakkında daha fazla bilgi için bkz: .NET SDK projeleri için MSBuild başvurusu.

Proje referansları ekleme ve kaldırma

Projeniz başka bir projeye bağımlı olduğunda projeden projeye başvuru kullanın. Proje başvuruları eklemek ve kaldırmak için proje dosyasını düzenleyin veya CLI'yi kullanın.

CLI'yi kullan

Proje başvurusu eklemek için SDK sürümünüz için komutunu çalıştırın dotnet reference .

dotnet reference add ../MyLibrary/MyLibrary.csproj

Proje başvurusunu kaldırmak için SDK sürümünüz için aşağıdaki komutu çalıştırın:

dotnet reference remove ../MyLibrary/MyLibrary.csproj

Proje dosyasını düzenleme

<ProjectReference> Proje dosyası öğesi, başvuruda bulunılan projenin yolunu tanımlar. Bir proje referansı eklemek için, bir <ItemGroup> öğesinin içine bir <ProjectReference> öğesi ekleyin. Mevcut <ItemGroup> bir öğeye ekleyebilir veya yeni bir tane oluşturabilirsiniz.

<ItemGroup>
  <ProjectReference Include="../MyLibrary/MyLibrary.csproj" />
</ItemGroup>

Bir proje başvurusunu kaldırmak için proje dosyasındaki <ProjectReference> öğesini kaldırın.

Öğe hakkında ProjectReference daha fazla bilgi için bkz. Common MSBuild proje öğeleri.

Derleme başvuruları ekleme ve kaldırma

Assembly başvurularını proje dosyası üzerinden ekleyebilir ve kaldırabilirsiniz. .NET CLI, derleme başvuruları eklemek veya kaldırmak için komutlar sunmaz.

Proje veya paketin parçası olmayan bir .NET derlemesine başvurmak için proje dosyasına bir <Reference> öğe ekleyin. <HintPath> öğesini kullanarak derlemenin göreli veya mutlak yolunu belirtin:

<ItemGroup>
  <Reference Include="MyAssembly">
    <HintPath>lib/MyAssembly.dll</HintPath>
  </Reference>
</ItemGroup>

Bir assembly başvurusunu kaldırmak için, proje dosyasından ilgili <Reference> öğesini kaldırın.

Öğe hakkında Reference daha fazla bilgi için bkz. Common MSBuild proje öğeleri.

İpuçları

  • Başvuruda bulunılan paketin .targets veya .props dosyasına geri yükleme işlemine giriş eklemeyin. Bu girişler PackageReference öğeleri, ExcludeAssets öznitelikleri, kullanılacak NuGet akışlarını veya diğer NuGet yapılandırmasını içerebilir. Paketlerden .targets ve .props dosyaları NuGet geri yükleme işlemi tamamlanana kadar kullanılmaz. Geri yükleme için gereken her şeyin paket bağımlılığı değil projenin kendi proje dosyasında veya .targets dosyasında olması gerekir.

  • Konsol uygulamasında veya sınıf kitaplığında ASP.NET API'leri kullanmak istiyorsanız proje dosyanıza bir FrameworkReference öğesi ekleyin:

    <FrameworkReference Include="Microsoft.AspNetCore.App" />

    Daha fazla bilgi için bkz. ASP.NET Core paylaşılan çerçevesini kullanma.

Ayrıca bkz.

  • Last updated on