dotnet add package
Ten artykuł dotyczy: ✔️ zestaw .NET Core 3.1 SDK i nowsze wersje
Nazwisko
dotnet add package — Dodaje lub aktualizuje odwołanie do pakietu w pliku projektu.
Streszczenie
dotnet add [<PROJECT>] package <PACKAGE_NAME>
[-f|--framework <FRAMEWORK>] [--interactive]
[-n|--no-restore] [--package-directory <PACKAGE_DIRECTORY>]
[--prerelease] [-s|--source <SOURCE>] [-v|--version <VERSION>]
dotnet add package -h|--help
opis
Polecenie dotnet add package zapewnia wygodną opcję dodawania lub aktualizowania odwołania do pakietu w pliku projektu. Po uruchomieniu polecenia jest sprawdzana zgodność, aby upewnić się, że pakiet jest zgodny ze strukturami w projekcie. Jeśli sprawdzanie przebiegnie pomyślnie, a pakiet nie jest przywoływany w pliku projektu, <PackageReference> element zostanie dodany do pliku projektu. Jeśli sprawdzanie zakończy się pomyślnie, a pakiet jest już przywołyany w pliku projektu, <PackageReference> element zostanie zaktualizowany do najnowszej zgodnej wersji. Po zaktualizowaniu pliku projektu zostanie uruchomione przywracanie dotnet.
Na przykład dodanie Microsoft.EntityFrameworkCore do pliku ToDo.csproj generuje dane wyjściowe podobne do następującego przykładu:
Determining projects to restore...
Writing C:\Users\username\AppData\Local\Temp\tmp24A8.tmp
info : Adding PackageReference for package 'Microsoft.EntityFrameworkCore' into project 'C:\ToDo\ToDo.csproj'.
info : CACHE https://api.nuget.org/v3/registration5-gz-semver2/microsoft.entityframeworkcore/index.json
info : GET https://pkgs.dev.azure.com/dnceng/9ee6d478-d288-47f7-aacc-f6e6d082ae6d/_packaging/516521bf-6417-457e-9a9c-0a4bdfde03e7/nuget/v3/registrations2-semver2/microsoft.entityframeworkcore/index.json
info : CACHE https://api.nuget.org/v3/registration5-gz-semver2/microsoft.entityframeworkcore/page/0.0.1-alpha/3.1.3.json
info : CACHE https://api.nuget.org/v3/registration5-gz-semver2/microsoft.entityframeworkcore/page/3.1.4/7.0.0-preview.2.22153.1.json
info : CACHE https://api.nuget.org/v3/registration5-gz-semver2/microsoft.entityframeworkcore/page/7.0.0-preview.3.22175.1/7.0.0-preview.3.22175.1.json
info : NotFound https://pkgs.dev.azure.com/dnceng/9ee6d478-d288-47f7-aacc-f6e6d082ae6d/_packaging/516521bf-6417-457e-9a9c-0a4bdfde03e7/nuget/v3/registrations2-semver2/microsoft.entityframeworkcore/index.json 257ms
info : Restoring packages for C:\ToDo\ToDo.csproj...
info : Package 'Microsoft.EntityFrameworkCore' is compatible with all the specified frameworks in project 'C:\ToDo\ToDo.csproj'.
info : PackageReference for package 'Microsoft.EntityFrameworkCore' version '6.0.4' added to file 'C:\ToDo\ToDo.csproj'.
info : Writing assets file to disk. Path: C:\ToDo\obj\project.assets.json
log : Restored C:\ToDo\ToDo.csproj (in 171 ms).
Plik ToDo.csproj zawiera <PackageReference> teraz element dla przywołytowanego pakietu.
<PackageReference Include="Microsoft.EntityFrameworkCore" Version="6.0.4" />
Jeśli projekt jest dołączany do centralnego zarządzania pakietami (CPM), <PackageVersion> element w Directory.Packages.props file pliku zostanie dodany/zaktualizowany, a <PackageReference> element zostanie dodany do pliku projektu.
Obecnie obsługiwane są następujące scenariusze. W tych przykładach przyjęto założenie, że najnowsza wersja programu Microsoft.EntityFrameworkCore to 6.0.4. Dodatkowe scenariusze związane z cpm są udokumentowane w tej specyfikacji projektu.
Scenariusz 1: <PackageReference> nie istnieje w pliku projektu, <PackageVersion> element nie istnieje w elememencie Directory.Packages.props file, a argument wersji nie jest przekazywany z wiersza polecenia.
Wykonywane polecenie interfejsu wiersza polecenia: dotnet add ToDo.csproj package Microsoft.EntityFrameworkCore
Element <PackageVersion> jest dodawany do elementu Directory.Packages.props file.
<PackageVersion Include="Microsoft.EntityFrameworkCore" Version="6.0.4" />
Element <PackageReference> jest dodawany do pliku projektu.
<PackageReference Include="Microsoft.EntityFrameworkCore" />
Scenariusz 2: <PackageReference> nie istnieje w pliku projektu, <PackageVersion> element nie istnieje w elememencie Directory.Packages.props file, a argument wersji jest przekazywany z wiersza polecenia.
Wykonywane polecenie interfejsu wiersza polecenia: dotnet add ToDo.csproj package Microsoft.EntityFrameworkCore --version 5.0.4
Element <PackageVersion> jest dodawany do elementu Directory.Packages.props file.
<PackageVersion Include="Microsoft.EntityFrameworkCore" Version="5.0.4" />
Element <PackageReference> jest dodawany do pliku projektu.
<PackageReference Include="Microsoft.EntityFrameworkCore" />
Scenariusz 3: <PackageReference> nie istnieje w pliku projektu, <PackageVersion> element istnieje w elememencie Directory.Packages.props file, a argument wersji nie jest przekazywany z wiersza polecenia.
Wykonywane polecenie interfejsu wiersza polecenia: dotnet add ToDo.csproj package Microsoft.EntityFrameworkCore
Element <PackageVersion> jest dodawany do elementu Directory.Packages.props file.
<PackageVersion Include="Microsoft.EntityFrameworkCore" Version="6.0.4" />
Element <PackageReference> jest dodawany do pliku projektu.
<PackageReference Include="Microsoft.EntityFrameworkCore" />
Scenariusz 4: <PackageReference> nie istnieje w pliku projektu, <PackageVersion> element istnieje w elememencie Directory.Packages.props file, a argument wersji jest przekazywany z wiersza polecenia.
Wykonywane polecenie interfejsu wiersza polecenia: dotnet add ToDo.csproj package Microsoft.EntityFrameworkCore --version 5.0.4
Element <PackageVersion> jest dodawany do elementu Directory.Packages.props file.
<PackageVersion Include="Microsoft.EntityFrameworkCore" Version="5.0.4" />
Element <PackageReference> jest dodawany do pliku projektu.
<PackageReference Include="Microsoft.EntityFrameworkCore" />
Niejawne przywracanie
Nie trzeba uruchamiaćdotnet restore, ponieważ jest ona uruchamiana niejawnie przez wszystkie polecenia, które wymagają przywrócenia, takie jak dotnet new, , dotnet build, dotnet rundotnet test, , dotnet publish, i dotnet pack. Aby wyłączyć niejawne przywracanie, użyj --no-restore opcji .
Polecenie dotnet restore jest nadal przydatne w niektórych scenariuszach, w których jawne przywracanie ma sens, takie jak kompilacje ciągłej integracji w usługach Azure DevOps Services lub w systemach kompilacji, które muszą jawnie kontrolować, kiedy nastąpi przywracanie.
Aby uzyskać informacje na temat zarządzania kanałami informacyjnymi NuGet, zobacz dokumentacjędotnet restore.
Argumenty
PROJECTOkreśla plik projektu. Jeśli nie zostanie określony, polecenie przeszukuje bieżący katalog dla jednego.
PACKAGE_NAMEOdwołanie do pakietu do dodania.
Opcje
-f|--framework <FRAMEWORK>Dodaje odwołanie do pakietu tylko wtedy, gdy jest przeznaczona dla określonej platformy.
-?|-h|--helpWyświetla opis sposobu używania polecenia .
--interactiveUmożliwia zatrzymanie polecenia i oczekiwanie na wprowadzenie lub działanie użytkownika. Na przykład w celu ukończenia uwierzytelniania.
-n|--no-restoreDodaje odwołanie do pakietu bez przeprowadzania podglądu przywracania i sprawdzania zgodności.
--package-directory <PACKAGE_DIRECTORY>Katalog, w którym można przywrócić pakiety. Domyślna lokalizacja przywracania pakietu znajduje się
%userprofile%\.nuget\packagesw systemach Windows i~/.nuget/packagesmacOS i Linux. Aby uzyskać więcej informacji, zobacz Zarządzanie globalnymi pakietami, pamięcią podręczną i folderami tymczasowymi w programie NuGet.--prereleaseUmożliwia zainstalowanie pakietów wstępnych. Dostępne od zestawu .NET Core 5 SDK
-s|--source <SOURCE>Identyfikator URI źródła pakietu NuGet do użycia podczas operacji przywracania.
-v|--version <VERSION>Wersja pakietu. Zobacz Przechowywanie wersji pakietów NuGet.
Przykłady
Dodaj
Microsoft.EntityFrameworkCorepakiet NuGet do projektu:dotnet add package Microsoft.EntityFrameworkCoreDodaj określoną wersję pakietu do projektu:
dotnet add ToDo.csproj package Microsoft.Azure.DocumentDB.Core -v 1.0.0Dodaj pakiet przy użyciu określonego źródła NuGet:
dotnet add package Microsoft.AspNetCore.StaticFiles -s https://dotnet.myget.org/F/dotnet-core/api/v3/index.json
