# Publikowanie pakietu

### Publikowanie pakietu <a href="#publish-a-package" id="publish-a-package"></a>

Pakiety to wygodny sposób przechowywania węzłów i udostępniania ich społeczności dodatku Dynamo. Pakiet może zawierać wszystko, od węzłów niestandardowych utworzonych w obszarze roboczym dodatku Dynamo po węzły pochodne od klasy NodeModel. Pakiety publikuje się i instaluje za pomocą Menedżera pakietów. Oprócz tej strony, także przewodnik [Primer](https://primer2.dynamobim.org/v/pl/6_custom_nodes_and_packages/6-2_packages/1-introduction) zawiera ogólne wskazówki dotyczące pakietów.

#### Czym jest Menedżer pakietów? <a href="#what-is-a-package-manager" id="what-is-a-package-manager"></a>

Menedżer pakietów dodatku Dynamo to rejestr oprogramowania (podobny do programu npm), do którego można uzyskać dostęp z poziomu dodatku Dynamo lub w przeglądarce internetowej. Menedżer pakietów umożliwia instalowanie, publikowanie, aktualizowanie i przeglądanie pakietów. Podobnie jak w przypadku programu npm, obsługuje on różne wersje pakietów. Pomaga również w zarządzaniu zależnościami projektu.

W przeglądarce wyszukaj pakiety i wyświetl statystyki: [https://dynamopackages.com/](https://dynamopackages.com)

* W dodatku Dynamo Menedżer pakietów umożliwia instalowanie, publikowanie i aktualizowanie pakietów.

> 1. Wyszukaj pakiety online: `Packages > Search for a Package...`
> 2. Wyświetl/edytuj zainstalowane pakiety: `Packages > Manage Packages...`
> 3. Opublikuj nowy pakiet: `Packages > Publish New Package...`

#### Publikowanie pakietu <a href="#publishing-a-package" id="publishing-a-package"></a>

Pakiety publikuje się z poziomu Menedżera pakietów w dodatku Dynamo. Zalecanym procesem jest opublikowanie pakietu lokalnie, przetestowanie go, a następnie opublikowanie go online w celu udostępnienia go społeczności. Korzystając z analizy przypadku NodeModel, wykonamy czynności niezbędne do opublikowania węzła RectangularGrid jako pakietu lokalnie, a następnie w trybie online.

Uruchom dodatek Dynamo i wybierz opcję `Packages > Publish New Package...`, aby otworzyć okno `Publish a Package`.

> 1. Wybierz opcję `Add file...`, aby wyszukać pliki, które mają zostać dodane do pakietu
> 2. Wybierz dwa pliki `.dll` z analizy przypadku NodeModel
> 3. Wybierz przycisk `Ok`

Po dodaniu plików do zawartości pakietu nadaj pakietowi nazwę oraz dodaj do niego opis i wersję. Opublikowanie pakietu przy użyciu dodatku Dynamo powoduje automatyczne utworzenie pliku `pkg.json`.

> Pakiet gotowy do opublikowania.
>
> 1. Podaj wymagane informacje dotyczące nazwy, opisu i wersji.
> 2. Opublikuj, klikając opcję „Opublikuj lokalnie” i wybierając folder pakietu dodatku Dynamo: `AppData\Roaming\Dynamo\Dynamo Core\1.3\packages`, aby węzeł był dostępny w składniku Core. Dopóki pakiet nie będzie gotowy do udostępnienia, zawsze publikuj lokalnie.

Po opublikowaniu pakietu węzły będą dostępne w bibliotece dodatku Dynamo w kategorii `CustomNodeModel`.

> 1. Właśnie utworzony pakiet w bibliotece dodatku Dynamo

Gdy pakiet będzie gotowy do opublikowania w trybie online, otwórz Menedżera pakietów i wybierz opcję `Publish`, a następnie opcję `Publish Online`.

> 1. Aby sprawdzić, jak dodatek Dynamo sformatował pakiet, kliknij pionowy trzykropek po prawej stronie pozycji „CustomNodeModel” i wybierz opcję „Pokaż katalog główny”.
> 2. Wybierz opcję `Publish`, a następnie opcję `Publish Online` w oknie „Publikowanie pakietów Dynamo”.
> 3. Aby usunąć pakiet, wybierz opcję `Delete`.

#### Jak mogę zaktualizować pakiet? <a href="#how-do-i-update-a-package" id="how-do-i-update-a-package"></a>

Aktualizowanie pakietu jest procesem podobnym do publikowania. Otwórz Menedżera pakietów i wybierz opcję `Publish Version...` dla pakietu wymagającego aktualizacji, a następnie wprowadź nowszą wersję.

> 1. Wybierz opcję `Publish Version`, aby zaktualizować istniejący pakiet o nowe pliki w katalogu głównym, a następnie określ, czy ma on zostać opublikowany lokalnie, czy online.

#### Klient internetowy Menedżera pakietów <a href="#package-manager-web-client" id="package-manager-web-client"></a>

Klient internetowy Menadżera pakietów umożliwia użytkownikom wyszukiwanie i wyświetlanie danych pakietów, w tym przechowywania wersji, statystyk pobierania i innych istotnych informacji. Ponadto autorzy pakietów mogą się logować, aby aktualizować szczegóły pakietu, takie jak informacje o zgodności, bezpośrednio za pomocą klienta internetowego.

Aby uzyskać więcej informacji na temat tych funkcji, zobacz wpis w blogu tutaj: <https://dynamobim.org/discover-the-new-dynamo-package-management-experience/>.

Dostęp do klienta internetowego Menedżera pakietów można uzyskać za pomocą tego linku: [https://dynamopackages.com/](https://dynamopackages.com)

**Aktualizowanie szczegółów pakietu**

Autorzy mogą edytować opis pakietu, link do witryny internetowej i link do repozytorium, wykonując następujące kroki:

> 1. W obszarze **Moje pakiety** wybierz pakiet i kliknij opcję **Edytuj szczegóły pakietu**.
> 2. Dodaj lub zmodyfikuj łącza **Witryna** i **Repozytorium** przy użyciu odpowiednich pól.
> 3. Zaktualizuj pole **Opis pakietu** zgodnie z potrzebami.
> 4. Kliknij przycisk **Zapisz zmiany**, aby zastosować aktualizacje.

**Uwaga**: odświeżenie w celu uwzględnienia aktualizacji w Menedżerze pakietów w dodatku Dynamo może potrwać do 15 minut, ponieważ zastosowanie aktualizacji serwera może zająć trochę czasu. Podejmowane są działania mające na celu zmniejszenie tego opóźnienia.

**Edytowanie informacji o zgodności dotyczących opublikowanych wersji pakietu**

Informacje o zgodności można aktualizować wstecz dla opublikowanych wcześniej wersji pakietów. Wykonaj następujące czynności:

**Krok 1:**

1. Kliknij wersję pakietu, którą chcesz zaktualizować.
2. Lista **Zależy od** zostanie automatycznie wypełniona pakietami, od których zależy pakiet.
3. Kliknij ikonę ołówka obok pozycji **Zgodność**, aby otworzyć proces **Edycja informacji o zgodności**.

**Krok 2:**

Postępuj zgodnie z poniższym schematem blokowym i zapoznaj się z poniższą tabelą, aby zrozumieć, która opcja najlepiej pasuje do Twojego pakietu.

Przeanalizujmy kilka przykładów, aby omówić niektóre scenariusze:

**Pakiet przykładowy nr 1** — Civil Connection: ten pakiet ma zależności interfejsu API dotyczące zarówno programu Revit, jak i programu Civil 3D. Ponadto nie zawiera kolekcji węzłów podstawowych (np. funkcji geometrii, funkcji matematycznych ani zarządzania listami). Tak więc w tym przypadku idealnym rozwiązaniem byłoby skorzystanie z opcji 1. Pakiet będzie wyświetlany jako zgodny w programach Revit i Civil 3D zgodnych z zakresem wersji i/lub listą poszczególnych wersji.

**Pakiet przykładowy nr 2** — Rhythm: ten pakiet to kolekcja węzłów charakterystycznych dla programu Revit wraz z kolekcją węzłów podstawowych. W tym przypadku pakiet ma zależności od oprogramowania nadrzędnego. Ale zawiera również węzły podstawowe, które będą działać w dodatku Dynamo Core. Tak więc w tym przypadku idealnym rozwiązaniem byłaby opcja 2. Pakiet będzie wyświetlany jako zgodny w programie Revit i dodatku Dynamo Core (nazywanym również Dynamo Sandbox), które są zgodne z zakresem wersji i/lub listą poszczególnych wersji.

**Pakiet przykładowy nr 3** — Mesh Toolkit: ten pakiet jest pakietem Dynamo Core stanowiącym kolekcję węzłów geometrii, która nie ma zależności od oprogramowania nadrzędnego. Tak więc w tym przypadku idealnym rozwiązaniem byłaby opcja 3. Pakiet będzie wyświetlany jako zgodny w dodatku Dynamo i wszystkich środowiskach nadrzędnych zgodnych z zakresem wersji i/lub listą poszczególnych wersji.

W zależności od wybranej opcji zostaną wyświetlone pola specyficzne dla dodatku Dynamo i/lub programu nadrzędnego, jak pokazano na poniższej ilustracji.