Aracılığıyla paylaş

Visual Studio Paket Yöneticisi Konsolu (PowerShell) ile paketleri yönetme

Visual Studio'daki Paket Yöneticisi Konsolu, NuGet paketleriyle etkileşime geçmek için PowerShell komutlarını kullanır. Paket Yöneticisi kullanıcı arabirimi aracılığıyla işlem gerçekleştirmenin hiçbir yolu olmadığında konsolunu kullanabilirsiniz. Konsolunda dotnet komut satırı arabirimi (CLI) veya NuGet CLI komutlarını da kullanabilirsiniz.

Bu makalede, Paket Yöneticisi Konsolu'ndaki PowerShell komutlarını kullanarak NuGet paketlerini bulma, yükleme, güncelleştirme ve kaldırma işlemleri açıklanmaktadır. Paket Yöneticisi Konsolu PowerShell komut başvurusunun tamamı için bkz. PowerShell başvurusu.

Önemli

Bu makaledeki PowerShell komutları ve bağımsız değişkenleri Visual Studio Paket Yöneticisi Konsolu'na özeldir. Bu komutlar, genel bir PowerShell ortamında kullanabileceğiniz PackageManagement modülü komutlarından farklıdır. Her ortamın diğerinde bulunmayan komutları vardır ve aynı ada sahip komutlar kendi bağımsız değişkenlerinde farklılık gösterebilir.

Konsol kullanılabilirliği

Visual Studio 2017'den itibaren, Visual Studio'da herhangi bir .NET ile ilgili iş yükü oluşturduğunuzda, NuGet ve NuGet Paket Yöneticisi otomatik olarak yüklenir. Visual Studio Yükleyicisi'ni kullanarak Paket Yöneticisi'ni de yükleyebilirsiniz. Yükleyicide Tek bileşenler>Kod araçları>NuGet paket yöneticisi'ni seçin.

Visual Studio'da , Araçlar>Uzantıları ve Güncelleştirmeleri veya Uzantılar menüsünün altında NuGet Paket Yöneticisi uzantısını da arayabilirsiniz. Visual Studio'da uzantı yükleyicisini kullanamıyorsanız, uzantıyı doğrudan adresinden https://www.nuget.org/downloadsindirebilirsiniz.

Paket Yöneticisi Konsolu, Windows üzerinde Visual Studio için Paket Yöneticisi'ne yerleşiktir. Visual Studio Code konsolu içermez, ancak NuGet paketlerini yönetmek için C# Dev Kit uzantısını kullanabilirsiniz. Bu uzantıyla, komutları C# Dev Kit çözüm gezgininde veya Visual Studio Code Komut Paleti'nde çalıştırabilirsiniz. Daha fazla bilgi için bkz. Visual Studio Code'da NuGet.

Paketi hızlı bir şekilde bulma ve yükleme

Paket Yöneticisi Konsolu'nu kullanarak bir paketi hızla bulmak ve yüklemek için aşağıdaki adımları izleyin:

  1. Projenizi veya çözümünüzü Visual Studio'da açın ve Araçlar>NuGet Paket Yöneticisi Paket Yöneticisi>Konsolu'nu seçerek Paket Yöneticisi Konsolu penceresini açın.

  2. Konsolunda, yüklemek istediğiniz paketi bulmak için komutunu bir anahtar sözcükle çalıştırın Find-Package . Örneğin, hata günlüğü modülleri ve işleyicileri (ELMAH) sağlayan paketleri bulmak için anahtar sözcüğünü elmaharamak için aşağıdaki komutu çalıştırın. İstediğiniz paket adını zaten biliyorsanız bu adımı atlayın.

    Find-Package elmah

  3. Paketi buldukktan sonra, paketi yüklemek için paket kimliğiyle komutunu çalıştırın Install-Package . Örneğin, Elmah.MVC paketini yüklemek için aşağıdaki komutu çalıştırın:

    Install-Package Elmah.MVC

Bu komutlar hakkında daha fazla ayrıntı için Paket bulma ve Paket yükleme bölümlerine bakın.

Tavsiye

Birçok konsol işlemi, Visual Studio'da bilinen yol adı açık olan bir çözümün bulunmasına bağlıdır. Kaydedilmemiş bir çözümünüz varsa veya hiç çözümünüz yoksa, açık veya kaydedilmiş bir çözüme sahip olmadığınızı gösteren bir hata iletisi görüntülenir. Hatayı düzeltmek için bir çözüm oluşturup kaydedin veya kaydedilmemiş bir çözümü kaydedin.

Konsol denetimlerini kullanma

Visual Studio'da Paket Yöneticisi Konsolu'nu açmak için üst menüye gidin ve Araçlar>NuGet Paket Yöneticisi Paket Yöneticisi>Konsolu'nu seçin. Konsol, istediğiniz gibi yerleştirebileceğiniz ve konumlandırabileceğiniz bir Visual Studio penceresidir. Daha fazla bilgi için bkz. Pencere düzenlerini özelleştirme ve sekmeleri kişiselleştirme.

Varsayılan olarak, konsol komutları Paket Yöneticisi Konsolu penceresinin üst kısmındaki denetimlerde gösterilen belirli paket kaynağına ve projesine karşı çalışır:

Paket Yöneticisi Konsolu penceresinin ekran görüntüsü. Üst kısımda Paket kaynağı ve Varsayılan proje listeleri vurgulanır.

Farklı bir paket kaynağı veya projesi seçildiğinde, sonraki komutlar için varsayılan değerler değişir. Varsayılanları değiştirmeden tek komutlar için bu ayarları geçersiz kılmak için çoğu konsol komutu destek -Source ve -ProjectName seçenekleri destekler.

Paket kaynaklarını yönetmek için , Araçlar>Seçenekleri>NuGet Paket Yöneticisi>Paket Kaynakları iletişim kutusunu açan dişli simgesini seçin. Konsolun içeriğini temizlemek için, Varsayılan proje listesinin yanındaki Konsolu Temizle 'yi seçin.

Paket Yöneticisi Konsolu penceresinin ekran görüntüsü. Üst kısımda iki simge vurgulanır. Biri bir dişli gösteriyor. Diğeri çıkış çizgilerini ve kırmızı bir X'i gösterir.

Uzun süre çalışan bir komutu kesmek için Konsolu Temizle simgesinin yanındaki Komut yürütmesini durdur 'u seçin. Örneğin, çalıştırılırken Get-Package -ListAvailable -PageSize 500 varsayılan kaynakta bulunan en iyi 500 paket (nuget.org gibi) listelenir ve bu işlem birkaç dakika sürebilir.

Paket Yöneticisi Konsolu penceresinin ekran görüntüsü. Üst kısımda, kırmızı kare gibi görünen Durdur komutu yürütme simgesi vurgulanır.

Paket bulma

Varsayılan kaynakta bir paket bulmak için Bul-Paket'i kullanın. Aşağıdaki kod blokları, aramanızı daraltmak için parametrelerin nasıl kullanılacağını gösterir:

  • Belirli bir anahtar sözcük içeren paketleri bulun ve listeleyin:

    Find-Package <keyword>

  • Belirli bir dizeyle başlayan bir kimliğe sahip paketleri bulun ve listeleyin:

    Find-Package <string> -StartWith

  • Belirli bir anahtar sözcük içeren ilk 100 paketi göster:

    Find-Package <keyword> -First 100

    Varsayılan olarak, Find-Package 20 paketin listesini döndürür. Önceki örnekte olduğu gibi, farklı sayıda paket belirtmek için kullanabilirsiniz -First .

  • Belirli bir paketin tüm sürümlerini listeleyin:

    Find-Package <package-name> -AllVersions -ExactMatch

Paket yükleme

Bir paketi varsayılan projeye yüklemek için kullanın Install-Package <package-name>. Paket Yükle konsolu komutu aşağıdaki eylemleri gerçekleştirir:

  • NuGet paketi yüklendiğinde ne olur? içindeki adımları uygular.
  • Konsol penceresinde geçerli lisans koşullarını örtük sözleşmeyle birlikte görüntüler. Koşulları kabul etmiyorsanız paketi kaldırmanız gerekir.
  • Proje dosyasında ve Çözüm Gezgini'ndeBağımlılıklar veya Başvurular düğümü altında pakete bir başvuru ekler. Değişiklikleri proje dosyasına yaymak için projeyi kaydetmeniz gerekir.

Varsayılan olarak, Install-Package paketi konsol penceresinin belirttiği varsayılan projeye ekler. Paketi varsayılan proje olmayan bir projeye eklemek için seçeneğini kullanın -ProjectName . Örneğin, Elmah.MVC adlı projeye varsayılan olmayan UtilitiesLib paketini eklemek için aşağıdaki komutu çalıştırın:

Install-Package Elmah.MVC -ProjectName UtilitiesLib

Paketi kaldırma

Bir paketi varsayılan projeden kaldırmak için kullanın Uninstall-Package <package-name>. Paket adını bulmanız gerekiyorsa, varsayılan projede yüklü olan tüm paketleri listelemek için Get-Package kullanın.

Uninstall-Package aşağıdaki eylemleri gerçekleştirir:

  • Paket referanslarını projeden ve yönetim biçimi formatlarından kaldırır. Başvurular artık Çözüm Gezgini'nde görünmez. Bin klasöründeki başvuruyu kaldırmak için projeyi yeniden oluşturmanız gerekebilir.
  • paketi yüklerken app.config veya web.configyapılan değişiklikleri tersine çevirir.
  • Kalan paketler bu bağımlılıkları kullanmıyorsa önceden yüklenmiş bağımlılıkları kaldırır.

Aşağıdaki kod blokları, komutun çeşitli senaryolarda nasıl kullanılacağını gösterir:

  • Paketi ve kullanılmayan tüm bağımlılıklarını kaldırın:

    Uninstall-Package <package-name> -RemoveDependencies

  • Başka paketler bağımlı olsa bile paketi kaldırın:

    Uninstall-Package <package-name> -Force

Paketi güncelleştirme

Paketleri güncelleştirmek için Update-Package kullanın. Yüklü paketler için kullanılabilir güncelleştirmeleri listelemek için Get-Package özelliğini de kullanabilirsiniz. Aşağıdaki kod blokları, güncelleştirme kapsamını değiştirmek için parametrelerin nasıl kullanılacağını gösterir:

  • Çözümde yüklü olan paketler için daha yeni sürümlerin kullanılabilir olup olmadığını denetleyin:

    Get-Package -updates

  • Belirli bir paketi güncelleştirme:

    Update-Package <package-name>

  • Projedeki tüm paketleri güncelleştirme:

    Update-Package -ProjectName <project-name>

  • Çözümdeki tüm paketleri güncelleştirme:

    Update-Package

Konsolda NuGet CLI'yi kullanma

Konsol işlemlerinin çoğunu NuGet CLI'yi kullanarak da yapabilirsiniz. Ancak, PowerShell konsol komutları Visual Studio tarafından kaydedilen proje ve çözüm bağlamında çalışır ve genellikle eşdeğer NuGet CLI komutlarından daha fazlasını yapar. Örneğin, Install-Package aracılığıyla bir paket yüklemek, proje dosyasına bir başvuru ekler, ancak NuGet CLI komutu, bu başvuruyu eklemez. Bu nedenle Visual Studio'da çalışan geliştiriciler genellikle NuGet CLI yerine konsol komutlarını kullanmayı tercih eder.

Paket Yöneticisi Konsolu'nda NuGet CLI komutlarını kullanmak için NuGet.CommandLine paketini yükleyin.

Install-Package NuGet.CommandLine

Yukarıdaki komut, NuGet CLI'nın en son sürümünü yükler. Belirli bir sürümü yüklemek için seçeneğini kullanın -Version . Örneğin, Sürüm 4.4.1'i yüklemek için aşağıdaki komutu kullanın:

Install-Package NuGet.CommandLine -Version 4.4.1

Paketi yükledikten NuGet.CommandLine sonra, Paket Yöneticisi Konsolu aracılığıyla tüm NuGet CLI komutlarını çalıştırabilirsiniz.

Paket Yöneticisi Konsolunu Genişletme

Bazı paketler komut ekleyerek Paket Yöneticisi Konsolu'nu genişletir. Örneğin, Microsoft.EntityFrameworkCore.Tools paket aşağıdaki gibi komutlar ekler:

  • Add-Migration: Veritabanı tablolarını oluşturmak veya güncelleştirmek için bir geçiş dosyası oluşturur
  • Update-Database: Veritabanını en son geçişe göre oluşturur veya güncelleştirir

Paket Yöneticisi Konsolu penceresinin ekran görüntüsü. Add-Migration ve Update-Database komutlarından alınan çıkış, oluşturulan veritabanını gösterir.

NuGet PowerShell profili ayarlama

Sık kullanılan komutlarınızı tüm PowerShell bağlamlarında kullanılabilir hale getirmek için bir PowerShell profili oluşturabilirsiniz, böylece oturumlar arasında PowerShell ayarlarınızı kaybetmezsiniz. NuGet, NuGet'e özgü bir profili destekler; genellikle %UserProfile%\Documents\WindowsPowerShell\NuGet_profile.ps1.

Kullanıcı profili konumunuzu bulmak için konsola şunu girin $profile :

$profile
C:\Users\<user>\Documents\WindowsPowerShell\NuGet_profile.ps1

Bir profilin bu konumda mevcut olup olmadığını belirlemek için girin test-path $profile. Komut False döndürürse, belirtilen konumda False ile profil oluşturmanız gerekir. Daha fazla bilgi için bkz. Windows PowerShell Profilleri.

İlgili içerik

  • Last updated on