Bagikan melalui

Mengelola dependensi paket dalam aplikasi .NET

Artikel ini menjelaskan cara menambahkan dan menghapus dependensi paket dengan mengedit file proyek atau dengan menggunakan CLI.

Elemen <PackageReference>

Elemen <PackageReference> file proyek memiliki struktur berikut:

<PackageReference Include="PACKAGE_ID" Version="PACKAGE_VERSION" />

Atribut Include menentukan ID paket untuk ditambahkan ke proyek. Atribut Version menentukan versi yang akan didapatkan. Versi ditentukan sesuai aturan versi NuGet.

Gunakan kondisi untuk menambahkan dependensi yang hanya tersedia di target tertentu, seperti yang ditunjukkan dalam contoh berikut:

<PackageReference Include="PACKAGE_ID" Version="PACKAGE_VERSION" Condition="'$(TargetFramework)' == 'netcoreapp2.1'" />

Dependensi dalam contoh sebelumnya hanya akan valid jika build terjadi untuk target tertentu. $(TargetFramework) merupakan properti MSBuild dalam kondisi yang diatur dalam proyek. Untuk aplikasi .NET yang paling umum, Anda tidak perlu melakukan ini.

Menambahkan dan menghapus dependensi

Anda dapat menambahkan dan menghapus dependensi dengan mengedit file proyek Anda atau melalui perintah .NET CLI .

Mengedit file proyek

Untuk menambahkan dependensi, tambahkan <PackageReference> item di dalam <ItemGroup> elemen. Anda dapat menambahkan ke yang sudah <ItemGroup> ada atau membuat yang baru.

<Project Sdk="Microsoft.NET.Sdk.Web">

  <PropertyGroup>
    ...
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="Microsoft.EntityFrameworkCore" Version="3.1.2" />
  </ItemGroup>

</Project>

Untuk menghapus dependensi, hapus itemnya <PackageReference> dari file proyek.

Menggunakan CLI

Untuk menambahkan dependensi, jalankan perintah , seperti yang dotnet package add ditunjukkan dalam contoh berikut. (Jika Anda menggunakan versi SDK .NET 9 atau yang lebih lama, gunakan formulir sebagai gantinya dotnet add package .)

dotnet package add Microsoft.EntityFrameworkCore

Untuk menghapus dependensi, jalankan perintah , seperti yang dotnet package remove ditunjukkan dalam contoh berikut. (Jika Anda menggunakan versi SDK .NET 9 atau yang lebih lama, gunakan formulir sebagai gantinya dotnet remove package .)

dotnet package remove Microsoft.EntityFrameworkCore

Petunjuk

  • Jangan sertakan input ke operasi pemulihan dalam file .targets atau .props dari paket yang dirujuk. Input ini dapat mencakup PackageReference item, ExcludeAssets atribut, umpan NuGet yang akan digunakan, atau konfigurasi NuGet lainnya. File .targets dan .props dari paket tidak digunakan sampai setelah pemulihan NuGet selesai. Apa pun yang diperlukan untuk pemulihan harus berada dalam file proyek atau file .targets proyek itu sendiri, bukan dependensi paket.

  • Jika Anda ingin menggunakan API ASP.NET di aplikasi konsol atau pustaka kelas, tambahkan item FrameworkReference ke file proyek Anda:

    <FrameworkReference Include="Microsoft.AspNetCore.App" />

    Untuk informasi selengkapnya, lihat Menggunakan kerangka kerja bersama ASP.NET Core.

Lihat juga

  • Last updated on