Przepływ pracy użycia pakietu

  • Artykuł

Między nuget.org a prywatnymi galeriami pakietów, które organizacja może ustanowić, można znaleźć dziesiątki tysięcy wysoce przydatnych pakietów do użycia w aplikacjach i usługach. Jednak niezależnie od źródła korzystanie z pakietu jest zgodne z tym samym ogólnym przepływem pracy.

Flow of going to a package source, finding a package, installing it in a project, then adding a using statement and calls to the package API

* Visual Studio i dotnet.exe tylko. Polecenie nuget install nie modyfikuje plików projektu ani packages.config pliku; wpisy muszą być zarządzane ręcznie.

Aby uzyskać więcej informacji, zobacz Znajdowanie i wybieranie pakietów oraz Co się stanie po zainstalowaniu pakietu?

NuGet zapamiętuje tożsamość i numer wersji każdego zainstalowanego pakietu, rejestrując go w pliku projektu (przy użyciu funkcji PackageReference) lub packages.config, w zależności od typu projektu i wersji NuGet. W przypadku NuGet wersji 4.0 lub nowszej preferowana jest funkcja PackageReference, chociaż można to skonfigurować w Visual Studio za pośrednictwem interfejsu użytkownika Menedżer pakietów. W każdym razie możesz zajrzeć do odpowiedniego pliku w dowolnym momencie, aby wyświetlić pełną listę zależności dla projektu.

Porada

Rozsądne jest, aby zawsze sprawdzać licencję dla każdego pakietu, którego zamierzasz używać w oprogramowaniu. Na nuget.org znajduje się link Informacje o licencji po prawej stronie opisu każdego pakietu. Jeśli pakiet nie określa postanowień licencyjnych, skontaktuj się z właścicielem pakietu bezpośrednio przy użyciu linku Skontaktuj się z właścicielami kontaktów na stronie pakietu. Firma Microsoft nie udziela użytkownikowi licencji na własność intelektualną od dostawców pakietów innych firm i nie ponosi odpowiedzialności za informacje udostępniane przez osoby trzecie.

Podczas instalowania pakietów NuGet zwykle sprawdza, czy pakiet jest już dostępny z pamięci podręcznej. Możesz ręcznie wyczyścić tę pamięć podręczną z wiersza polecenia zgodnie z opisem w temacie Zarządzanie globalnymi pakietami i folderami pamięci podręcznej.

NuGet upewnij się również, że platformy docelowe obsługiwane przez pakiet są zgodne z projektem. Jeśli pakiet nie zawiera zgodnych zestawów, NuGet wyświetla błąd. Zobacz Rozwiązywanie błędów niezgodnych pakietów.

Podczas dodawania kodu projektu do repozytorium źródłowego zwykle nie są uwzględniane pakiety NuGet. Osoby, które później sklonują repozytorium lub w inny sposób uzyskają projekt, w tym agentów kompilacji w systemach, takich jak Visual Studio Team Services, muszą przywrócić niezbędne pakiety przed uruchomieniem kompilacji:

Flow of restoring NuGet packages by cloning a repository and using either a restore command

Funkcja przywracania pakietów używa informacji w pliku projektu lub packages.config ponownej instalacji wszystkich zależności. Należy pamiętać, że istnieją różnice w procesie, które są związane, zgodnie z opisem w temacie Rozwiązywanie zależności. Ponadto powyższy diagram nie pokazuje polecenia przywracania dla konsoli Menedżer pakietów, ponieważ jeśli używasz konsoli, jesteś już w kontekście Visual Studio, który zazwyczaj automatycznie przywraca pakiety i udostępnia polecenie na poziomie rozwiązania, jak pokazano.

Czasami konieczne jest ponowne zainstalowanie pakietów, które są już zawarte w projekcie, co może również spowodować ponowne zainstalowanie zależności. Można to łatwo zrobić za pomocą nuget reinstall polecenia lub konsoli NuGet Menedżer pakietów. Aby uzyskać szczegółowe informacje, zobacz Ponowne instalowanie i aktualizowanie pakietów.

Na koniec zachowanie NuGet jest sterowane przez NuGet.Config pliki. Wiele plików może służyć do scentralizowanego niektórych ustawień na różnych poziomach, jak wyjaśniono w temacie Konfigurowanie zachowania NuGet.

Sposoby instalowania pakietu NuGet

NuGet pakiety są pobierane i instalowane przy użyciu dowolnej z metod w poniższej tabeli.

Narzędzie Platformy Opis
Interfejs wiersza polecenia dotnet Wszystko Narzędzie interfejsu wiersza polecenia dla bibliotek .NET Core i .NET Standard oraz dla projektów w stylu zestawu SDK przeznaczonych dla .NET Framework (zobacz atrybut zestawu SDK). Pobiera pakiet zidentyfikowany przez <package_name> i dodaje odwołanie do pliku projektu. Pobiera również i instaluje zależności.
Visual Studio Windows i Mac Udostępnia interfejs użytkownika, za pomocą którego można przeglądać, wybierać i instalować pakiety oraz ich zależności w projekcie z określonego źródła pakietu. Dodaje odwołania do zainstalowanych pakietów do pliku projektu.
Konsola menedżera pakietów (Visual Studio) Tylko Windows Pobiera i instaluje pakiet zidentyfikowany przez <package_name> z wybranego źródła do określonego projektu w rozwiązaniu, a następnie dodaje odwołanie do pliku projektu. Pobiera również i instaluje zależności.
Interfejs wiersza polecenia nuget.exe Wszystko Narzędzie interfejsu wiersza polecenia dla bibliotek .NET Framework i projektów innych niż zestaw SDK przeznaczonych dla bibliotek platformy .NET Standard. Pobiera pakiet zidentyfikowany przez <package_name> i rozwija jego zawartość do folderu w bieżącym katalogu; może również pobrać wszystkie pakiety wymienione w packages.config pliku. Pobiera również i instaluje zależności, ale nie wprowadza żadnych zmian w plikach projektu ani packages.config.