How to install additional workbenches/pl: Difference between revisions

From FreeCAD Documentation
(Updating to match new version of source page)
No edit summary
 
(41 intermediate revisions by 2 users not shown)
Line 1: Line 1:
<languages/>
<languages/>

{{TutorialInfo/pl
{{TutorialInfo/pl
|Topic=Programowanie
|Topic=Programowanie
Line 9: Line 10:
}}
}}


==Description==
<span id="Description"></span>
==Opis==


Zaawansowani użytkownicy rozszerzyli FreeCAD o różne niestandardowe [[External_workbenches/pl|zewnętrzne środowiska]] pracy, które nie są zintegrowane z podstawowym kodem źródłowym, ale są łatwe do zainstalowania na istniejącej dystrybucji FreeCAD. Tutaj omówimy metody instalacji dla różnych systemów operacyjnych.
Power users have extended FreeCAD with various custom [[external_workbenches|external workbenches]] that are not integrated into the core source code but are easy to install on an existing FreeCAD distribution. Here we will cover the installation methods for the different operating systems.


{{Emphasis|Note:}} starting from version 0.17, FreeCAD features an [[File:AddonManager.svg|24px]] [[Std_AddonMgr|Addon Manager]] in the {{MenuCommand|ToolsAddon Manager}} menu, that allows installing both macros and workbenches. The instructions below are only required if you wish to manually install a workbench. This may be necessary if for some reason the Addon Manager doesn't work but you have access to the workbench downloaded as a {{FileName|.zip}} package.
{{Emphasis|Uwaga:}} Począwszy od wersji 0.17, FreeCAD posiada [[File:Std_AddonMgr.svg|24px]] [[Std_AddonMgr|Menadżer dodatków]] w menu {{MenuCommand|PrzyboryMenadżer dodatków}}, który umożliwia instalację zarówno makrodefinicji, jak i środowisk pracy. Poniższe instrukcje wymagane tylko wtedy, gdy chcesz zainstalować środowisko pracy samodzielnie. Może to być konieczne, jeśli z jakiegoś powodu Menedżer dodatków nie działa, ale masz dostęp do środowiska roboczego pobranego jako pakiet {{FileName|.zip}}.


<div class="mw-collapsible mw-collapsed toccolours">
<div class="mw-collapsible mw-collapsed toccolours">


<span id="Installing_on_Windows"></span>
==Installing on Windows==
==Instalacja w środowisku Windows==


Jak zainstalować dodatkowe środowiska pracy i dodatki w systemie Windows
How to install additional workbenches and addons on Windows
<div class="mw-collapsible-content">
<div class="mw-collapsible-content">


<span id="Manual_Install"></span>
=== Obsolete ===
===Instalacja samodzielna===


{{Emphasis|Uwaga:}} Ta metoda jest możliwa, ale nie jest konieczna po wprowadzeniu [[Std_AddonMgr/pl|Menadżera dodatków]]. Niemniej jednak, informacje tutaj zawarte mogą być nadal przydatne dla niektórych.
{{Emphasis|Note:}} using the "addons-installer" is not recommended any more. Using the [[Addon Manager|Addon Manager]] in all systems is the recommended way.


* Pobierz środowisko pracy z GitHub, klikając przycisk {{Button|Klonuj}} lub {{Button|Pobierz}} na stronie GitHub ''(prawy górny róg)'' i wybierając "Pobierz ZIP".
Use the [https://github.com/FreeCAD/FreeCAD-addons addons-installer from Github].
* Rozpakuj pobrane archiwum na lokalnym dysku twardym.
* W programie FreeCAD zlokalizuj ścieżkę makra, wybierając {{MenuCommand|Edycja → Preferencje → Python → Makropolecenia}} i poszukaj pozycji ''Ścieżka do plików makrodefinicji''.
* Domyślna ścieżka makrodefinicji to {{FileName|%APPDATA%\FreeCAD}}, którą zwykle jest {{FileName|C:\Users\\'username''\Appdata\Roaming\FreeCAD}}.
* W katalogu makr utwórz ''(jeśli jeszcze nie istnieje)'' folder o nazwie "{{FileName|Mod}}".
* W folderze Mod utwórz folder z nazwą środowiska pracy, na przykład "Curves".
* Teraz przenieś rozpakowane pliki i podfoldery środowiska pracy do właśnie utworzonego folderu środowiska pracy.
* Po ponownym uruchomieniu FreeCAD powinieneś mieć teraz wpis w okienku wyboru [[Std_Workbench/pl|środowiska pracy]].


'''Dodatkowe zalecenia dotyczące aktualizacji środowisk pracy'''
During Google Summer of Code 2016 student Mandeep Singh started work on an improved version ([https://github.com/mandeeps708/PluginManager available here]) but that version needs further work before it can be fully integrated in FreeCAD.


W systemie Windows, podczas aktualizacji już zainstalowanego środowiska pracy, system zachowuje stare pliki {{FileName|.py}} jako {{FileName|.pyc}}. Ponieważ może to prowadzić do problemów, zaleca się odinstalowanie środowiska pracy, ponowne uruchomienie FreeCAD i zainstalowanie nowej wersji środowiska pracy.
=== Manual Install ===
{{Emphasis|Note:}} This method is possible but not necessary with the introduction of the [[Addon Manager]]. Nevertheless, the information here may still be useful to some.

* Download the workbench from github by clicking on the button {{Button|Clone}} or {{Button|Download}} on the github page (upper right corner) and choosing "Download ZIP"
* Unpack the downloaded archive on your local hard disk
* Within FreeCAD, locate the macro path by choosing {{MenuCommand|Edit → Preferences → General → Macro}} and look for the ”Macro path”
* Supposed your Windows-Login is “''username''” the default macro path is {{FileName|%APPDATA%\FreeCAD\}} which is usually {{FileName|C:\Users\''username''\Appdata\Roaming\FreeCAD}}
* Within the macro-directory create (if not already present) a folder called “{{FileName|Mod}}”
* Within the Mod folder, create a folder with the name of the workbench, for example “Curves”
* Now move the unpacked files and sub-folders of the workbench to the just created workbench-folder
* After restart of FreeCAD you should now have an entry in the [[Std_Workbench|workbench selector]]

'''Additional Recommendation for updating workbenches'''

On windows, when updating an already installed workbench, Windows keeps the old .py files as .pyc. Since this may lead to trouble, it is recommended to uninstall the workbench, restart FreeCAD and install the new version of the workbench.
</div> <!-- END of Windows section collapsible div. Please do not remove --->
</div> <!-- END of Windows section collapsible div. Please do not remove --->
</div> <!-- END of Windows section collapsible div. Please do not remove --->
</div> <!-- END of Windows section collapsible div. Please do not remove --->



<div class="mw-collapsible mw-collapsed toccolours">
<div class="mw-collapsible mw-collapsed toccolours">


<span id="Installing_on_Linux"></span>
==Installing on Linux ==
==Instalacja w środowisku Linux==


Jak zainstalować dodatkowe środowiska pracy i dodatki w systemie Linux
How to install additional workbenches and addons on Linux
<div class="mw-collapsible-content">
<div class="mw-collapsible-content">


<span id="Using_git"></span>
===Using git===
===Przy użycu Git===
Adding the [https://launchpad.net/~freecad-community/+archive/ubuntu/ppa community-ppa] within the ppa-manager.<br />

Installing the workbenches via synaptic packet manager.
Dodając [https://launchpad.net/~freecad-community/+archive/ubuntu/ppa community-ppa] w ppa-manager.
<br>
Instalacja środowiska roboczego poprzez Synaptic Packet Manager.


{{Code|code=
{{Code|code=
Line 67: Line 67:
}}
}}


In FreeCAD you will now have a new workbench-entry called "CurvesWB". Once installed, use git to upgrade to the latest version:
W programie FreeCAD pojawi się teraz nowe środowisko pracy o nazwie "CurvesWB". Po zainstalowaniu użyj Git, aby zaktualizować je do najnowszej wersji:


{{Code|code=
{{Code|code=
Line 75: Line 75:
}}
}}


<span id="Manual_Installation"></span>
===Manual Installation===
===Instalacja samodzielna===
{{Emphasis|Note:}} This method is possible but not necessary with the introduction of the [[Addon Manager]]. Nevertheless, the information here may still be useful to some.


{{Emphasis|Uwaga:}} Ta metoda jest możliwa, ale nie jest konieczna po wprowadzeniu [[Std_AddonMgr/pl|Menadżera dodatków]]. Niemniej jednak, informacje tutaj zawarte mogą być nadal przydatne dla niektórych.
* Download the workbench from github by clicking on the button {{Button|Clone}} or {{Button|Download}} on the github page (upper right corner) and choosing "Download ZIP"

* Unpack the downloaded archive on your local hard disk
* Pobierz środowisko pracy z GitHub, klikając przycisk {{Button|Klonuj}} lub {{Button|Pobierz}} na stronie GitHub ''(prawy górny róg)'' i wybierając "Pobierz ZIP".
* Within FreeCAD, locate the macro path by choosing {{MenuCommand|Edit → Preferences → General → Macro}} and look for the ”Macro path”
* Rozpakuj pobrane archiwum na lokalnym dysku twardym.
* By default, the macro directory is the (hidden) {{MenuCommand|./.FreeCAD/}} directory in your home-directory
* W programie FreeCAD zlokalizuj ścieżkę makra, wybierając {{MenuCommand|Edycja → Preferencje → Python → Makropolecenia}} i poszukaj pozycji ''Ścieżka do plików makrodefinicji''.
* Within the macro-directory create (if not already present) a folder called “{{FileName|Mod}}”
* Domyślna ścieżka makrodefinicji to ''(ukryty)'' katalog {{MenuCommand|./.FreeCAD/}} w twoim katalogu domowym.
* Within the Mod/ folder, create a folder with the name of the workbench, for example “Curves”
* W katalogu makr utwórz ''(jeśli jeszcze nie istnieje)'' folder o nazwie "{{FileName|Mod}}".
* Now move the unpacked files and sub-folders of the workbench to the just created workbench-folder
* W folderze Mod utwórz folder z nazwą środowiska pracy, na przykład "Curves".
* After restart of FreeCAD you should now have an entry in the [[Std_Workbench|workbench selector]]
* Teraz przenieś rozpakowane pliki i podfoldery środowiska pracy do właśnie utworzonego folderu środowiska pracy.
* Po ponownym uruchomieniu FreeCAD powinieneś mieć teraz wpis w okienku wyboru [[Std_Workbench/pl|środowiska pracy]].


</div> <!-- END of Windows section collapsible div. Please do not remove --->
</div> <!-- END of Windows section collapsible div. Please do not remove --->
</div> <!-- END of Windows section collapsible div. Please do not remove --->
</div> <!-- END of Windows section collapsible div. Please do not remove --->



<div class="mw-collapsible mw-collapsed toccolours">
<div class="mw-collapsible mw-collapsed toccolours">
==Installing on Mac==
==Instalacja w środowisku Mac==


Jak zainstalować dodatkowe środowiska pracy i dodatki w systemie macOS
How to install additional workbenches and addons on MacOS
<div class="mw-collapsible-content">
<div class="mw-collapsible-content">


<span id="Manual_Installation"></span>
===Manual Installation===
===Instalacja samodzielna===
{{Emphasis|Note:}} This method is possible but not necessary with the introduction of the [[Addon Manager]]. Nevertheless, the information here may still be useful to some.


{{Emphasis|Uwaga:}} Ta metoda jest możliwa, ale nie jest konieczna po wprowadzeniu [[Std_AddonMgr/pl|Menadżera dodatków]]. Niemniej jednak, informacje tutaj zawarte mogą być nadal przydatne dla niektórych.
For the sake of this example, say you've chosen the [[Curves Workbench]] as the external workbench you want to install:

* Choose and download the git repository of your chosen external workbench as a ZIP file
Na potrzeby tego przykładu powiedzmy, że wybrałeś środowisko pracy [[Curves_Workbench/pl|Krzywe]] jako zewnętrzne środowisko pracy, które chcesz zainstalować:
* Assuming FreeCAD is installed in {{FileName|/Applications/FreeCAD/v0.xx}}", go to {{FileName|/Applications/FreeCAD/v0.xx}}" in the Browser, and select FreeCAD.app
* Wybierz i pobierz repozytorium git wybranego zewnętrznego środowiska pracy jako plik ZIP.
* RMB and select "Show Package Contents", a new window will appear with a folder named "Contents"
* Istnieją dwie możliwe lokalizacje dla dodatkowych środowisk pracy "Mods":
* single-click on the folder "Contents" and select the folder "Mod"
# Wszyscy użytkownicy: {{FileName|/Applications/FreeCAD.app/Contents/Resources/Mod}}
* In the folder "Mod" create a new folder named "Curves"
# Tylko bieżący użytkownik: {{FileName|/Users/myusername/Library/Application Support/FreeCAD/Mod}}
* Unzip downloaded repository in the folder "Contents/Mod/Curves"
* Jeśli używasz Findera do ręcznej nawigacji do lokalizacji Wszyscy użytkownicy w aplikacjach, będziesz musiał
** przejść do {{FileName|/Applications}}" i wybrać FreeCAD.app
** kliknąć prawym przyciskiem myszy i wybrać "Pokaż zawartość pakietu", pojawi się nowe okno z folderem o nazwie "Zawartość"
** Pojedyncze kliknięcie na folderze "Zawartość", a następnie na "Zasoby" i podwójne kliknięcie, aby otworzyć folder "Mod".
* Gdy znajdziesz się w folderze "Mod", którego chcesz użyć, utwórz nowy folder o nazwie "Curves".
* Rozpakuj pobrane repozytorium do folderu "Mod/Curves".
</div> <!-- END of Windows section collapsible div. Please do not remove --->
</div> <!-- END of Windows section collapsible div. Please do not remove --->
</div> <!-- END of Windows section collapsible div. Please do not remove --->
</div> <!-- END of Windows section collapsible div. Please do not remove --->


<span id="General_troubleshooting"></span>
==General troubleshooting==
==Rozwiązywanie problemów ogólnych==

* Nie używaj znaków specjalnych (na przykład niemieckich umlautów) w nazwie użytkownika systemu Windows, w przeciwnym razie FreeCAD nie rozpozna plików i folderów w ścieżce makra.
* Jeśli już skonfigurowałeś nazwę użytkownika ze znakami specjalnymi, utwórz nową nazwę użytkownika lub wskaż ścieżkę makra do katalogu bez znaków specjalnych.
* Przejdź do menu {{MenuCommand|Edycja → Preferencje ... → Środowiska pracy}} i upewnij się, że środowisko pracy nie jest ustawione jako niewidoczne.
* W przypadku systemów 32-bitowych i FreeCAD 0.16.6706, po próbie instalacji dodatkowe środowiska robocze mogą nie być dostępne. W takim przypadku
** trzymaj [[Report_view/pl|widok raportu]] otwarty podczas uruchamiania FreeCAD i przeczytaj błąd,
** zobacz ten wątek na forum [http://forum.freecadweb.org/viewtopic.php?t=12839#p102933 Assembly2 w wersji: 0.16.5602 ''(Git)''].


* Don't use special characters (for example German umlauts) in your windows user name, otherwise FreeCAD will not recognize files and folders in the macro path.
* If you have already set up a user name with special characters either create a new user name or point the macro path to a directory not using special characters.
* Go to {{MenuCommand|Tools → Customize → Workbenches}} and make sure the workbench is not set to invisible.
* With 32-bit systems and FreeCAD 0.16.6706, after attempts to install, the additional Workbenches may not be available. In this case
** keep the [[report_view|report view]] open while starting FreeCAD, and read the error,
** see this forum thread [http://forum.freecadweb.org/viewtopic.php?t=12839#p102933 Assembly2 in Version: 0.16.5602 (Git)]


{{Userdocnavi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}

Latest revision as of 16:06, 14 August 2023

Ćwiczenie
Temat
Programowanie
Poziom trudności
Średniozaawansowany
Czas wykonania
15 minut
Autorzy
r-frank
Wersja FreeCAD
Wszystkie
Pliki z przykładami
brak
Zobacz również
-

Opis

Zaawansowani użytkownicy rozszerzyli FreeCAD o różne niestandardowe zewnętrzne środowiska pracy, które nie są zintegrowane z podstawowym kodem źródłowym, ale są łatwe do zainstalowania na istniejącej dystrybucji FreeCAD. Tutaj omówimy metody instalacji dla różnych systemów operacyjnych.

Uwaga: Począwszy od wersji 0.17, FreeCAD posiada Menadżer dodatków w menu Przybory → Menadżer dodatków, który umożliwia instalację zarówno makrodefinicji, jak i środowisk pracy. Poniższe instrukcje są wymagane tylko wtedy, gdy chcesz zainstalować środowisko pracy samodzielnie. Może to być konieczne, jeśli z jakiegoś powodu Menedżer dodatków nie działa, ale masz dostęp do środowiska roboczego pobranego jako pakiet .zip.

Instalacja w środowisku Windows

Jak zainstalować dodatkowe środowiska pracy i dodatki w systemie Windows

Instalacja samodzielna

Uwaga: Ta metoda jest możliwa, ale nie jest konieczna po wprowadzeniu Menadżera dodatków. Niemniej jednak, informacje tutaj zawarte mogą być nadal przydatne dla niektórych.

  • Pobierz środowisko pracy z GitHub, klikając przycisk Klonuj lub Pobierz na stronie GitHub (prawy górny róg) i wybierając "Pobierz ZIP".
  • Rozpakuj pobrane archiwum na lokalnym dysku twardym.
  • W programie FreeCAD zlokalizuj ścieżkę makra, wybierając Edycja → Preferencje → Python → Makropolecenia i poszukaj pozycji Ścieżka do plików makrodefinicji.
  • Domyślna ścieżka makrodefinicji to %APPDATA%\FreeCAD, którą zwykle jest C:\Users\\'username\Appdata\Roaming\FreeCAD.
  • W katalogu makr utwórz (jeśli jeszcze nie istnieje) folder o nazwie "Mod".
  • W folderze Mod utwórz folder z nazwą środowiska pracy, na przykład "Curves".
  • Teraz przenieś rozpakowane pliki i podfoldery środowiska pracy do właśnie utworzonego folderu środowiska pracy.
  • Po ponownym uruchomieniu FreeCAD powinieneś mieć teraz wpis w okienku wyboru środowiska pracy.

Dodatkowe zalecenia dotyczące aktualizacji środowisk pracy

W systemie Windows, podczas aktualizacji już zainstalowanego środowiska pracy, system zachowuje stare pliki .py jako .pyc. Ponieważ może to prowadzić do problemów, zaleca się odinstalowanie środowiska pracy, ponowne uruchomienie FreeCAD i zainstalowanie nowej wersji środowiska pracy.

Instalacja w środowisku Linux

Jak zainstalować dodatkowe środowiska pracy i dodatki w systemie Linux

Przy użycu Git

Dodając community-ppa w ppa-manager.
Instalacja środowiska roboczego poprzez Synaptic Packet Manager.

$ sudo apt-get install git python-numpy python-pyside
$ mkdir ~/.FreeCAD/Mod
$ cd ~/.FreeCAD/Mod
$ git clone  https://github.com/tomate44/CurvesWB.git

W programie FreeCAD pojawi się teraz nowe środowisko pracy o nazwie "CurvesWB". Po zainstalowaniu użyj Git, aby zaktualizować je do najnowszej wersji:

$ cd ~/.FreeCAD/Mod/CurvesWB
$ git pull
$ rm *.pyc

Instalacja samodzielna

Uwaga: Ta metoda jest możliwa, ale nie jest konieczna po wprowadzeniu Menadżera dodatków. Niemniej jednak, informacje tutaj zawarte mogą być nadal przydatne dla niektórych.

  • Pobierz środowisko pracy z GitHub, klikając przycisk Klonuj lub Pobierz na stronie GitHub (prawy górny róg) i wybierając "Pobierz ZIP".
  • Rozpakuj pobrane archiwum na lokalnym dysku twardym.
  • W programie FreeCAD zlokalizuj ścieżkę makra, wybierając Edycja → Preferencje → Python → Makropolecenia i poszukaj pozycji Ścieżka do plików makrodefinicji.
  • Domyślna ścieżka makrodefinicji to (ukryty) katalog ./.FreeCAD/ w twoim katalogu domowym.
  • W katalogu makr utwórz (jeśli jeszcze nie istnieje) folder o nazwie "Mod".
  • W folderze Mod utwórz folder z nazwą środowiska pracy, na przykład "Curves".
  • Teraz przenieś rozpakowane pliki i podfoldery środowiska pracy do właśnie utworzonego folderu środowiska pracy.
  • Po ponownym uruchomieniu FreeCAD powinieneś mieć teraz wpis w okienku wyboru środowiska pracy.

Instalacja w środowisku Mac

Jak zainstalować dodatkowe środowiska pracy i dodatki w systemie macOS

Instalacja samodzielna

Uwaga: Ta metoda jest możliwa, ale nie jest konieczna po wprowadzeniu Menadżera dodatków. Niemniej jednak, informacje tutaj zawarte mogą być nadal przydatne dla niektórych.

Na potrzeby tego przykładu powiedzmy, że wybrałeś środowisko pracy Krzywe jako zewnętrzne środowisko pracy, które chcesz zainstalować:

  • Wybierz i pobierz repozytorium git wybranego zewnętrznego środowiska pracy jako plik ZIP.
  • Istnieją dwie możliwe lokalizacje dla dodatkowych środowisk pracy "Mods":
  1. Wszyscy użytkownicy: /Applications/FreeCAD.app/Contents/Resources/Mod
  2. Tylko bieżący użytkownik: /Users/myusername/Library/Application Support/FreeCAD/Mod
  • Jeśli używasz Findera do ręcznej nawigacji do lokalizacji Wszyscy użytkownicy w aplikacjach, będziesz musiał
    • przejść do /Applications" i wybrać FreeCAD.app
    • kliknąć prawym przyciskiem myszy i wybrać "Pokaż zawartość pakietu", pojawi się nowe okno z folderem o nazwie "Zawartość"
    • Pojedyncze kliknięcie na folderze "Zawartość", a następnie na "Zasoby" i podwójne kliknięcie, aby otworzyć folder "Mod".
  • Gdy znajdziesz się w folderze "Mod", którego chcesz użyć, utwórz nowy folder o nazwie "Curves".
  • Rozpakuj pobrane repozytorium do folderu "Mod/Curves".

Rozwiązywanie problemów ogólnych

  • Nie używaj znaków specjalnych (na przykład niemieckich umlautów) w nazwie użytkownika systemu Windows, w przeciwnym razie FreeCAD nie rozpozna plików i folderów w ścieżce makra.
  • Jeśli już skonfigurowałeś nazwę użytkownika ze znakami specjalnymi, utwórz nową nazwę użytkownika lub wskaż ścieżkę makra do katalogu bez znaków specjalnych.
  • Przejdź do menu Edycja → Preferencje ... → Środowiska pracy i upewnij się, że środowisko pracy nie jest ustawione jako niewidoczne.
  • W przypadku systemów 32-bitowych i FreeCAD 0.16.6706, po próbie instalacji dodatkowe środowiska robocze mogą nie być dostępne. W takim przypadku