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 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/

• 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: https://dynamobim.org/discover-the-new-dynamo-package-management-experience/.

K webovému klientu Package Manager lze získat přístup pomocí tohoto odkazu: 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.