dotnet list package

Makale
04/06/2024

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

Veri Akışı Adı

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

Özet

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

dotnet list package -h|--help

Açıklama

komutu, dotnet list package 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. Bu komutun işlenmesi için gereken varlıkların olması için önce projeyi oluşturmanız gerekir. Aşağıdaki örnekte SentimentAnalysis projesi için komutun çıkışı dotnet list package gösterilmektedir:

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) sağını görüntüleyen paketler, proje ayarlarınızdan (Sdk tür veya <TargetFramework><TargetFrameworks> özellik) çıkarılmış örtük paket başvurularını temsil eder.

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

Aşağıdaki örnekte, önceki örnekle dotnet list package --outdated --include-prerelease aynı proje için komutun çıkışı gösterilmektedir:

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 seçeneğini kullanın --include-transitive . Geçişli bağımlılıklar, projenize başka bir paketi kullanan bir paket eklediğinizde oluşur. Aşağıdaki örnekte HelloPlugin projesi için komutu çalıştırmanın dotnet list package --include-transitive çıkışı gösterilmektedir ve bu çıktıda en üst düzey paketler ve bağımlı oldukları paketler görüntülenir:

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

Bağımsız değişkenler

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ği gerektirir.
--deprecated

Kullanım dışı bırakılmış paketleri görüntüler.
-f|--framework <FRAMEWORK>

Yalnızca belirtilen hedef çerçeve iç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. .NET Core 3.0 SDK'sı ile kullanılabilir.

--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 , m[inimal], n[ormal], d[etailed]ve diag[nostic]değerleridirq[uiet]. Varsayılan değer: minimal. Daha fazla bilgi için bkz. LoggerVerbosity.

--vulnerable

Bilinen güvenlik açıkları olan paketleri listeler. veya --outdated seçenekleriyle --deprecated birleştirilemez. Nuget.org, güvenlik açıkları hakkında bilgi kaynağıdır. Daha fazla bilgi için bkz. Güvenlik Açıkları ve Güvenlik Açıkları için NuGet Paketlerini Tarama.
--format <console|json>

Rapor çıkış biçimini ayarlar. İzin verilen değerler şunlardır: console, json. varsayılan değeridir console. .NET SDK 7.0.200'den itibaren kullanılabilir.
--output-version <VERSION>

Rapor çıkış sürümünü ayarlar. İzin verilen değer şeklindedir 1. varsayılan değeridir 1. --format json Seçeneği 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 list SentimentAnalysis.csproj package
```
Yayın öncesi sürümler de dahil olmak üzere daha yeni sürümlere sahip paket başvurularını listeleyin:
```
dotnet list package --outdated --include-prerelease
```
Belirli bir hedef çerçeve için paket başvurularını listeleme:
```
dotnet list package --framework netcoreapp3.0
```
Paket başvurularını makine tarafından okunabilir json çıkış biçiminde listeleyin:
```
dotnet list package --format json
```
Makine tarafından okunabilir json çıkış biçiminde belirli bir hedef çerçeve için paket başvurularını listeleyin:
```
dotnet list package --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 list package --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 list package --format json --output-version 1
```

Aracılığıyla paylaş