Visual Studio NuGet kullanarak paketleri yükleyip yönetin Paket Yöneticisi

Windows üzerinde Visual Studio NuGet Paket Yöneticisi kullanıcı arabirimi, projelerinde ve çözümlerinde NuGet paketlerini kolayca yüklemenize, kaldırmanıza ve güncelleştirmenize olanak tanır. Mac için Visual Studio deneyim için, bkz. projenize bir NuGet paketi ekleme. Paket Yöneticisi kullanıcı arabirimi Visual Studio Code dahil değildir.

Paket bulma ve yüklemeyi

1. Çözüm Gezgini, başvuruya veya bir projeye sağ tıklayın ve NuGet paketlerini yönet... seçeneğini belirleyin.

   

2. Gözden geçirme sekmesi, paketleri şu anda seçili olan kaynaktan popülerlik olarak görüntüler (bkz. paket kaynakları). Sol üstteki arama kutusunu kullanarak belirli bir paketi arayın. Bilgileri göstermek için listeden bir paket seçin. Bu, Ayrıca, bir sürüm seçimi açılır ile birlikte de Install düğmesine de olanak sağlar.

   

3. Açılan listeden istediğiniz sürümü seçin veardından Kaldır ' ı seçin. Visual Studio paketi ve bağımlılıklarını projeye yüklenir. Lisans koşullarını kabul etmeniz istenebilir. Yükleme tamamlandığında, eklenen paketler yüklü sekmesinde görüntülenir. Paketler Ayrıca, Çözüm Gezgini Başvurular düğümünde listelenir. Bu, bunlara deyimlerle projede başvurabileceğiniz anlamına gelen .

   

Bir paketi kaldırma

1. Çözüm Gezgini, başvuruya veya istenen projeye sağ tıklayın ve NuGet paketleri yönet...seçeneğini belirleyin.

2. Yüklü öğeler sekmesini seçin.

3. Kaldırılacak paketi seçin (gerekirse listeyi filtrelemek için arama ' yı kullanarak) ve Kaldır' ı seçin.

   

4. Paket kaldırılırken, ön sürümü ve paket kaynak denetimlerinin dahil edileceğini unutmayın.

Bir paketi güncelleştirme

1. Çözüm Gezgini, başvuruya veya istenen projeye sağ tıklayın ve NuGet paketleri yönet...seçeneğini belirleyin. (Web sitesi projelerinde bin klasörüne sağ tıklayın.)

2. Seçilen paket kaynaklarından kullanılabilir güncelleştirmeleri olan paketleri görmek için güncelleştirmeler sekmesini seçin. Güncelleştirme listesine yayın öncesi paketleri dahil etmek için ön sürümü dahil et ' i seçin.

3. Güncelleştirilecek paketi seçin, sağ taraftaki açılan listeden istediğiniz sürümü seçin ve Güncelleştir' i seçin.

   

4. Bazı paketlerde düğmesi devre dışıdır ve "bir SDK tarafından örtük olarak başvurulduğunu" (veya "Oto başvurulan") bildiren bir ileti görüntülenir. Bu ileti, paketin daha büyük bir Framework veya SDK 'nın parçası olduğunu ve bağımsız olarak güncelleştirilmemiş olduğunu gösterir. (Bu tür paketler dahili olarak ile işaretlenir <IsImplicitlyDefined>True</IsImplicitlyDefined> .) Örneğin, Microsoft.NETCore.App .NET Core SDK bir parçasıdır ve paket sürümü, uygulama tarafından kullanılan çalışma zamanı çerçevesinin sürümü ile aynı değildir. ASP.NET Core ve .NET Core çalışma zamanının yeni sürümlerini almak için .NET Core yüklemenizi güncelleştirmeniz gerekir. .NET Core Metapackages ve sürüm oluşturma hakkında daha fazla bilgi için bu belgeye bakın. Bu, aşağıdaki yaygın olarak kullanılan paketler için geçerlidir:

   • Microsoft.AspNetCore.All
   • Microsoft.AspNetCore.App
   • Microsoft.NETCore.App
   • NETStandard. Library

   

5. Birden çok paketi en yeni sürümlerine güncelleştirmek için listeden seçin ve listenin üzerindeki Güncelleştir düğmesini seçin.

6. Ayrıca, yüklü sekmesinden tek bir paketi de güncelleştirebilirsiniz. Bu durumda, paketin ayrıntıları bir sürüm seçici ( ön sürümü dahil et seçeneğine tabidir) ve bir Güncelleştir düğmesi içerir.

Çözüm için paketleri yönetme

Bir çözüm için paketlerin yönetilmesi, birden çok projeyle aynı anda çalışması için uygun bir yoldur.

1. araçlar NuGet Paket Yöneticisi > çözüm için NuGet paketlerini yönet... menü komutunu seçin veya çözüme sağ tıklayıp >. seçeneğini belirleyin.

   

2. Çözüm için paketleri yönetirken, Kullanıcı arabirimi işlemlerden etkilenen projeleri seçmenizi sağlar:

   

Birleştirme sekmesi

geliştiriciler tipik olarak aynı NuGet paketin farklı sürümlerini aynı çözümde farklı projeler arasında kullanmak için kötü bir uygulama ele alalım. bir çözüm için paketleri yönetmeyi seçtiğinizde, Paket Yöneticisi kullanıcı arabirimi, farklı sürüm numaralarına sahip paketlerin çözümdeki farklı projeler tarafından kullanıldığı yerleri kolayca görebileceğiniz bir birleştirme sekmesi sağlar:

Bu örnekte, ClassLibrary1 projesi EntityFramework 6.2.0 kullanıyor, ancak ConsoleApp1 EntityFramework 6.1.0 kullanıyor. Paket sürümlerini birleştirmek için aşağıdakileri yapın:

• Proje listesinde güncelleştirilecek projeleri seçin.
• Sürüm denetimindeki tüm projelerde kullanılacak sürümü (EntityFramework 6.2.0 gibi) seçin.
• Install düğmesini seçin.

Paket Yöneticisi seçili paket sürümünü seçili tüm projelere yükleyerek, bu paket artık birleştirme sekmesinde görünmez.

Paket kaynakları

Visual Studio paketleri alacağı kaynağı değiştirmek için kaynak seçicinizden birini seçin:

Paket kaynaklarını yönetmek için:

1. aşağıda özetlenen Paket Yöneticisi kullanıcı arabirimindeki Ayarlar simgesini seçin veya araçlar seçenekler komutunu kullanın ve NuGet Paket Yöneticisi' ye kaydırın:

   

2. Paket kaynakları düğümünü seçin:

   

3. Kaynak eklemek için + adı seçin, adı düzenleyin, + denetimine URL veya yol girin ve Güncelleştir' i seçin. Kaynak artık seçici açılan penceresinde görünür.

4. Bir paket kaynağını değiştirmek için, seçin, ad ve kaynak kutularında düzenlemeler yapın ve Güncelleştir' i seçin.

5. Bir paket kaynağını devre dışı bırakmak için listedeki adının solundaki kutuyu temizleyin.

6. Bir paket kaynağını kaldırmak için, seçin ve sonra X düğmesini seçin.

7. Yukarı ve aşağı ok düğmelerinin kullanılması, paket kaynaklarının öncelik sırasını değiştirmez. Visual Studio, paket kaynaklarının sırasını yok sayar. bu paket, isteklere yanıt vermek için ilk kaynak olan paketi kullanmaktır. Daha fazla bilgi için bkz. paket geri yükleme.

Paket Yöneticisi seçenekler denetimi

bir paket seçildiğinde Paket Yöneticisi kullanıcı arabirimi, sürüm seçicinin altında küçük, genişletilebilir bir seçenekler denetimi görüntüler (burada hem daraltılmış hem de genişletilmiş). Bazı proje türleri için yalnızca Önizleme penceresini göster seçeneğinin sağlandığını unutmayın.

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

Önizleme penceresini göster

Seçildiğinde, bir kalıcı pencere, paket yüklenmeden önce seçilen bir paketin bağımlılıklarını görüntüler:

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

(Tüm proje türleri için kullanılamaz.)

bağımlılık davranışı NuGet bağımlı paketlerin hangi sürümlerinin yükleneceğini nasıl karar verdiği hakkında bir yapılandırma sağlar:

• Bağımlılıkları yoksay , genellikle yüklenen paketi kesen tüm bağımlılıkları yüklemeyi atlar.
• En düşük [varsayılan] bağımlılığı, seçilen birincil paketin gereksinimlerini karşılayan en az sürüm numarasıyla birlikte kurar.
• En yüksek düzeltme eki , aynı büyük ve küçük sürüm numaralarına sahip sürümü, ancak en yüksek düzeltme eki numarasını yüklüyor. Örneğin, 1.2.2 sürümü belirtilmişse 1,2 ile başlayan en yüksek sürüm yüklenir
• En yüksek ikincil sürüm, aynı ana sürüm numarası, ancak en yüksek küçük sayı ve düzeltme eki numarası ile birlikte yüklenir. Sürüm 1.2.2 belirtilmişse, 1 ile başlayan en yüksek sürüm yüklenir
• En yüksek paketin kullanılabilir en yüksek sürümünü yükleme.

dosya çakışması eylemi NuGet, projede veya yerel makinede zaten var olan paketleri nasıl işleyeceğinizi belirtir:

• istem , var olan paketlerin tutulup tutulmayacağını veya üzerine yazılıp yazılmayacağını ister NuGet bildirir.
• tümünü yoksay , var olan paketlerin üzerine yazılmasını atlamak için NuGet söyler.
• tüm mevcut paketlerin üzerine yazmak için NuGet her türlü üzerine yazın .

Kaldırma seçenekleri

(Tüm proje türleri için kullanılamaz.)

Bağımlılıkları kaldır: seçildiğinde, tüm bağımlı paketleri projenin başka bir yerinde başvurulmuyorsa kaldırır.

Üzerinde bağımlılıklar olsa bile kaldırma Işlemini zorla: seçildiğinde, hala projede başvuruluyorsa bile bir paketi kaldırır. Bu genellikle bir paketi kaldırmak için bağımlılıkları kaldır ile birlikte kullanılır ve bu, yüklü bağımlılıkları ve herhangi bir bağımlılığı kaldırır. Ancak bu seçeneğin kullanılması, projedeki bozuk başvurulara yol açabilir. Bu gibi durumlarda, diğer paketleri yeniden yüklemenizgerekebilir.