Zarządzanie zależnościami pakietów w aplikacjach platformy .NET

  • Artykuł

W tym artykule wyjaśniono, jak dodawać i usuwać zależności pakietów, edytując plik projektu lub przy użyciu interfejsu wiersza polecenia.

<Element PackageReference>

Element <PackageReference> pliku projektu ma następującą strukturę:

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

Atrybut Include określa identyfikator pakietu, który ma zostać dodany do projektu. Atrybut Version określa wersję do pobrania. Wersje są określane zgodnie z regułami wersji nuGet.

Użyj warunków, aby dodać zależność dostępną tylko w określonym obiekcie docelowym, jak pokazano w poniższym przykładzie:

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

Zależność w poprzednim przykładzie będzie prawidłowa tylko wtedy, gdy kompilacja ma miejsce dla danego obiektu docelowego. Element $(TargetFramework) w warunku to właściwość MSBuild, która jest ustawiana w projekcie. W przypadku najpopularniejszych aplikacji platformy .NET nie trzeba tego robić.

Dodawanie i usuwanie zależności

Zależności można dodawać i usuwać, edytując plik projektu lub za pomocą poleceń interfejsu wiersza polecenia platformy .NET.

Edytowanie pliku projektu

Aby dodać zależność, dodaj <PackageReference> element wewnątrz <ItemGroup> elementu. Możesz dodać do istniejącego <ItemGroup> lub utworzyć nowy.

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

  <PropertyGroup>
    ...
  </PropertyGroup>

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

</Project>

Aby usunąć zależność, usuń jego <PackageReference> element z pliku projektu.

Korzystanie z interfejsu wiersza polecenia

Aby dodać zależność, uruchom dotnet add package polecenie, jak pokazano w poniższym przykładzie:

dotnet add package Microsoft.EntityFrameworkCore

Aby usunąć zależność, uruchom dotnet remove package polecenie, jak pokazano w poniższym przykładzie:

dotnet remove package Microsoft.EntityFrameworkCore

Wskazówki

  • Nie dołączaj danych wejściowych do operacji przywracania w pliku targets lub .props przywołytowanego pakietu. Te dane wejściowe mogą obejmować PackageReference elementy, ExcludeAssets atrybuty, źródła danych NuGet do użycia lub inną konfigurację nuGet. Pliki targets i .props z pakietów nie są używane dopiero po zakończeniu przywracania NuGet. Wszystko, co jest potrzebne do przywrócenia, musi znajdować się w pliku projektu lub pliku targets samego projektu, a nie w zależności od pakietu.

  • Jeśli chcesz użyć interfejsów API ASP.NET w aplikacji konsolowej lub bibliotece klas, dodaj element FrameworkReference do pliku projektu:

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

    Aby uzyskać więcej informacji, zobacz Use the ASP.NET Core shared framework (Używanie platformy udostępnionej ASP.NET Core).

Zobacz też