Std AddonMgr/pl

Opis
Polecenie Std: AddonMgr otwiera Menadżer dodatków. Za jego pomocą możesz zainstalować i zarządzać Zewnętrznymi Środowiskami pracy oraz makropoleceniami dostarczonymi przez społeczność FreeCAD. Dostępne Środowiska pracy i makra są pobierane z dwóch repozytoriów, FreeCAD-addons i FreeCAD-macros, oraz ze strony Przepisy na makropolecenia.

Dodatki oznaczone nie będą działać we FreeCAD w wersji 0.19 lub nowszej.

Z powodu zmian na platformie GitHub w roku 2020 menedżer dodatków nie działa już, jeśli używasz FreeCAD w wersji 0.17 lub starszej. Musisz zaktualizować program do wersji 0.18.5 lub nowszej 0.19. Alternatywnie możesz zainstalować dodatki ręcznie, zobacz uwagi poniżej.



Użycie

 * 1) Wybierz opcję z menu.
 * 2) Jeśli używasz menedżera dodatków po raz pierwszy, zostanie otwarte okienko informacyjne z ostrzeżeniem, że rozszerzenia w menedżerze dodatków nie są oficjalnie częścią programu FreeCAD. Naciśnij przycisk, aby potwierdzić zapoznanie się z tą informacją i kontynuować.
 * 3) Otworzy się okno dialogowe Menadżer Dodatków. Więcej informacji znajdziesz w rozdziale  Opcje.
 * 4) Przycisk  nie działa w tym momencie.
 * 5) Naciśnij przycisk , aby zamknąć okienko dialogowe.
 * 6) Jeżeli zainstalowałeś lub zaktualizowałeś Środowisko pracy, otworzy się nowe okno dialogowe informujące o konieczności ponownego uruchomienia programu FreeCAD, aby wprowadzone zmiany zaczęły funkcjonować.

Opcje
Okno dialogowe Menadżer dodatków ma dwie zakładki po lewej stronie, jedna z nich zawiera listę dostępnych Środowisk pracy, a druga listę dostępnych makr. W panelu informacyjnym po prawej stronie zostanie wyświetlona strona główna wybranego dodatku.

Odinstalowanie

 * 1) Wybierz zainstalowany dodatek w zakładce [[Image:Folder.svg|16px]] Środowiska pracy lub [[Image:Applications-python.svg|16px]] Makrodefinicje.
 * 2) Naciśnij przycisk.

Instalacja / aktualizacja

 * 1) Wybierz dodatek w zakładce [[Image:Folder.svg|16px]] Środowiska pracy lub [[Image:Applications-python.svg|16px]] Makrodefinicje.
 * 2) Wciśnij przycisk.
 * 3) Jeśli chcesz dodać makropolecenie do niestandardowego paska narzędzi, nie zapomnij samodzielnie pobrać pliku z obrazem ikony, jeśli jest dostępny, klikając odnośnik na stronie głównej w panelu informacyjnym. Patrz Dostosowanie interfejsu.
 * 4) Aby zmienić położenie dodatkowego Środowiska pracy na liście Wybór środowiska pracy można zapoznać się z informacjami w dokumencie Dostosowanie interfejsu.

Konfiguracja

 * 1) Wciśnij przycisk
 * 2) Zostanie otworzone okienko dialogowe Menadżera dodatków.
 * 3) Opcjonalnie zaznacz pole wyboru.
 * 4) Opcjonalnie dodaj repozytoria do listy Repozytoria użytkownika. Dodatki z tych repozytoriów zostaną dodane na liście w zakładce [[Image:Folder.svg|16px]] Środowiska pracy lub [[Image:Applications-python.svg|16px]] Makrodefinicje.
 * 5) Opcjonalnie wybierz ustawienia proxy.
 * 6) Wciśnij przycisk  lub  aby zamknąć okno dialogowe.

Uwagi

 * Korzystanie z dodatków nie jest ograniczone do wersji FreeCAD, w której zostały zainstalowane. Będziesz mógł również używać ich w każdej innej wersji programu, obsługiwanej przez dodatek, która może być zainstalowana w Twoim systemie.
 * Dodatki dostępne w menedżerze dodatków nie są częścią oficjalnego programu FreeCAD i nie są wspierane przez główny zespół programistów FreeCAD. Powinieneś uważnie przeczytać zamieszczone informacje, aby upewnić się, że wiesz, co instalujesz.
 * Zgłoszenia błędów i prośby o funkcje powinny być kierowane bezpośrednio do twórcy dodatku poprzez odwiedzenie wskazanej strony internetowej. Wielu twórców dodatków jest stałymi użytkownikami forum FreeCAD i można się z nimi również tam kontaktować.
 * Jeśli pakiet GitPython jest zainstalowany na Twoim komputerze, menedżer dodatków będzie z niego korzystał, dzięki czemu pobieranie będzie szybsze.
 * Możesz również zainstalować dodatki ręcznie. Zobacz artykuł Jak zainstalować dodatkowe Środowiska pracy oraz Jak zainstalować makrodefinicje.

Informacja dla programistów
Jeśli opracowałeś Środowisko pracy lub makrodefinicję i chcesz zobaczyć je w Menedżerze dodatków, przeczytaj jak to zrobić na stronach repozytorium: (FreeCAD-addons i FreeCAD-macros). Jeśli dodasz swoje makro do strony Przepisy na makropolecenia, nie będziesz miał już nic innego do zrobienia, zostanie ono automatycznie przechwycone przez Menadżer dodatków.

Python i środowiska pracy
Dla pakietów Pythona, nie potrzebujesz żadnej szczególnej zgody, aby Twój pakiet został dodany do Menedżera dodatków. Ponadto, ponieważ Twój dodatek jest poza kodem źródłowym FreeCAD, możesz wybrać licencję, jaką chcesz. Jeśli poprosisz o dodanie twojego środowiska pracy do domyślnej listy Menedżera Dodatków (nie dodamy żadnego nowego środowiska pracy bez prośby jego autorów), albo poprzez zapytanie na forum, albo poprzez otwarcie problemu na repozytorium FreeCAD-addons, twój kod pozostanie na twoim własnym repozytorium git, my tylko dodamy go jako submoduł do repozytorium FreeCAD-addons. Oczywiście, przed dodaniem twojego środowiska pracy, przyjrzymy się mu i upewnimy się, że nie ma w nim nic potencjalnie problematycznego. Więcej szczegółów na temat struktury Twojego dodatku, w tym informacje o metadanych używanych przez Menedżera Dodatków, znajdziesz na stronie Tworzenie Środowiska pracy.

C++ i środowiska pracy
Jeśli tworzysz własne środowisko pracy w C++, nie może ono być uruchamiane bezpośrednio przez użytkowników i musi być najpierw skompilowane. Masz wtedy dwie opcje, albo sam dostarczysz prekompilowane wersje swojego Środowiska pracy, dla różnych systemów operacyjnych, albo powinieneś poprosić o połączenie swojego kodu z kodem źródłowym FreeCAD. W tym celu należy skorzystać z licencji LGPL (lub w pełni kompatybilnej licencji jak MIT lub BSD), a nowe narzędzia należy przedstawić społeczności na forum FreeCAD do wglądu. Po przetestowaniu i zatwierdzeniu kodu, powinieneś rozwidlić repozytorium FreeCAD, jeśli jeszcze tego nie zrobiłeś, stworzyć nową gałąź, wcisnąć do niej swój kod i otworzyć polecenie "pull", aby Twoja gałąź została połączona z głównym repozytorium.