# Publikování balíčku ### Publikování balíčku Balíčky představují pohodlný způsob ukládání a sdílení uzlů s komunitou aplikace Dynamo. Balíček může obsahovat vše od vlastních uzlů vytvořených v pracovním prostoru aplikace Dynamo po uzly odvozené z uzlů NodeModel. Balíčky jsou publikovány a nainstalovány pomocí nástroje Package Manager. Kromě této stránky naleznete v příručce [Primer](https://primer2.dynamobim.org/v/cs/6_custom_nodes_and_packages/6-2_packages/1-introduction) také obecné pokyny k balíčkům. #### Co je nástroj Package Manager? Nástroj Dynamo Package Manager je softwarový registr (podobně jako nástroj npm), který je přístupný z aplikace Dynamo nebo z webového prohlížeče. Nástroj Package Manager umožňuje instalaci, publikování, aktualizaci a prohlížení balíčků. Stejně jako nástroj npm uchovává různé verze balíčků. Pomáhá také spravovat závislosti projektu. V prohlížeči si můžete vyhledat balíčky a zobrazit statistiku: [https://dynamopackages.com/](https://dynamopackages.com) * Nástroj Package Manager v aplikaci Dynamo umožňuje instalaci, publikování a aktualizaci balíčků. > 1. Vyhledejte balíčky online: `Packages > Search for a Package...` > 2. Zobrazte nebo upravte nainstalované balíčky: `Packages > Manage Packages...` > 3. Publikujte nový balíček: `Packages > Publish New Package...` #### Publikování balíčku Balíčky jsou publikovány pomocí nástroje Package Manager v aplikaci Dynamo. Doporučeným postupem je publikovat balíček místně, otestovat jej a poté jej publikovat online a sdílet s komunitou. Pomocí případové studie uzlu NodeModel si ukážeme kroky potřebné k publikování uzlu RectangularGrid jako balíčku místně a poté online. Spusťte aplikaci Dynamo a výběrem možnosti `Packages > Publish New Package...` otevřete okno `Publish a Package`. > 1. Vyberte `Add file...` a vyhledejte soubory, které chcete přidat do balíčku. > 2. Vyberte dva soubory `.dll` z případové studie uzlu NodeModel. > 3. Klikněte na tlačítko `Ok`. Po přidání souborů do obsahu balíčku zadejte název, popis a verzi balíčku. Publikováním balíčku pomocí aplikace Dynamo se automaticky vytvoří soubor `pkg.json`. > Balíček připravený k publikování. > > 1. Zadejte požadované informace: název, popis a verzi. > 2. Publikujte kliknutím na tlačítko Publikovat místně a vyberte složku balíčku aplikace Dynamo `AppData\Roaming\Dynamo\Dynamo Core\1.3\packages`, aby byl uzel dostupný v infrastruktuře Core. Vždy publikujte místně, dokud nebude balíček připraven ke sdílení. Po publikování balíčku budou uzly dostupné v knihovně aplikace Dynamo v kategorii `CustomNodeModel`. > 1. Právě vytvořený balíček v knihovně aplikace Dynamo Když je balíček připraven k publikování online, otevřete nástroj Package Manager a vyberte možnost `Publish` a poté `Publish Online`. > 1. Chcete-li se podívat, jak aplikace Dynamo naformátovala balíček, klikněte na tři svislé tečky vpravo od položky CustomNodeModel a vyberte možnost Zobrazit kořenový adresář. > 2. V okně Publikovat balíček aplikace Dynamo vyberte možnost `Publish` a poté `Publish Online`. > 3. Chcete-li balíček odstranit, vyberte možnost `Delete`. #### Jak lze balíček aktualizovat? Aktualizace balíčku probíhá podobně jako publikování. Otevřete nástroj Package Manager, vyberte položku `Publish Version...` u balíčku, který je třeba aktualizovat, a zadejte vyšší verzi. > 1. Výběrem možnosti `Publish Version` aktualizujte existující balíček novými soubory v kořenovém adresáři a poté vyberte, zda má být balíček publikován místně nebo online. #### Webový klient Package Manager Webový klient Package Manager umožňuje uživatelům vyhledávat a prohlížet data balíčku, včetně správy verzí, statistik stahování a dalších relevantních informací. Kromě toho se autoři balíčků mohou přihlásit a aktualizovat podrobnosti o svých balíčcích, například informace o kompatibilitě, přímo prostřednictvím webového klienta. Další informace o těchto funkcích najdete v blogovém příspěvku na následujícím odkazu: . K webovému klientu Package Manager lze získat přístup pomocí tohoto odkazu: [https://dynamopackages.com/](https://dynamopackages.com) **Aktualizace podrobností balíčku** Autoři mohou upravit popis balíčku, odkaz na web a odkaz na úložiště pomocí následujících kroků: > 1. V části **Moje balíčky** vyberte balíček a klikněte na možnost **Upravit podrobnosti balíčku**. > 2. Pomocí příslušných polí přidejte nebo upravte odkazy na **webové stránky** a **úložiště**. > 3. Podle potřeby aktualizujte **popis balíčku**. > 4. Kliknutím na tlačítko **Uložit změny** aktualizace použijte. **Poznámka**: Aktualizace v nástroji Package Manager v aplikaci Dynamo mohou trvat až 15 minut, protože aktualizace serveru nějakou dobu trvají. Snažíme se toto zpoždění zkrátit. **Úprava informací o kompatibilitě publikovaných verzí balíčků** Informace o kompatibilitě lze zpětně aktualizovat pro dříve publikované verze balíčků. Postupujte podle následujících kroků: **Krok 1:** 1. Klikněte na verzi balíčku, kterou chcete aktualizovat. 2. Seznam **Závisí na** bude automaticky vyplněn balíčky, na kterých váš balíček závisí. 3. Kliknutím na ikonu tužky vedle položky **Kompatibilita** otevřete okno pracovního postupu **Upravit informace o kompatibilitě**. **Krok 2:** Postupujte podle níže uvedeného vývojového diagramu a podívejte se na tabulku níže, jež vám pomůže pochopit, která možnost je pro váš balíček nejvhodnější. Projděme si na příkladech několik scénářů: **Příklad balíčku č. 1** – Civil Connection: Tento balíček obsahuje závislosti rozhraní API pro aplikace Revit i Civil 3D a neobsahuje kolekci základních uzlů (např. geometrické funkce, matematické funkce nebo správu seznamů). V tomto případě by tedy bylo ideální zvolit možnost 1. Balíček se zobrazí jako kompatibilní v aplikacích Revit a Civil 3D, které odpovídají rozsahu verzí nebo seznamu jednotlivých verzí. **Příklad balíčku č. 2** – Rhythm: Tento balíček obsahuje kolekci uzlů specifických pro aplikaci Revit a kolekci základních uzlů. V tomto případě má balíček závislosti hostitele. Obsahuje ale také základní uzly, které budou fungovat v komponentě Dynamo Core. V tomto případě by tedy bylo ideální zvolit možnost 2. Balíček se zobrazí jako kompatibilní v aplikaci Revit a prostředí Dynamo Core (označovaném také jako Dynamo Sandbox), které odpovídají rozsahu verzí nebo seznamu jednotlivých verzí. **Příklad balíčku č. 3** – Mesh Toolkit: Tento balíček je balíček Dynamo Core, což je kolekce uzlů geometrie, která nemá žádné závislosti na hostiteli. V tomto případě by tedy bylo ideální zvolit možnost 3. Balíček se zobrazí jako kompatibilní v aplikaci Dynamo a ve všech hostitelských prostředích, které odpovídají rozsahu verzí nebo seznamu jednotlivých verzí. V závislosti na vybrané možnosti se zobrazí pole specifická pro aplikaci Dynamo a/nebo hostitele, jak je znázorněno na obrázku níže.