How to install additional workbenches/de: Difference between revisions

From FreeCAD Documentation
(Created page with "Wie man zusätzliche Werkbänke installiert")
 
No edit summary
 
(102 intermediate revisions by 5 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
{{TutorialInfo|Topic=Programming|Level=Medium programmer|Time=15 minutes|FCVersion=All|Author=[[User:R-Frank|r-frank]]}}


{{TutorialInfo/de
==Description==
|Topic=Programmierung
Power users have extended FreeCAD with various custom external workbenches, that are not integrated into the FreeCAD source code (yet!),
|Level=Mittelmäßiger Programmierer
but are easy to install on an existing FreeCAD installation. Here we will cover the installation methods for the different operating systems.
|Time=15 Minuten
|FCVersion=Alle
|Author=[[User:R-Frank|r-frank]]
|Files=keine
}}


<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.
==Beschreibung==


Intensivnutzer haben FreeCAD um verschiedene kundenspezifische [[external workbenches/de|externe Arbeitsbereiche]] erweitert, die nicht in den FreeCAD Quellcodekern integriert sind,
==Installing on Windows==
sind aber leicht auf einer bestehenden FreeCAD Installation zu installieren. Hier werden wir die Installationsmethoden für die verschiedenen Betriebssysteme behandeln.


{{Emphasis|Hinweis:}} Seit Version 0.17 verfügt FreeCAD über einen [[Image:Std_AddonMgr.svg|24px|link=Std_AddonMgr/de]] [[Std_AddonMgr/de|Addon-Manager]] im Menü {{MenuCommand|Werkzeuge → Addon-Manager}}, das die Installation sowohl von Makros als auch von Arbeitsbereichen erlaubt. Die folgenden Anweisungen sind nur erforderlich, wenn ein Arbeitsbereich manuell installiert werden soll. Dies könnte notwendig sein, wenn aus irgendeinem Grund der Addon-Manager nicht funktioniert, du aber Zugriff auf den als {{FileName|.zip}}-Paket heruntergeladenen Arbeitsbereich hast.
'''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].
==Installation unter Windows==


Wie man zusätzliche Arbeitsbereiche und Erweiterungen unter Windows installiert
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”'''
=== Manuelle Installation ===


{{Emphasis|Hinweis:}} Diese Methode ist mit der Einführung des [[Std_AddonMgr/de|Addon-Manager]] möglich, aber nicht notwendig. Nichtsdestotrotz können die Informationen hier für einige noch nützlich sein.
*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


* Den Arbeitsbereich von github herunterladen, indem die Schaltfläche {{Button|Clone}} oder {{Button|Download}} auf der github-Seite (rechte obere Ecke) gedrückt und "Download ZIP" ausgewählt wird.
'''Additional Recommendation for upating workbenches'''
* Das heruntergeladene Archiv auf deiner lokalen Festplatte entpacken.
* Innerhalb von FreeCAD den Makropfad finden, indem unter {{MenuCommand|Bearbeiten → Einstellungen → Python→ Makro}} nach dem "Makropfad" gesucht wird.
* Angenommen, dein Windows-Login ist "''Benutzername''", dann wird der Standard-Makropfad {{FileName|%APPDATA%\FreeCAD\}} normalerweise zu {{FileName|C:\Users\''Benutzername''\Appdata\Roaming\FreeCAD}}.
* Innerhalb des Makro-Verzeichnisses einen Ordner namens "{{FileName|Mod}}" erstellen (falls nicht bereits vorhanden).
* Innerhalb des Ordners Mod einen Ordner mit dem Namen des Arbeitsbereichs anlegen, z.B. "Curves".
* Nun die entpackten Dateien und Unterordner des Arbeitsbereichs in den soeben erstellten Arbeitsbereichs-Ordner verschieben.
* Nach einem Neustart von FreeCAD solltest du nun einen Eintrag in der [[Std_Workbench/de|Auswahlliste der Arbeitsbereiche]] haben


'''Zusätzliche Empfehlung zur Aktualisierung von Arbeitsbereichen'''
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.


Unter Windows behält Windows beim Aktualisieren eines bereits installierten Arbeitsbereichs die alten .py Dateien als .pyc. Da dies zu Problemen führen kann, wird empfohlen, den Arbeitsbereich zu deinstallieren, FreeCAD neu zu starten und die neue Version des Arbeitsbereichs zu installieren.
==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 />
==Installation unter Linux ==
Installing the workbenches via synaptic packet manager.


Wie man zusätzliche Arbeitsbereiche und Erweiterungen unter Linux installiert
'''Alternative installation method “Installing via Git”'''
<div class="mw-collapsible-content">

<span id="Using_git"></span>
===git verwenden===

Hinzufügen der [https://launchpad.net/~freecad-community/+archive/ubuntu/ppa community-ppa] innerhalb des ppa-Managers.<br />
Installation der Arbeitsbereiche über den Synaptic-Packet-Manager.


{{Code|code=
{{Code|code=
Line 46: 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
}}
}}


In FreeCAD hast du nun einen neuen Arbeitsbereichs-Eintrag namens "CurvesWB". Nach der Installation kannst du git verwenden, um auf die neueste Version zu aktualisieren:
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”'''
=== Manuelle Installation ===

{{Emphasis|Hinweis:}} Diese Methode ist mit der Einführung des [[Std_AddonMgr/de|Addon-Manager]] möglich, aber nicht notwendig. Nichtsdestotrotz können die Informationen hier für einige noch nützlich sein.

* Den Arbeitsbereich von github herunterladen, indem die Schaltfläche {{Button|Clone}} oder {{Button|Download}} auf der github-Seite (rechte obere Ecke) gedrückt und "Download ZIP" ausgewählt wird.
* Das heruntergeladene Archiv auf deiner lokalen Festplatte entpacken.
* Innerhalb von FreeCAD den Makropfad finden, indem unter {{MenuCommand|Bearbeiten → Einstellungen → Python→ Makro}} nach dem "Makropfad" gesucht wird.
* Standardmäßig ist das Makro-Verzeichnis das (versteckte) Verzeichnis {{MenuCommand|./.FreeCAD/}} in deinem Home-Verzeichnis.
* Innerhalb des Makro-Verzeichnisses einen Ordner namens "{{FileName|Mod}}" erstellen (falls nicht bereits vorhanden).
* Innerhalb des Ordners Mod einen Ordner mit dem Namen des Arbeitsbereichs anlegen, z.B. "Curves".
* Nun die entpackten Dateien und Unterordner des Arbeitsbereichs in den soeben erstellten Arbeitsbereichs-Ordner verschieben.
* Nach einem Neustart von FreeCAD solltest du nun einen Eintrag in der [[Std_Workbench/de|Auswahlliste der Arbeitsbereiche]] haben.

</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"
==Installation auf 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


Wie man zusätzliche Arbeitsbereiche und Erweiterungen auf macOS installiert
==Installing on Mac==
<div class="mw-collapsible-content">


<span id="Manual_Installation"></span>
'''Recommended installation method'''
=== Manuelle Installation ===


{{Emphasis|Hinweis:}} Diese Methode ist mit der Einführung des [[Std_AddonMgr/de|Addon-Manager]] möglich, aber nicht notwendig. Nichtsdestotrotz können die Informationen hier für einige noch nützlich sein.


Der Einfachheit halber für dieses Beispiel, sage du hast die [[Curves Workbench/de|Arbeitsbereich Kurven]] als den externen Arbeitsbereich gewählt, den du installieren möchtest:
'''Alternative installation method “manual install”''' - here a description for the workbench "assembly2"
* Wähle das git Repositorium des von dir gewählten externen Arbeitsbereichs aus und lade es als ZIP Datei herunter
*download the git repository as ZIP
* Es gibt zwei mögliche Speicherorte für deinen Erweiterungs Arbeitsbereich 'Mods':
*assuming FreeCAD is installed in "/Applications/FreeCAD/v0.15", go to "/Applications/FreeCAD/v0.15" in the Browser, and select FreeCAD.app
# Alle Benutzer: {{FileName|/Applications/FreeCAD.app/Contents/Resources/Mod}}
*right-click and select "Show Package Contents", a new window will appear with a folder named "Contents"
# Nur aktueller Anwender: {{FileName|/Users/myusername/Library/Application Support/FreeCAD/Mod}}
*single-click on the folder "Contents" and select the folder "Mod"
* Wenn du den Finder verwendest, um manuell zum Speicherort "Alle Benutzer" in Anwendungen zu navigieren, musst du
*in the folder "Mod" create a new folder named "assembly2"
** zu {{FileName|/Applications}}" gehen und FreeCAD.app wählen
*unzip downloaded repository in the folder "Contents/Mod/assembly2"
** Klicke mit der rechten Maustaste und wähle "Paketinhalt anzeigen", es erscheint ein neues Fenster mit einem Ordner namens "Inhalt"
** Einfachklick auf den Ordner "Contents", dann auf "Resources" und Doppelklick, um den Ordner "Mod" zu öffnen
* Sobald du dich in dem gewünschten "Mod" Ordner befindest, erstelle einen neuen Ordner namens "Curves"
* Entpacke das heruntergeladene Repositorium in den Ordner "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>
==Allgemeine Fehlerbehebung==


* Verwende keine Sonderzeichen (z.B. deutsche Umlaute) in deinem Windows-Benutzernamen, da FreeCAD sonst Dateien und Ordner im Makropfad nicht erkennt.
Copy or unzip the drawing dimensioning folder to the directory FreeCAD.app/Contents/Mod
* Wenn Du bereits einen Benutzernamen mit Sonderzeichen eingerichtet hast, erstelle entweder einen neuen Benutzernamen oder verweise mit dem Makropfad auf ein Verzeichnis ohne Sonderzeichen.
where FreeCAD.app is the folder where FreeCAD is installed.
* Zu {{MenuCommand|Bearbeiten → Einstellungen → Arbeitsbereiche}} wechseln und sicherstellen, dass der Arbeitsbereich nicht auf ausgeblendet gesetzt ist.
* Auf einem 32-Bit-System mit FreeCAD 0.16.6706 sind nach einem Installationsversuch die zusätzlichen Arbeitsbereiche möglicherweise nicht verfügbar. In diesem Falle
** Beim Start von FreeCAD das [[report_view/de|Ausgabefenster]] geöffnet lassen und den Fehler ansehen.
** siehe diesen Forumsbeitrag: [http://forum.freecadweb.org/viewtopic.php?t=12839#p102933 Assembly2 in Version: 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 07:19, 6 September 2023

Tutorium
Thema
Programmierung
Niveau
Mittelmäßiger Programmierer
Zeit zum Abschluss
15 Minuten
Autoren
r-frank
FreeCAD-Version
Alle
Beispieldateien
keine
Siehe auch
None

Beschreibung

Intensivnutzer haben FreeCAD um verschiedene kundenspezifische externe Arbeitsbereiche erweitert, die nicht in den FreeCAD Quellcodekern integriert sind, sind aber leicht auf einer bestehenden FreeCAD Installation zu installieren. Hier werden wir die Installationsmethoden für die verschiedenen Betriebssysteme behandeln.

Hinweis: Seit Version 0.17 verfügt FreeCAD über einen Addon-Manager im Menü Werkzeuge → Addon-Manager, das die Installation sowohl von Makros als auch von Arbeitsbereichen erlaubt. Die folgenden Anweisungen sind nur erforderlich, wenn ein Arbeitsbereich manuell installiert werden soll. Dies könnte notwendig sein, wenn aus irgendeinem Grund der Addon-Manager nicht funktioniert, du aber Zugriff auf den als .zip-Paket heruntergeladenen Arbeitsbereich hast.

Installation unter Windows

Wie man zusätzliche Arbeitsbereiche und Erweiterungen unter Windows installiert

Manuelle Installation

Hinweis: Diese Methode ist mit der Einführung des Addon-Manager möglich, aber nicht notwendig. Nichtsdestotrotz können die Informationen hier für einige noch nützlich sein.

  • Den Arbeitsbereich von github herunterladen, indem die Schaltfläche Clone oder Download auf der github-Seite (rechte obere Ecke) gedrückt und "Download ZIP" ausgewählt wird.
  • Das heruntergeladene Archiv auf deiner lokalen Festplatte entpacken.
  • Innerhalb von FreeCAD den Makropfad finden, indem unter Bearbeiten → Einstellungen → Python→ Makro nach dem "Makropfad" gesucht wird.
  • Angenommen, dein Windows-Login ist "Benutzername", dann wird der Standard-Makropfad %APPDATA%\FreeCAD\ normalerweise zu C:\Users\Benutzername\Appdata\Roaming\FreeCAD.
  • Innerhalb des Makro-Verzeichnisses einen Ordner namens "Mod" erstellen (falls nicht bereits vorhanden).
  • Innerhalb des Ordners Mod einen Ordner mit dem Namen des Arbeitsbereichs anlegen, z.B. "Curves".
  • Nun die entpackten Dateien und Unterordner des Arbeitsbereichs in den soeben erstellten Arbeitsbereichs-Ordner verschieben.
  • Nach einem Neustart von FreeCAD solltest du nun einen Eintrag in der Auswahlliste der Arbeitsbereiche haben

Zusätzliche Empfehlung zur Aktualisierung von Arbeitsbereichen

Unter Windows behält Windows beim Aktualisieren eines bereits installierten Arbeitsbereichs die alten .py Dateien als .pyc. Da dies zu Problemen führen kann, wird empfohlen, den Arbeitsbereich zu deinstallieren, FreeCAD neu zu starten und die neue Version des Arbeitsbereichs zu installieren.

Installation unter Linux

Wie man zusätzliche Arbeitsbereiche und Erweiterungen unter Linux installiert

git verwenden

Hinzufügen der community-ppa innerhalb des ppa-Managers.
Installation der Arbeitsbereiche über den 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

In FreeCAD hast du nun einen neuen Arbeitsbereichs-Eintrag namens "CurvesWB". Nach der Installation kannst du git verwenden, um auf die neueste Version zu aktualisieren:

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

Manuelle Installation

Hinweis: Diese Methode ist mit der Einführung des Addon-Manager möglich, aber nicht notwendig. Nichtsdestotrotz können die Informationen hier für einige noch nützlich sein.

  • Den Arbeitsbereich von github herunterladen, indem die Schaltfläche Clone oder Download auf der github-Seite (rechte obere Ecke) gedrückt und "Download ZIP" ausgewählt wird.
  • Das heruntergeladene Archiv auf deiner lokalen Festplatte entpacken.
  • Innerhalb von FreeCAD den Makropfad finden, indem unter Bearbeiten → Einstellungen → Python→ Makro nach dem "Makropfad" gesucht wird.
  • Standardmäßig ist das Makro-Verzeichnis das (versteckte) Verzeichnis ./.FreeCAD/ in deinem Home-Verzeichnis.
  • Innerhalb des Makro-Verzeichnisses einen Ordner namens "Mod" erstellen (falls nicht bereits vorhanden).
  • Innerhalb des Ordners Mod einen Ordner mit dem Namen des Arbeitsbereichs anlegen, z.B. "Curves".
  • Nun die entpackten Dateien und Unterordner des Arbeitsbereichs in den soeben erstellten Arbeitsbereichs-Ordner verschieben.
  • Nach einem Neustart von FreeCAD solltest du nun einen Eintrag in der Auswahlliste der Arbeitsbereiche haben.

Installation auf Mac

Wie man zusätzliche Arbeitsbereiche und Erweiterungen auf macOS installiert

Manuelle Installation

Hinweis: Diese Methode ist mit der Einführung des Addon-Manager möglich, aber nicht notwendig. Nichtsdestotrotz können die Informationen hier für einige noch nützlich sein.

Der Einfachheit halber für dieses Beispiel, sage du hast die Arbeitsbereich Kurven als den externen Arbeitsbereich gewählt, den du installieren möchtest:

  • Wähle das git Repositorium des von dir gewählten externen Arbeitsbereichs aus und lade es als ZIP Datei herunter
  • Es gibt zwei mögliche Speicherorte für deinen Erweiterungs Arbeitsbereich 'Mods':
  1. Alle Benutzer: /Applications/FreeCAD.app/Contents/Resources/Mod
  2. Nur aktueller Anwender: /Users/myusername/Library/Application Support/FreeCAD/Mod
  • Wenn du den Finder verwendest, um manuell zum Speicherort "Alle Benutzer" in Anwendungen zu navigieren, musst du
    • zu /Applications" gehen und FreeCAD.app wählen
    • Klicke mit der rechten Maustaste und wähle "Paketinhalt anzeigen", es erscheint ein neues Fenster mit einem Ordner namens "Inhalt"
    • Einfachklick auf den Ordner "Contents", dann auf "Resources" und Doppelklick, um den Ordner "Mod" zu öffnen
  • Sobald du dich in dem gewünschten "Mod" Ordner befindest, erstelle einen neuen Ordner namens "Curves"
  • Entpacke das heruntergeladene Repositorium in den Ordner "Mod/Curves"

Allgemeine Fehlerbehebung

  • Verwende keine Sonderzeichen (z.B. deutsche Umlaute) in deinem Windows-Benutzernamen, da FreeCAD sonst Dateien und Ordner im Makropfad nicht erkennt.
  • Wenn Du bereits einen Benutzernamen mit Sonderzeichen eingerichtet hast, erstelle entweder einen neuen Benutzernamen oder verweise mit dem Makropfad auf ein Verzeichnis ohne Sonderzeichen.
  • Zu Bearbeiten → Einstellungen → Arbeitsbereiche wechseln und sicherstellen, dass der Arbeitsbereich nicht auf ausgeblendet gesetzt ist.
  • Auf einem 32-Bit-System mit FreeCAD 0.16.6706 sind nach einem Installationsversuch die zusätzlichen Arbeitsbereiche möglicherweise nicht verfügbar. In diesem Falle