Bagikan melalui


pembaruan paket dotnet

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

Nama

dotnet package update - Memperbarui paket yang dirujuk dalam proyek.

Sinopsis

dotnet package update [<packages>...]
    [--interactive] [--project <path>]
    [--verbosity <level>] [--vulnerable]

dotnet package update -h|--help

Description

dotnet package update Perintah memperbarui paket yang digunakan oleh proyek. Jika NuGetAudit diaktifkan, NuGetAudit juga dapat mencoba memperbarui paket secara otomatis dengan kerentanan yang diketahui ke versi tetap.

Peringatan sebagai Kesalahan

dotnet package update melakukan pemulihan implisit untuk memeriksa apakah grafik paket yang dihasilkan bebas dari kesalahan. Menggunakan --vulnerable juga melakukan pemulihan implisit untuk menemukan peringatan NuGetAudit. Namun, jika proyek Anda menggunakan WarningsAsErrors atau TreatWarningsAsErrors, peringatan pemulihan NuGet dapat menyebabkan pemulihan gagal, mencegah pembaruan selesai.

Sebaiknya manfaatkan kondisi MSBuild dan variabel lingkungan sebagai solusi hingga permintaan fitur ini diterapkan. Misalnya, atur <TreatWarningsAsErrors Condition=" '$(CustomCondition)' == ''>true</TreatWarningsAsErrors> dalam proyek Anda, lalu di sebagian besar shell Linux dan Mac Anda dapat menjalankan CustomCondition=true dotnet package update. Pada Windows Command Prompt dan PowerShell, Anda harus mengatur variabel lingkungan, menjalankan pembaruan paket dotnet, lalu membatalkan set variabel lingkungan sebagai tiga perintah terpisah.

Arguments

  • packages

    Daftar paket opsional yang akan diperbarui. Ketika tidak ada paket yang disediakan, perintah akan mencoba memperbarui semua paket yang dirujuk oleh proyek. Paket dapat berupa nama paket secara opsional diikuti oleh @ dan nomor versi. Misalnya, dotnet package update Contoso.Utilities atau dotnet package update Contoso.Utilities@3.2.1. Ketika tidak ada versi yang disediakan, itu akan menemukan versi tertinggi yang tersedia pada sumber paket yang dikonfigurasi.

Opsi

  • --interactive

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

  • --project <path>

    Proyek tempat paket harus diperbarui. Jika direktori disediakan, direktori akan mencari file proyek dan solusi di direktori. Default ke direktori kerja saat ini.

  • -v|--verbosity <LEVEL>

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

  • --vulnerable

    Jika pemulihan melaporkan paket apa pun karena memiliki kerentanan yang diketahui, perintah ini akan meningkatkan paket tersebut. Menggunakan opsi ini akan meningkatkan paket ke versi terendah yang lebih tinggi dari versi yang saat ini dirujuk, yang tidak memiliki kerentanan yang diketahui.

  • -?|-h|--help

    Mencetak deskripsi cara menggunakan perintah.

Examples

  • Memperbarui semua paket dalam proyek ke versi tertinggi yang tersedia

    dotnet package update
    
    Updating outdated packages in S:\src\test\update\ConsoleApp1.
      ConsoleApp1:
        Updated Microsoft.Extensions.Configuration 9.0.0 to 9.0.9.
        Updated Microsoft.Extensions.DependencyInjection 9.0.0 to 9.0.9.
    
    Updated 2 packages in 7 scanned packages.
    
  • Perbarui Contoso.Utilities ke versi tertinggi yang tersedia, dan Fabrikam.WebApi ke versi 1.2.3

    dotnet package update Contoso.Utilities Fabrikam.WebApi@1.2.3
    
    Updating outdated packages in S:\src\test\update\ConsoleApp1.
      ConsoleApp1:
        Updated Contoso.Utilities 2.3.1 to 2.4.6.
        Updated Fabrikam.WebApi 1.0.2 to 1.2.3.
    
    Updated 2 packages in 2 scanned packages.
    
  • Memperbarui paket dengan kerentanan yang diketahui

    dotnet package update --vulnerable
    
    Updating packages with security advisories in S:\src\test\update\ConsoleApp1
      ConsoleApp1:
        Updating System.Text.Json 8.0.0 to 8.0.5.
    
    Updated 1 packages in 31 scanned packages.