Aracılığıyla paylaş

dotnet list package

  • Makale

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

Ad

dotnet list package - 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

dotnet list package 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. 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 dotnet list package komutunun çıkışı 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) 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.

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 add packagekullanın.

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

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, HelloPlugin projesi için dotnet list package --include-transitive 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:

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

Bağımsız değişken

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. .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]q[uiet]. 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. VulnerabilityInfo kaynağından alınan güvenlik açığı veri kaynağınızı belirtmek için yapılandırma dosyanızdaki <AuditSources> özelliğini kullanın. <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 jsonconsole. varsayılan olarak console. .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 olarak 1. --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 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