Bagikan melalui

daftar paket dotnet

Artikel ini berlaku untuk: ✔️ .NET 6 SDK dan versi yang lebih baru

Nama

dotnet package list - Mencantumkan referensi paket untuk proyek atau solusi.

Nota

Jika Anda menggunakan .NET 9 SDK atau yang lebih lama, gunakan formulir "kata kerja pertama" (dotnet list package) sebagai gantinya. Formulir "kata benda pertama" diperkenalkan dalam .NET 10. Untuk informasi selengkapnya, lihat Urutan perintah yang lebih konsisten.

Sinopsis

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

Deskripsi

Perintah dotnet package list menyediakan opsi yang nyaman untuk mencantumkan semua referensi paket NuGet untuk proyek atau solusi tertentu. Dimulai dengan .NET 10, perintah secara otomatis melakukan pemulihan jika perlu sebelum menghasilkan hasilnya. Dalam versi sebelumnya, Anda harus terlebih dahulu membangun/memulihkan proyek agar aset yang diperlukan agar perintah ini dapat diproses. Contoh berikut menunjukkan output perintah dotnet package list untuk proyek SentimentAnalysis:

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.

Kolom Diminta mengacu pada versi paket yang ditentukan dalam file proyek dan dapat berupa rentang. Kolom Diselesaikan mencantumkan versi yang saat ini digunakan proyek dan selalu merupakan nilai tunggal. Paket yang menampilkan (A) tepat di samping namanya mewakili referensi paket implisit yang disimpulkan dari pengaturan proyek Anda (jenisSdk, atau properti <TargetFramework> atau <TargetFrameworks>).

Jika Anda ingin melewati pemulihan otomatis, Anda dapat menggunakan opsi .--no-restore Contoh 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.

Gunakan opsi --outdated untuk mengetahui apakah ada versi yang lebih baru yang tersedia dari paket yang Anda gunakan di proyek Anda. Secara default, --outdated mencantumkan paket stabil terbaru kecuali versi yang diselesaikan juga merupakan versi prarilis. Untuk menyertakan versi prarilis saat mencantumkan versi yang lebih baru, tentukan juga opsi --include-prerelease. Untuk memperbarui paket ke versi terbaru, gunakan penambahan paket dotnet.

Contoh berikut menunjukkan output perintah dotnet package list --outdated --include-prerelease untuk proyek yang sama dengan contoh sebelumnya:

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

Jika Anda perlu mengetahui apakah proyek Anda memiliki dependensi transitif, gunakan opsi --include-transitive. Dependensi transitif terjadi ketika Anda menambahkan paket ke proyek Anda yang pada gilirannya bergantung pada paket lain. Contoh berikut menunjukkan output dari menjalankan perintah dotnet package list --include-transitive untuk proyek HelloPlugin, yang menampilkan paket tingkat atas dan paket yang bergantung pada:

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

Argumen

PROJECT | SOLUTION

File proyek atau solusi untuk dioperasikan. Jika tidak ditentukan, perintah mencari direktori saat ini untuk satu direktori. Jika lebih dari satu solusi atau proyek ditemukan, kesalahan akan muncul.

Opsi

  • --config <SOURCE>

    Sumber NuGet yang akan digunakan saat mencari paket yang lebih baru. Memerlukan opsi --outdated.

  • --deprecated

    Menampilkan paket yang tidak digunakan lagi.

  • -f|--framework <FRAMEWORK>

    Hanya menampilkan paket yang berlaku untuk kerangka kerja target yang ditentukan. Untuk menentukan beberapa kerangka kerja, ulangi opsi beberapa kali. Misalnya: --framework net6.0 --framework netstandard2.0. Bentuk pendek opsi (-f) tersedia mulai dari .NET 9 SDK.

  • -?|-h|--help

    Mencetak deskripsi cara menggunakan perintah.

  • --highest-minor

    Hanya mempertimbangkan paket dengan nomor versi utama yang cocok saat mencari paket yang lebih baru. Memerlukan opsi --outdated atau --deprecated.

  • --highest-patch

    Hanya mempertimbangkan paket dengan nomor versi utama dan minor yang cocok saat mencari paket yang lebih baru. Memerlukan opsi --outdated atau --deprecated.

  • --include-prerelease

    Mempertimbangkan paket dengan versi prarilis saat mencari paket yang lebih baru. Memerlukan opsi --outdated atau --deprecated.

  • --include-transitive

    Mencantumkan paket transitif, selain paket tingkat atas. Saat menentukan opsi ini, Anda mendapatkan daftar paket yang bergantung pada paket tingkat atas.

  • --interactive

    Memungkinkan perintah berhenti dan menunggu input atau tindakan pengguna. Misalnya, untuk menyelesaikan autentikasi.

  • --no-restore

    Jangan pulihkan sebelum menjalankan perintah.

  • --outdated

    Mencantumkan paket yang memiliki versi yang lebih baru yang tersedia.

  • -s|--source <SOURCE>

    Sumber NuGet yang akan digunakan saat mencari paket yang lebih baru. Memerlukan opsi --outdated atau --deprecated.

  • -v|--verbosity <LEVEL>

    Mengatur tingkat verbositas perintah. Nilai yang diizinkan adalah q[uiet], m[inimal], n[ormal], d[etailed], dan diag[nostic]. Defaultnya adalah minimal. Untuk informasi selengkapnya, lihat LoggerVerbosity .

  • --vulnerable

    Mencantumkan paket yang memiliki kerentanan yang diketahui. Tidak dapat digabungkan dengan opsi --deprecated atau --outdated. Tersedia mulai dari .NET SDK 9.0.300, opsi ini menggunakan <AuditSources> properti dalam file konfigurasi Anda untuk menentukan sumber data kerentanan Anda, yang diperoleh dari sumber daya VulnerabilityInfo . Jika <AuditSources> tidak ditentukan, <PackageSources> yang ditentukan digunakan untuk memuat data kerentanan. Untuk informasi selengkapnya, lihat sumber Audit dan Cara memindai paket NuGet untuk kerentanan keamanan.

  • --format <console|json>

    Mengatur format output laporan. Nilai yang diizinkan adalah console, json. Diatur menjadi console. Tersedia mulai dari .NET SDK 7.0.200.

  • --output-version <VERSION>

    Mengatur versi output laporan. Nilai yang diizinkan 1. Diatur menjadi 1. Memerlukan opsi --format json. Saat versi JSON baru tersedia, perintah akan menghasilkan format baru secara default. Opsi ini akan memungkinkan Anda menentukan bahwa perintah harus menghasilkan format sebelumnya. Tersedia mulai dari .NET SDK 7.0.200.

Contoh

  • Cantumkan referensi paket proyek tertentu:

    dotnet package list --project SentimentAnalysis.csproj

  • Cantumkan referensi paket yang memiliki versi yang lebih baru yang tersedia, termasuk versi prarilis:

    dotnet package list --outdated --include-prerelease

  • Cantumkan referensi paket untuk kerangka kerja target tertentu:

    dotnet package list --framework netcoreapp3.0

  • Cantumkan referensi paket dalam format output json yang dapat dibaca mesin:

    dotnet package list --format json

  • Cantumkan referensi paket untuk kerangka kerja target tertentu dalam format output json yang dapat dibaca mesin:

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

  • Simpan output json referensi paket yang dapat dibaca mesin, termasuk dependensi transitif dan detail kerentanan ke dalam file:

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

  • Cantumkan referensi paket dalam format output json yang dapat dibaca mesin dengan output versi 1:

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