How to install additional workbenches/pl: Difference between revisions

From FreeCAD Documentation
(Updating to match new version of source page)
No edit summary
 
(47 intermediate revisions by 2 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
<div class="mw-translate-fuzzy">
{{TutorialInfo/pl|Topic=Programming|Level=Medium programmer|Time=15 minutes|FCVersion=All|Author=[[User:R-Frank|r-frank]]}}
</div>


{{TutorialInfo/pl
==Description==
|Topic=Programowanie
Power users have extended FreeCAD with various custom external workbenches, that are not integrated into the FreeCAD source code (yet!),
|Level=Średniozaawansowany
but are easy to install on an existing FreeCAD installation. Here we will cover the installation methods for the different operating systems.
|Time=15 minut
|FCVersion=Wszystkie
|Author=[[User:R-Frank|r-frank]]
|Files=brak
}}


<span id="Description"></span>
'''Note''' Starting from version 0.17, FreeCAD features an addons manager in the Tools menu, that allows to easily install a series of external workbenches. The instructions below are only necessary if you are running an earlier version, or if you want to install a workbench that is not in the list offered by the addons manager.
==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.
==Installing on Windows==


{{Emphasis|Uwaga:}} Począwszy od wersji 0.17, FreeCAD posiada [[File:Std_AddonMgr.svg|24px]] [[Std_AddonMgr|Menadżer dodatków]] w menu {{MenuCommand|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 {{FileName|.zip}}.
'''Recommended installation method'''


<div class="mw-collapsible mw-collapsed toccolours">
{{Emphasis|Note:}} using the "addons-installer" is not recommended any more. Using the [[Addon Manager|Addon Manager]] in all systems is the recommended way.


<span id="Installing_on_Windows"></span>
Use the [https://github.com/FreeCAD/FreeCAD-addons addons-installer from Github].
==Instalacja w środowisku Windows==


Jak zainstalować dodatkowe środowiska pracy i dodatki w systemie Windows
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.
<div class="mw-collapsible-content">


<span id="Manual_Install"></span>
'''Alternative installation method “manual install”'''
===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.
*download the workbench from github by clicking on the button “clone or 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 “Edit > Preferences > General > Macro” and look for the ”Macro path”
*supposed your Windows-Login is “User-Name” the default macro path is “C:\User-Name\Appdata\Roaming\FreeCAD”
*within the macro-directory create (if not already present) a folder called “Mod”
*within the folder mod create a folder with the name of the workbench, for example “Assembly2”
*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 workbench-pulldown-menu


* 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".
'''Additional Recommendation for upating workbenches'''
* 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'''
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.


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.
==Installing on Linux (Ubuntu/Mint)==
</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">
'''Recommended installation method'''


<span id="Installing_on_Linux"></span>
Adding the [https://launchpad.net/~freecad-community/+archive/ubuntu/ppa community-ppa] within the ppa-manager.<br />
==Instalacja w środowisku Linux==
Installing the workbenches via synaptic packet manager.


Jak zainstalować dodatkowe środowiska pracy i dodatki w systemie Linux
'''Alternative installation method “Installing via Git”'''
<div class="mw-collapsible-content">

<span id="Using_git"></span>
===Przy użycu Git===

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 48: Line 64:
$ mkdir ~/.FreeCAD/Mod
$ mkdir ~/.FreeCAD/Mod
$ cd ~/.FreeCAD/Mod
$ cd ~/.FreeCAD/Mod
$ git clone https://github.com/hamish2014/FreeCAD_assembly2.git
$ 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:
FreeCAD you will now have a new workbench-entry called "Assembly 2". Once installed, use git to upgrade to the latest version through BASH as follows


{{Code|code=
{{Code|code=
$ cd ~/.FreeCAD/Mod/FreeCAD_assembly2
$ cd ~/.FreeCAD/Mod/CurvesWB
$ git pull
$ git pull
$ rm *.pyc
$ rm *.pyc
}}
}}


<span id="Manual_Installation"></span>
'''Alternative installation method “manual install”'''
===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.

* 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".
* 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 ''(ukryty)'' katalog {{MenuCommand|./.FreeCAD/}} w twoim katalogu domowym.
* 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]].

</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">
*download the workbench from github by clicking on the button “clone or download” on the github page (upper right corner) and choosing "Download ZIP"
==Instalacja w środowisku Mac==
*unpack the downloaded archive on your local hard disk
*within FreeCAD, locate the macro path by choosing “Edit > Preferences > General > Macro” and look for the ”Macro path”
*by default, the macro directory is the (hidden) "/.FreeCAD"-directory in your home-directory
*within the macro-directory create (if not already present) a folder called “Mod”
*within the folder "mod" create a folder with the name of the workbench, for example “Assembly2”
*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 workbench-pulldown-menu


Jak zainstalować dodatkowe środowiska pracy i dodatki w systemie macOS
==Installing on Mac==
<div class="mw-collapsible-content">


<span id="Manual_Installation"></span>
'''Recommended installation method'''
===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.


Na potrzeby tego przykładu powiedzmy, że wybrałeś środowisko pracy [[Curves_Workbench/pl|Krzywe]] jako zewnętrzne środowisko pracy, które chcesz zainstalować:
'''Alternative installation method “manual install”''' - here a description for the workbench "assembly2"
* Wybierz i pobierz repozytorium git wybranego zewnętrznego środowiska pracy jako plik ZIP.
*download the git repository as ZIP
* Istnieją dwie możliwe lokalizacje dla dodatkowych środowisk pracy "Mods":
*assuming FreeCAD is installed in "/Applications/FreeCAD/v0.15", go to "/Applications/FreeCAD/v0.15" in the Browser, and select FreeCAD.app
# Wszyscy użytkownicy: {{FileName|/Applications/FreeCAD.app/Contents/Resources/Mod}}
*right-click and select "Show Package Contents", a new window will appear with a folder named "Contents"
# Tylko bieżący użytkownik: {{FileName|/Users/myusername/Library/Application Support/FreeCAD/Mod}}
*single-click on the folder "Contents" and select the folder "Mod"
* Jeśli używasz Findera do ręcznej nawigacji do lokalizacji Wszyscy użytkownicy w aplikacjach, będziesz musiał
*in the folder "Mod" create a new folder named "assembly2"
** przejść do {{FileName|/Applications}}" i wybrać FreeCAD.app
*unzip downloaded repository in the folder "Contents/Mod/assembly2"
** 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 --->


<span id="General_troubleshooting"></span>
==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.
Copy or unzip the drawing dimensioning folder to the directory FreeCAD.app/Contents/Mod
* 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.
where FreeCAD.app is the folder where FreeCAD is installed.
* 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)''].


==General troubleshooting==


{{Userdocnavi{{#translation:}}}}
*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
{{Powerdocnavi{{#translation:}}}}
*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
[[Category:External Workbenches{{#translation:}}]]
*Workbench still not showing up ? In FreeCAD, choose “Tools > Customize > Workbenches” and make sure it is not set to invisible
[[Category:Addons{{#translation:}}]]
*'''Notes for users with 32-bit system and FreeCAD 0.16.6706 '''. After attempts to install, the additional Workbenches may not be available. In this case
** hold the Report panel open while starting FreeCAD, and read the error
** see this forum thread: http://forum.freecadweb.org/viewtopic.php?t=12839#p102933

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