paket daftar dotnet

Artikel
03/05/2025

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

Nama

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

Sinopsis

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

Deskripsi

Perintah dotnet list package menyediakan opsi yang nyaman untuk mencantumkan semua referensi paket NuGet untuk proyek atau solusi tertentu. Anda harus terlebih dahulu membangun proyek agar aset yang diperlukan agar perintah ini dapat diproses. Contoh berikut menunjukkan output perintah dotnet list package untuk proyek SentimentAnalysis:

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>).

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 dotnet tambahkan paket.

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

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 list package --include-transitive untuk proyek HelloPlugin, yang menampilkan paket tingkat atas dan paket yang bergantung pada:

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.

Pilihan

--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. Tersedia sejak .NET Core 3.0 SDK.

--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. Gunakan properti <AuditSources> 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. Default ke console. Tersedia mulai dari .NET SDK 7.0.200.
--output-version <VERSION>

Mengatur versi output laporan. Nilai yang diizinkan 1. Default ke 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 list SentimentAnalysis.csproj package

Cantumkan referensi paket yang memiliki versi yang lebih baru yang tersedia, termasuk versi prarilis:
```
dotnet list package --outdated --include-prerelease
```
Cantumkan referensi paket untuk kerangka kerja target tertentu:
```
dotnet list package --framework netcoreapp3.0
```
Cantumkan referensi paket dalam format output json yang dapat dibaca mesin:
```
dotnet list package --format json
```
Cantumkan referensi paket untuk kerangka kerja target tertentu dalam format output json yang dapat dibaca mesin:
```
dotnet list package --framework netcoreapp3.0 --format json
```
Simpan output json referensi paket yang dapat dibaca mesin, termasuk dependensi transitif dan detail kerentanan ke dalam file:
```
dotnet list package --include-transitive --vulnerable --format json >> dependencyReport.json
```
Cantumkan referensi paket dalam format output json yang dapat dibaca mesin dengan output versi 1:
```
dotnet list package --format json --output-version 1
```

Bagikan melalui