Gestire le dipendenze dei pacchetti nelle applicazioni .NET

Articolo
02/20/2024

Questo articolo illustra come aggiungere e rimuovere le dipendenze dei pacchetti modificando il file di progetto o usando l'interfaccia della riga di comando.

Elemento <PackageReference>

L'elemento <PackageReference> del file di progetto ha la struttura seguente:

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

L'attributo Include specifica l'ID del pacchetto da aggiungere al progetto. L'attributo Version specifica la versione da ottenere. Le versioni vengono specificate in base alle regole della versione di NuGet.

Usare le condizioni per aggiungere una dipendenza disponibile solo in una destinazione specifica, come illustrato nell'esempio seguente:

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

La dipendenza nell'esempio precedente sarà valida solo se la compilazione avviene per tale destinazione specificata. L'elemento $(TargetFramework) nella condizione è una proprietà di MSBuild che viene impostata nel progetto. Per le applicazioni .NET più comuni, non è necessario eseguire questa operazione.

Aggiungere e rimuovere dipendenze

È possibile aggiungere e rimuovere dipendenze modificando il file di progetto o tramite comandi dell'interfaccia della riga di comando di .NET.

Modificare il file di progetto

Per aggiungere una dipendenza, aggiungere un elemento <PackageReference> all'interno di un elemento <ItemGroup>. È possibile aggiungere a un <ItemGroup> esistente o crearne uno nuovo.

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

  <PropertyGroup>
    ...
  </PropertyGroup>

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

</Project>

Per rimuovere una dipendenza, rimuovere il relativo elemento <PackageReference> dal file di progetto.

Usare l'interfaccia della riga di comando

Per aggiungere una dipendenza, eseguire il comando dotnet add package, come illustrato nell'esempio seguente:

dotnet add package Microsoft.EntityFrameworkCore

Per rimuovere una dipendenza, eseguire il comando dotnet remove package, come illustrato nell'esempio seguente:

dotnet remove package Microsoft.EntityFrameworkCore

Suggerimenti

Non includere input per l'operazione di ripristino nel file con estensione targets o props di un pacchetto a cui si fa riferimento. Questi input possono includere elementi PackageReference, attributi ExcludeAssets, feed di NuGet da usare o altre configurazioni di NuGet. I file con estensione targets e props dai pacchetti non vengono usati fino al completamento del ripristino di NuGet. Qualsiasi elemento necessario per il ripristino deve trovarsi nel file di progetto o nel file con estensione targets del progetto stesso, non una dipendenza del pacchetto.
Per usare le API ASP.NET in un'applicazione console o in una libreria di classi, aggiungere un elemento FrameworkReference al file di progetto:

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

Per altre informazioni, vedere Usare il framework condiviso di ASP.NET Core.

Condividi tramite