Zabalení knihovny tříd Razor
- 3 min
Úkolem, který často potřebujete provést, je balení 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 chcete 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 jsou 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, aby cestovaly společně s knihovnou. Po aktualizaci knihovny se pak vlastnosti odpovídajícím způsobem aktualizují.
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 |
|---|---|---|
| Identifikátor balíčku | 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 jako v následujícím příkladu:
<PropertyGroup>
<PackageId>Learn.MyFirstLibrary</PackageId>
<Version>0.1.0-alpha1</Version>
<Authors>Susan Developer, Terry Programmer</Authors>
<Company>AdventureWorks</Company>
</PropertyGroup>
Když projekt vytváříte, můžete ho také nakonfigurovat tak, aby vygeneroval balíček NuGet tak, že v dialogovém okně Vlastnosti projektu sady Visual Studio vyberete možnost Generovat balíček NuGet při sestavení nebo přidáte GeneratePackageOnBuild položku 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 zápisu konfigurace knihovny do souboru *.csproj můžete vygenerovat balíček NuGet buď v sadě Visual Studio, kliknutím pravým tlačítkem myši na projekt a výběrem příkazu 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.