Zabalení knihovny tříd Razor
Úkolem, který budete často provádět, je vytváření balíčků knihoven pro opakované použití jinými vývojáři. Balení NuGet usnadňuje každému vývojáři kdekoli získat a správně nakonfigurovat všechny odkazy na .NET pro své aplikace.
V předchozí lekci jste vytvořili modální dialogovou komponentu a použili ji ve vlastní aplikaci. Teď ho budete chtít znovu použít v jiných aplikacích.
V této lekci se naučíte kroky potřebné ke konfiguraci knihovny tříd Razor jako balíčku NuGet. Dozvíte se také, jak zabalit knihovnu pro distribuci pomocí služby úložiště balíčků, jako je NuGet.org nebo úložiště GitHub.
Konfigurace knihovny tříd Razor pro balíčkování NuGet
Ekosystém .NET usnadňuje definování vlastností, které jsou nezbytné pro ostatní vývojáře k identifikaci a používání komponent. Všechny tyto vlastnosti můžete definovat v souboru projektu (*.csproj) knihovny tříd Razor tak, aby putovali s knihovnou a aktualizovali se odpovídajícím způsobem při aktualizaci knihovny.
Můžete nakonfigurovat pole, která identifikují váš balíček v dialogovém okně vlastností projektu sady Visual Studio – balíčku, nebo můžete položky vytvářet přímo v souboru *.csproj sami.
Čtyři pole potřebná k vytvoření balíčku:
| Pole | Popis | Výchozí hodnota |
|---|---|---|
| PackageId | Identifikátor balíčku, jedinečný v celém úložišti NuGet. |
AssemblyName knihovny |
| Verze | Konkrétní číslo verze ve formuláři Major.Minor.Patch[-Suffix], kde -Suffix volitelně definuje předběžné verze. | 1.0.0 |
| Autoři | Autoři balíčku. | AssemblyName |
| Společnost | Název společnosti, která zodpovídá za vytvoření a publikování balíčku. | AssemblyName |
Některá z těchto polí mají výchozí hodnoty a může vypadat legrační publikovat balíček s názvem společnosti MyFirstLibrary. Důrazně doporučujeme explicitně definovat tyto hodnoty.
V předchozí lekci jste se dozvěděli, že statický obsah knihovny tříd Razor je k dispozici v _content/[PACKAGE_ID]/a teď vidíte, kde je nakonfigurovaná hodnota PackageId.
Ukázkový soubor projektu s těmito nakonfigurovanými hodnotami může vypadat takto:
<PropertyGroup>
<PackageId>Learn.MyFirstLibrary</PackageId>
<Version>0.1.0-alpha1</Version>
<Authors>Susan Developer, Terry Programmer</Authors>
<Company>AdventureWorks</Company>
</PropertyGroup>
Při vytváření projektu ho můžete také nakonfigurovat tak, aby vygeneroval balíček NuGet tak, že vyberete možnost Generovat balíček NuGet v sestavení v dialogovém okně Vlastnosti projektu visual Studio nebo přidáním položky GeneratePackageOnBuild vedle dalších polí balíčku, jak je znázorněno tady:
<GeneratePackageOnBuild>True</GeneratePackageOnBuild>
Můžete nakonfigurovat mnoho volitelných vlastností projektu, včetně:
-
Description, která je vhodná pro zobrazení v úložišti NuGet - Oznámení o autorských právech
- Informace o licencování
- Ikony
- Adresy URL projektu
Úplný seznam vlastností najdete v dokumentaci Microsoftu v cílovém balíčku MSBuild.
Zabalit knihovnu
Po napsání konfigurace knihovny do souboru *.csproj můžete balíček NuGet vygenerovat buď v sadě Visual Studio, tak, že kliknete pravým tlačítkem na projekt a vyberete příkaz Pack nebo ve složce projektu spuštěním následujícího příkazu:
dotnet pack
Tento příkaz dotnet pack vygeneruje balíček s id balíčku a číslem verze a umístí ho do standardní výstupní složky sestavení projektu.