paket daftar dotnet

Artikel
04/06/2024

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 ini 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 dotnet list package perintah 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 yang Diminta mengacu pada versi paket yang ditentukan dalam file proyek dan dapat berupa rentang. Kolom Terselesaikan mencantumkan versi yang saat ini digunakan proyek dan selalu merupakan satu nilai. Paket yang (A) menampilkan kanan di samping namanya mewakili referensi paket implisit yang disimpulkan dari pengaturan proyek Anda (Sdk jenis, atau <TargetFramework><TargetFrameworks> properti).

--outdated Gunakan opsi 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 --include-prerelease juga opsi . Untuk memperbarui paket ke versi terbaru, gunakan paket tambahkan dotnet.

Contoh berikut menunjukkan output dotnet list package --outdated --include-prerelease perintah 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 dotnet list package --include-transitive perintah 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.

Opsi

--config <SOURCE>

Sumber NuGet yang akan digunakan saat mencari paket yang lebih baru. Memerlukan --outdated opsi .
--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 --outdated opsi atau --deprecated .
--highest-patch

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

Mempertimbangkan paket dengan versi prarilis saat mencari paket yang lebih baru. Memerlukan --outdated opsi 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 SDK .NET Core 3.0.

--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 --outdated opsi atau --deprecated .

-v|--verbosity <LEVEL>

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

--vulnerable

Mencantumkan paket yang memiliki kerentanan yang diketahui. Tidak dapat digabungkan dengan --deprecated atau --outdated opsi. Nuget.org adalah sumber informasi tentang kerentanan. Untuk informasi selengkapnya, lihat Kerentanan 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 adalah 1. Default ke 1. Memerlukan --format json opsi . 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