Mengelola dependensi paket dalam aplikasi .NET

Artikel
03/02/2024

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) Dalam kondisi adalah properti MSBuild yang sedang 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 add package ditunjukkan dalam contoh berikut:

dotnet add package Microsoft.EntityFrameworkCore

Untuk menghapus dependensi, jalankan perintah, seperti yang dotnet remove package ditunjukkan dalam contoh berikut:

dotnet remove package Microsoft.EntityFrameworkCore

Tips

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.

Bagikan melalui