Aracılığıyla paylaş

dotnet paket listesi

Bu makale şunlar için geçerlidir: ✔️ .NET 6 SDK ve sonraki sürümler

İsim

dotnet package list - Proje veya çözüm için paket başvurularını listeler.

Uyarı

.NET 9 SDK veya önceki bir sürüm kullanıyorsanız bunun yerine "önce fiil" formunu (dotnet list package) kullanın. "önce isim" formu .NET 10'da tanıtıldı. Daha fazla bilgi için bkz. Daha tutarlı komut sırası.

Özet

dotnet package list [--config <SOURCE>]
    [--deprecated] [--project [<PROJECT>|<SOLUTION>]]
    [-f|--framework <FRAMEWORK>] [--highest-minor] [--highest-patch]
    [--include-prerelease] [--include-transitive] [--interactive]
    [--no-restore] [--outdated] [--source <SOURCE>] [-v|--verbosity <LEVEL>]
    [--vulnerable]
    [--format <console|json>]
    [--output-version <VERSION>]

dotnet package list -h|--help

Açıklama

dotnet package list komutu, belirli bir proje veya çözüm için tüm NuGet paket başvurularını listelemek için kullanışlı bir seçenek sağlar. .NET 10'dan başlayarak, komut sonuçları oluşturmadan önce gerekirse otomatik olarak geri yükleme gerçekleştirir. Önceki sürümlerde, bu komutun işlenmesi için gereken varlıkların olması için önce projeyi derlemeniz/geri yüklemeniz gerekir. Aşağıdaki örnekte, dotnet package list projesi için komutunun çıkışı gösterilmektedir:

Restore complete (5.9s)

Build succeeded in 6.0s
Project 'SentimentAnalysis' has the following package references
   [netcoreapp2.1]:
   Top-level Package               Requested   Resolved
   > Microsoft.ML                  1.4.0       1.4.0
   > Microsoft.NETCore.App   (A)   [2.1.0, )   2.1.0

(A) : Auto-referenced package.

İstenen sütunu, proje dosyasında belirtilen paket sürümüne başvurur ve bir aralık olabilir. Çözüldü sütunu, projenin şu anda kullandığı sürümü listeler ve her zaman tek bir değerdir. Adlarının yanında bir (A) görüntüleyen paketler, proje ayarlarınızdan (Sdk tür veya <TargetFramework> veya <TargetFrameworks> özelliği) çıkarılmış örtük paket başvurularını temsil eder.

Otomatik geri yüklemeyi atlamak istiyorsanız seçeneğini kullanabilirsiniz --no-restore . Örnek dotnet package list --no-restore:

Project 'SentimentAnalysis' has the following package references
   [netcoreapp2.1]:
   Top-level Package               Requested   Resolved
   > Microsoft.ML                  1.4.0       1.4.0
   > Microsoft.NETCore.App   (A)   [2.1.0, )   2.1.0

(A) : Auto-referenced package.

Projelerinizde kullandığınız paketlerin daha yeni sürümleri olup olmadığını öğrenmek için --outdated seçeneğini kullanın. Varsayılan olarak, çözümlenen sürüm aynı zamanda yayın öncesi sürüm olmadığı sürece --outdated en son kararlı paketleri listeler. Yeni sürümleri listelerken yayın öncesi sürümleri eklemek için --include-prerelease seçeneğini de belirtin. Bir paketi en son sürüme güncelleştirmek için dotnet package add komutunu kullanın.

Aşağıdaki örnek, önceki örnekle aynı proje için dotnet package list --outdated --include-prerelease komutunun çıkışını gösterir:

Restore complete (0.6s)

Build succeeded in 0.7s

The following sources were used:
   https://api.nuget.org/v3/index.json
   C:\Program Files (x86)\Microsoft SDKs\NuGetPackages\

Project `SentimentAnalysis` has the following updates to its packages
   [netcoreapp2.1]:
   Top-level Package      Requested   Resolved   Latest
   > Microsoft.ML         1.4.0       1.4.0      1.5.0-preview

Projenizin geçişli bağımlılıkları olup olmadığını bulmanız gerekiyorsa --include-transitive seçeneğini kullanın. Geçişli bağımlılıklar, projenize başka bir paketi kullanan bir paket eklediğinizde oluşur. Aşağıdaki örnek, dotnet package list --include-transitive projesi için komutunu çalıştırmanın çıktısını gösterir. Bu komut, en üst düzey paketleri ve bağımlı oldukları paketleri görüntüler:

Restore complete (0.6s)

Build succeeded in 0.7s
Project 'HelloPlugin' has the following package references
   [netcoreapp3.0]:
   Transitive Package      Resolved
   > PluginBase            1.0.0

Tartışmalar

PROJECT | SOLUTION

Üzerinde çalışacak proje veya çözüm dosyası. Belirtilmezse, komut geçerli dizinde bir tane arar. Birden fazla çözüm veya proje bulunursa bir hata oluşur.

Seçenekler

  • --config <SOURCE>

    Daha yeni paketler ararken kullanılacak NuGet kaynakları. --outdated seçeneğini gerektirir.

  • --deprecated

    Kullanım dışı bırakılmış paketleri görüntüler.

  • -f|--framework <FRAMEWORK>

    Yalnızca belirtilen hedef çerçeveiçin geçerli paketleri görüntüler. Birden çok çerçeve belirtmek için seçeneği birden çok kez yineleyin. Örneğin: --framework net6.0 --framework netstandard2.0. Seçeneğin kısa biçimi (-f) .NET 9 SDK'dan itibaren kullanılabilir.

  • -?|-h|--help

    komutunun nasıl kullanılacağına ilişkin bir açıklama yazdırır.

  • --highest-minor

    Yeni paketleri ararken yalnızca eşleşen ana sürüm numarasına sahip paketleri dikkate alır. --outdated veya --deprecated seçeneğini gerektirir.

  • --highest-patch

    Daha yeni paketleri ararken yalnızca eşleşen ana ve ikincil sürüm numaralarına sahip paketleri dikkate alır. --outdated veya --deprecated seçeneğini gerektirir.

  • --include-prerelease

    Daha yeni paketleri ararken yayın öncesi sürümlere sahip paketleri dikkate alır. --outdated veya --deprecated seçeneğini gerektirir.

  • --include-transitive

    Üst düzey paketlere ek olarak geçişli paketleri listeler. Bu seçeneği belirtirken, en üst düzey paketlerin bağımlı olduğu paketlerin listesini alırsınız.

  • --interactive

    Komutun durmasına ve kullanıcı girişini veya eylemini beklemesine izin verir. Örneğin, kimlik doğrulamasını tamamlamak için.

  • --no-restore

    Komutu çalıştırmadan önce geri yüklemeyin.

  • --outdated

    Daha yeni sürümlere sahip paketleri listeler.

  • -s|--source <SOURCE>

    Daha yeni paketler ararken kullanılacak NuGet kaynakları. --outdated veya --deprecated seçeneğini gerektirir.

  • -v|--verbosity <LEVEL>

    Komutun ayrıntı düzeyini ayarlar. İzin verilen değerler , q[uiet], m[inimal], n[ormal]ve d[etailed]diag[nostic]. Varsayılan değer: minimal. Daha fazla bilgi için bkz. LoggerVerbosity.

  • --vulnerable

    Bilinen güvenlik açıkları olan paketleri listeler. --deprecated veya --outdated seçenekleriyle birleştirilemez. .NET SDK 9.0.300'den itibaren kullanılabilir olan bu seçenek, <AuditSources> kaynağından alınan güvenlik açığı veri kaynağınızı belirtmek için yapılandırma dosyanızdaki özelliğini kullanır. <AuditSources> belirtilmezse, güvenlik açığı verilerini yüklemek için belirtilen <PackageSources> kullanılır. Daha fazla bilgi için bkz. Denetim kaynakları ve NuGet paketlerinigüvenlik açıkları için tarama.

  • --format <console|json>

    Rapor çıkış biçimini ayarlar. İzin verilen değerler consolejson. Varsayılan değer console olarak ayarlanır. .NET SDK 7.0.200'den itibaren kullanılabilir.

  • --output-version <VERSION>

    Rapor çıkış sürümünü ayarlar. İzin verilen değer 1. Varsayılan değer 1 olarak ayarlanır. --format json seçeneğini gerektirir. Yeni bir JSON sürümü kullanılabilir olduğunda, komut varsayılan olarak yeni biçimi oluşturur. Bu seçenek, komutun daha önceki bir biçim oluşturması gerektiğini belirtmenize olanak verir. .NET SDK 7.0.200'den itibaren kullanılabilir.

Örnekler

  • Belirli bir projenin paket başvurularını listeleme:

    dotnet package list --project SentimentAnalysis.csproj

  • Yayın öncesi sürümler de dahil olmak üzere daha yeni sürümlere sahip paket başvurularını listeleyin:

    dotnet package list --outdated --include-prerelease

  • Belirli bir hedef çerçeve için paket başvurularını listeleme:

    dotnet package list --framework netcoreapp3.0

  • Paket başvurularını makine tarafından okunabilir json çıkış biçiminde listeleyin:

    dotnet package list --format json

  • Makine tarafından okunabilir json çıkış biçiminde belirli bir hedef çerçeve için paket başvurularını listeleyin:

    dotnet package list --framework netcoreapp3.0 --format json

  • Geçişli bağımlılık ve güvenlik açığı ayrıntıları da dahil olmak üzere paket başvurularının makine tarafından okunabilir json çıkışını bir dosyaya kaydedin:

    dotnet package list --include-transitive --vulnerable --format json >> dependencyReport.json

  • Çıkış sürümü 1 ile makine tarafından okunabilir json çıkış biçiminde paket başvurularını listeleyin:

    dotnet package list --format json --output-version 1
  • Last updated on