NuGet Package Manager kullanarak Visual Studio'da paketleri yükleme ve yönetme

Projelerde ve çözümlerde NuGet paketlerini kolayca yüklemek, kaldırmak ve güncelleştirmek için Microsoft Visual Studio'da NuGet Package Manager kullanıcı arabirimini kullanabilirsiniz.

Önkoşullar

  • Visual Studio 2026 ile herhangi bir .NET ile ilgili iş yükü. 2026 Community sürümünü visualstudio.microsoft.com ücretsiz olarak yükleyebilir veya Professional veya Enterprise sürümünü kullanabilirsiniz.

  • NuGet Package Manager. Visual Studio 2017 ve sonraki sürümleri, .NET ile ilgili bir iş yükü yüklendiğinde NuGet Package Manager otomatik olarak içerir. NuGet Package Manager Visual Studio Yükleyicisi'nde el ile yüklemek için Individual components>Code tools>NuGet package manager öğesini seçin.

Paket bulma ve yükleme

Visual Studio kullanarak bir NuGet paketi bulmak ve yüklemek için şu adımları izleyin:

  1. Solution Explorer'da bir project yükleyin ve ardından Project> NuGet Packages yönet'i seçin.

    NuGet Package Manager penceresi açılır.

  2. Paketleri, şu anda seçili durumdaki kaynaktan gelen popülerliğe göre görüntülemek için Gözat sekmesine gidin. Kaynaklar hakkında bilgi için bkz. Paket kaynakları.

    • Belirli bir paketi aramak için, sekmenin sol üst köşesindeki arama kutusunu kullanın.
    • Doğru paketi tanımlamanıza yardımcı olması için her paket kimliğinin yanında kısaltılmış bilgiler gösterilebilir. Bu bilgiler seçilen paket kaynaklarına göre değişir. Örnek olarak paket indirme sayısı, yazarlar veya sahibin profilinin bağlantısı verilebilir.

    Uyarı

    Visual Studio 17.11 ve sonraki sürümlerde, seçilen paket kaynağı tarafından desteklendiğinde paket sahipleri profil bağlantıları olarak gösterilir. Paket sahipliği, paket kaynağı tarafından tanımlanır. Daha fazla bilgi için bkz. nuget.org üzerinde paket sahiplerini yönetme.

    Visual Studio 17.10 ve önceki sürümlerinde, düz metin olarak görünen author meta verileri paketi gösterilir. Daha fazla bilgi için bkz . Yazarlar paketi meta verileri.

    • Ayrıntılar bölmesini açmak için bir paket seçin. Ayrıntılar bölmesinde, Paket Ayrıntıları sekmesi paket meta verilerini, sahipler, yazarlar ve lisans hakkındaki bilgileri ve diğer bilgileri görüntüler. Ayrıntılar bölmesi, yüklenecek sürümü seçmeniz için bir yol da sağlar.

      NuGet Package Manager ekran görüntüsü. Gözat sekmesinde bir paket seçilir. Ayrıntılar bölmesinin Paket Ayrıntıları sekmesi, paket verilerini listeler.

      Detaylar panelinin README sekmesi, eğer paket yazarı tarafından sağlanmışsa paket read-me dosyasını görüntüler.

      NuGet Package Manager ekran görüntüsü, Gözat sekmesinde bir paket seçilmiş. Ayrıntılar bölmesinin BENİOKU sekmesinde paket açıklanmaktadır.

  3. Ayrıntılar bölmesinde, Sürüm yanında bir sürüm seçin. yayın öncesi sürümleri Version listesine eklemek istiyorsanız, NuGet Package Manager penceresinin en üstüne gidin. Arama kutusunun yanındaki Ön sürümü ekle'yi seçin.

  4. NuGet paketini yüklemek için Yükle'yi seçin. Lisans koşullarını kabul etme veya yüklemeyi doğrulamanız istenebilir.

    Visual Studio paketi ve bağımlılıklarını projeye yükler. Yükleme tamamlandığında, eklenen paketler NuGet Package Manager Installed sekmesinde görünür. Paketleri Solution ExplorerDependencies>Packages düğümünde de bulabilirsiniz. Bir paketi yükledikten sonra, projede bir using deyimiyle bu pakete başvurabilirsiniz.

Paket yönetimi biçimini ayarlama

NuGet,bir projenin paketleri kullanabileceği iki biçime sahiptir:

Yalnızca bazı proje türleri her iki paket yönetimi biçimlerini de destekler. Özellikle, .csproj dosyası olan SDK stili olmayan .NET Framework projeleri her iki biçimi de destekler. .NET SDK stili projeler için PackageReference gereklidir.

Önerilen biçimdir PackageReference. Ancak bazı NuGet paketleri ile PackageReferencetam olarak uyumlu değildir. Daha fazla bilgi için bkz. Paket uyumluluğu sorunları.

Paket yönetimi formatları hakkında daha fazla bilgi için bkz. packages.config'den PackageReference ve Proje türü desteği.

Varsayılan biçimi ayarlamak için şu adımları izleyin:

  1. Visual Studio Tools>Options öğesini seçin.
  2. Yan bölmede NuGet Package Manager öğesini seçin ve ardından General öğesini seçin.
  3. Ana pencerede, Paket Yönetimi'nin altında , Varsayılan paket yönetimi biçimi listesinden bir biçim seçin.

Bu ayarı yapılandırma hakkında daha fazla bilgi için bkz. Varsayılan paket yönetimi biçimini seçme.

Paketi kaldırma

NuGet paketini kaldırmak için şu adımları izleyin:

  1. Solution Explorer'da project yükleyin, Project> NuGet Paketlerini Yönet öğesini seçin ve ardından Installed sekmesine gidin.

  2. Ana bölmede kaldıracak paketi seçin. Gerekirse, paketi bulmak için arama kutusunu kullanın. Ardından paket ayrıntıları bölmesinde Kaldır'ı seçin.

    NuGet Package Manager ekran görüntüsü. Ana bölmede bir paket seçilir. Ayrıntılar bölmesinde Kaldır düğmesi vurgulanmış.

Paketi güncelleştirme

NuGet paketini güncelleştirmek için şu adımları izleyin:

  1. Solution Explorer'da bir project yükleyin ve ardından Project> NuGet Packages yönet'i seçin. bağımlılıkları bin klasörü aracılığıyla yöneten eski ASP.NET Web Sitesi projeleri için Solution Explorer gidin ve NuGet Package Manager kullanıcı arabirimini açmadan önce bin klasörünü seçin.

  2. Paket kaynağı'nın yanında seçilen kaynaktan kullanılabilir güncelleştirmeleri içeren paketleri listelemek için Güncelleştirmeler sekmesini seçin. Güncelleştirme listesine yayın öncesi paketleri eklemek için NuGet Package Manager penceresinin en üstüne gidin. Arama kutusunun yanındaki Ön sürümü ekle'yi seçin.

  3. Güncelleştirilecek paketi seçin. Ayrıntılar bölmesinde, Sürüm'un yanında istediğiniz sürümü seçin ve ardından Güncelleştir'i seçin.

    NuGet Package Manager ekran görüntüsü. Ana bölmede bir paket seçilir. Ayrıntılar bölmesinde sürüm ve Güncelleştir düğmesi vurgulanmış.

Örtük olarak başvurulan paketi güncelleştirme

Bazı paketler için Güncelleştir düğmesi kullanılamaz ve şu ileti görüntülenir: "SDK tarafından örtük olarak başvurulur. Paketi güncelleştirmek için ait olduğu SDK'yı güncelleştirin."

Bu ileti, paketin daha büyük bir çerçevenin veya SDK'nın parçası olduğunu ve bağımsız olarak güncellenemeyeceğini gösteriyor. Örneğin, SDK stilindeki bir proje .NET Framework'i hedeflediğinde Microsoft.NETFramework.ReferenceAssemblies otomatik olarak eklenir.

NuGet Paket Yöneticisi'nde paket ayrıntıları bölmesinin ekran görüntüsü. Güncelle düğmesi soluk görünüyor. Örtük başvuruyla ilgili bir mesaj görünür durumda.

Bu tür paketler dahili olarak ile <IsImplicitlyDefined>True</IsImplicitlyDefined>işaretlenir. Bu paketler SDK veya çalışma zamanı ile sürümlenir ve NuGet Package Manager kullanılarak değil daha yeni bir .NET SDK yüklenerek güncelleştirilmelidir.

Çerçevenin yeni bir sürümünü indirmek için bkz. İndir .NET. Daha fazla bilgi için bkz. .NET uygulama yayımlamaya genel bakış.

Birden çok paketi güncelleştirme

Birden çok paketi en son sürümlerine güncelleştirmek için NuGet paket listesinden bunları seçin ve ardından Güncelleştir'i seçin.

Yüklü sekmesinden güncelleştirme

Ayrıca , Yüklü sekmesinden tek bir paketi de güncelleştirebilirsiniz. Bu durumda, bir sürüm ve Yayın öncesi ekle seçeneğini de belirleyebilirsiniz.

Çözüm paketlerini yönetme

Bir çözüm için paketleri yönetmek, aynı anda birden çok projeyle çalışmak için kullanışlı bir araçtır.

  1. Solution Manager içinde bir çözüm seçin, ve ardından Tools>NuGet Package Manager> Çözüm için NuGet Paketlerini Yönet öğesini seçin.

  2. Çözüm paketlerini yönet penceresinde, bir işlemin uygulanacağı projeleri seçin.

    Çözüm Paketlerini Yönet penceresinin ekran görüntüsü. Paket ayrıntıları bölmesinde tüm projeler seçilir ve Yükle düğmesi kullanılabilir.

Birleştir sekme

Geliştiriciler genellikle aynı çözümdeki farklı projelerde aynı NuGet paketinin farklı sürümlerini kullanmayı kötü bir uygulama olarak değerlendirir. Çözüm için Paketleri Yönet penceresini kullanarak NuGet paketleriniz için ortak bir sürüm kullanabilirsiniz. Bunu yapmak için Birleştir sekmesine giderek farklı sürüm numaralarına sahip paketlerin çözümdeki farklı projeler tarafından nerede kullanıldığını keşfedin.

Çözüm Paketlerini Yönet penceresinin ekran görüntüsü. Paket ayrıntıları bölmesinde, paketin farklı sürümlerini kullanan iki proje listelenir.

Bu örnekte, MyClassLibrary projesi 6.5.1'i, EntityFramework MyConsoleApp ise 6.5.0'ı kullanır EntityFramework . Paket sürümlerini birleştirmek için şu adımları izleyin:

  1. Birleştir sekmesinde, proje listesinde güncelleştirilecek projeleri seçin.

  2. Sürüm'un yanında, seçilen tüm projeler için kullanılacak sürümü seçin.

  3. Yükle'yi seçin.

    NuGet Package Manager seçili paket sürümünü seçili tüm projelere yükler ve paket artık Consolidate sekmesinde görünmez.

Paket kaynakları

Visual Studio paket kaynaklarının sırasını yoksayar. Bunun yerine, bir isteğe ilk olarak yanıt veren kaynaktan gelen paketi kullanır. Daha fazla bilgi için bkz. Paketleri geri yükleme. Belirli bir kaynaktan paket yükleme hakkında bilgi için bkz. Paket kaynağı eşleme.

  1. Visual Studio'nun paket meta verilerini yüklediği kaynağı değiştirmek için NuGet Package Manager penceresinin veya Manage Packages for Solution penceresinin üst kısmına gidin. Paket kaynağı'nın yanında, kullanmak istediğiniz kaynağı seçin.

    Çözüm paketlerini yönet penceresinin sağ üst köşesinin ekran görüntüsü. Paket kaynağı listesi vurgulanır ve nuget.org seçilir.

  2. Paket kaynaklarınızı yönetmek için Ayarlar simgesini veya Araçlar>Seçenekleri'ni seçin.

    Çözüm paketlerini yönet penceresinin sağ üst köşesinin ekran görüntüsü. Paket kaynağı listesinin yanında ayarlar simgesi vurgulanır.

  3. NuGet paket kaynaklarını yönetmek için Visual Studio içindeki NuGet Package Manager seçeneklerine bakın.

NuGet Package Manager Seçenekleri denetimi

Bir paket seçtiğinizde, NuGet Package Manager ayrıntılar bölmesinde Version listesinin altında genişletilebilir bir Options denetimi görüntüler. Çoğu proje türü için yalnızca Önizleme penceresini göster onay kutusu sağlanır. Ancak bazı proje türleri için başka seçenekler de kullanılabilir.

NuGet Package Manager paket ayrıntıları bölmesindeki Seçenekler denetiminin ekran görüntüsü; yükleme, güncelleştirme ve kaldırma seçenekleri.

Aşağıdaki bölümlerde kullanılabilir seçenekler açıklanmaktadır.

Yükleme ve güncelleştirme seçenekleri

Bu seçenekler yalnızca belirli proje türleri için kullanılabilir:

  • Bağımlılık davranışı: Bu seçenek, NuGet'in yüklemiş olduğu bağımlı paketlerin sürümlerini belirtir. Aşağıdaki ayarlara sahiptir:

    • Bağımlılıkları Yoksay , bağımlılıkların yüklenmesini atlar ve bu da genellikle yüklenen paketi bozar.
    • En düşük , birincil seçilen paketin gereksinimlerini karşılayan en düşük sürüm numarasıyla bağımlılığı yükler. Bu ayar varsayılan ayardır.
    • En Yüksek Düzeltme Eki , seçilen sürümle aynı ana ve ikincil sürüm numaralarına sahip sürümü ancak en yüksek düzeltme eki numarasını yükler. Örneğin, sürüm 1.2.2 belirtilirse, 1.2 ile başlayan en yüksek sürüm yüklenir.
    • En Yüksek Alt Sürüm, seçilen sürümle aynı ana sürüm numarasına sahip, ancak en yüksek alt sürüm ve yama numarasına sahip sürümü yükler. Sürüm 1.2.2 belirtilirse, 1 ile başlayan en yüksek sürüm yüklenir.
    • En yüksek yükleme paketin en yüksek kullanılabilir sürümünü yükler.

  • Dosya çakışma eylemi: Bu seçenek, NuGet'in projede veya yerel makinede zaten var olan paketleri nasıl işlediğini belirtir. Aşağıdaki ayarlara sahiptir:

    • İstem , NuGet'e mevcut paketlerin tutulup tutulmayacağını veya üzerine yazılıp yazılmayacağını sormasını ister.
    • Tümünü Yoksay , NuGet'e mevcut paketlerin üzerine yazmayı atlama talimatını verdi.
    • Tümünün Üzerine Yaz, NuGet'e diğer mevcut paketlerin üzerine yazmasını emreder.

Kaldırma seçenekleri

Bu seçenekler yalnızca belirli proje türleri için kullanılabilir:

  • Bağımlılıkları kaldırma: Bu seçenek belirlendiğinde, projenin başka bir yerinde başvurulmazsa bağımlı paketleri kaldırır.

  • Tüm bağımlılıklara rağmen zorla kaldır: Seçildiğinde, bu seçenek proje tarafından hâlâ referans alınsa bile paketi kaldırır. Bu seçenek genellikle bir paketi ve yüklü bağımlılıkları kaldırmak için Bağımlılıkları kaldır ile birlikte kullanılır. Ancak bu seçeneğin kullanılması projede bozuk referanslara yol açabilir. Böyle bir durumda, bu diğer paketleri yeniden yüklemeniz gerekebilir.

  • Paket yönetimi için NuGet kullanma hakkında videolar için bkz. Channel 9 ve YouTube.

İlgili içerik

NuGet hakkında daha fazla bilgi için aşağıdaki makalelere bakın:

  • Last updated on