title | description | author | ms.author | ms.date | ms.topic | ms.openlocfilehash | ms.sourcegitcommit | ms.translationtype | ms.contentlocale | ms.lasthandoff | ms.locfileid |
---|---|---|---|---|---|---|---|---|---|---|---|
Přehled a pracovní postup použití balíčků NuGet |
Přehled procesu využívání balíčků NuGet v projektu s odkazy na jiné konkrétní části procesu. |
JonDouglas |
jodou |
03/22/2018 |
conceptual |
d1d6df3bcc36d8a78fcee97099b301c9ffc440d9 |
f3d98c23408a4a1c01ea92fc45493fa7bd97c3ee |
MT |
cs-CZ |
06/17/2021 |
112323632 |
Mezi nuget.org a soukromými balíčky, které může vaše organizace navázat, najdete desítky tisíců vysoce užitečných balíčků, které můžete použít ve svých aplikacích a službách. Ale bez ohledu na zdroj, spotřeba balíčku se řídí stejným obecným pracovním postupem.
*Pouze Visual Studio a dotnet.exe
. nuget install
Příkaz neupraví soubory projektu ani packages.config
soubor; položky musí být spravovány ručně.
Další podrobnosti najdete v tématu vyhledání a výběr balíčků a co se stane, když se balíček nainstaluje?.
NuGet si pamatuje identitu a číslo verze každého nainstalovaného balíčku, nahrává ho buď do souboru projektu (pomocí PackageReference), nebo v packages.config
závislosti na typu projektu a vaší verzi nugetu. S NuGet 4.0 + je PackageReference upřednostňovaný, i když se to dá nakonfigurovat v aplikaci Visual Studio prostřednictvím uživatelského rozhraní Správce balíčků. V každém případě se můžete kdykoli podívat na příslušný soubor a zobrazit úplný seznam závislostí pro váš projekt.
Tip
Je vhodné vždycky kontrolovat licenci pro každý balíček, který máte v úmyslu používat ve svém softwaru. Na nuget.org najdete odkaz licenční informace na pravé straně každé stránky s popisem balíčku. Pokud balíček neurčí licenční smlouvu, obraťte se na vlastníka balíčku přímo pomocí odkazu vlastníci kontaktu na stránce balíček. Společnost Microsoft nelicencuje žádné duševní vlastnictví od poskytovatelů balíčků třetích stran a nezodpovídá za informace poskytované třetími stranami.
Při instalaci balíčků NuGet obvykle kontroluje, jestli je balíček už dostupný z jeho mezipaměti. Tuto mezipaměť můžete ručně vymazat z příkazového řádku, jak je popsáno v tématu Správa globálních balíčků a složek mezipaměti.
NuGet také zajišťuje, aby cílové architektury podporované balíčkem byly kompatibilní s vaším projektem. Pokud balíček neobsahuje kompatibilní sestavení, NuGet zobrazí chybu. Viz řešení chyb nekompatibilních balíčků.
Při přidávání kódu projektu do zdrojového úložiště obvykle nezahrnujete balíčky NuGet. Uživatelé, kteří později naklonují úložiště nebo jinak nastavili projekt, včetně agentů sestavení v systémech, jako je Visual Studio Team Services, musí před spuštěním sestavení obnovit potřebné balíčky:
Obnovení balíčku používá informace v souboru projektu nebo packages.config
přeinstaluje všechny závislosti. Všimněte si, že v procesu je nějaký rozdíl, jak je popsáno v tématu řešení závislosti. Kromě toho diagram výše nezobrazuje příkaz Restore pro konzolu Správce balíčků, protože pokud používáte konzolu nástroje, kterou již máte v kontextu sady Visual Studio, která obvykle obnovuje balíčky automaticky a poskytuje příkaz na úrovni řešení, jak je znázorněno na obrázku.
V některých případech je potřeba přeinstalovat balíčky, které už jsou zahrnuté v projektu, což může přeinstalovat i závislosti. To je snadné pomocí nuget reinstall
příkazu nebo konzoly Správce balíčků NuGet. Podrobnosti najdete v tématu Přeinstalace a aktualizace balíčků.
Nakonec se chování NuGet řídí NuGet.Config
soubory. Více souborů lze použít k centralizaci určitých nastavení na různých úrovních, jak je vysvětleno v tématu Konfigurace chování NuGet.
Balíčky NuGet se stahují a instalují pomocí kterékoli z metod v následující tabulce.
Nástroj | Platformy | Description |
---|---|---|
dotnet CLI | Vše | Nástroj rozhraní příkazového řádku pro knihovny .NET Core a .NET Standard a pro projekty ve stylu sady SDK, které cílí na .NET Framework (viz atribut sady SDK). Načte balíček identifikovaný <package_name> a přidá odkaz na soubor projektu. Také načte a nainstaluje závislosti. |
Visual Studio | Windows a Mac | Poskytuje uživatelské rozhraní, pomocí kterého můžete procházet, vybírat a instalovat balíčky a jejich závislosti do projektu ze zadaného zdroje balíčku. Přidá odkazy na nainstalované balíčky do souboru projektu. |
Konzola Správce balíčků (Visual Studio) | Jen ve Windows | Načte a nainstaluje balíček identifikovaný <package_name> z vybraného zdroje do zadaného projektu v řešení a pak přidá odkaz na soubor projektu. Také načte a nainstaluje závislosti. |
nuget.exe CLI | Vše | Nástroj rozhraní příkazového řádku pro knihovny .NET Framework a projekty, které nejsou ve stylu sady SDK, které cílí na .NET Standard knihovny. Načte balíček identifikovaný <package_name> a rozbalí jeho obsah do složky v aktuálním adresáři. může také načíst všechny balíčky uvedené v packages.config souboru. Také načte a nainstaluje závislosti, ale neprovede žádné změny v souborech projektu nebo packages.config . |