How to install additional workbenches/de: Difference between revisions

From FreeCAD Documentation
(Created page with "*Lade den Arbeitsbereich von github herunter, indem Du auf der Github-Seite (oben rechts) auf die Schaltfläche "Klonen oder Herunterladen" klickst und "Download ZIP" wählst....")
No edit summary
 
(93 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
==Beschreibung====
|Topic=Programmierung
Versierte Nutzer haben FreeCAD um verschiedene benutzerdefinierte externe Arbeitsbereiche erweitert, die (noch!) nicht in den FreeCAD-Quellcode integriert sind,
|Level=Mittelmäßiger Programmierer
aber auf einer bestehenden FreeCAD-Installation einfach zu installieren sind. Im Folgenden werden die Installationsmethoden für die verschiedenen Betriebssysteme behandelt.
|Time=15 Minuten
|FCVersion=Alle
|Author=[[User:R-Frank|r-frank]]
|Files=keine
}}


<span id="Description"></span>
'''Hinweis''' Ab Version 0.17 verfügt FreeCAD über einen Addon-Manager im Menü Extras, der die einfache Installation einer Reihe von externen Arbeitsbereichen ermöglicht. Die folgenden Anweisungen sind nur notwendig, wenn Sie eine frühere Version verwenden oder wenn Sie einen Arbeitsbereich installieren möchten, die nicht in der vom Addon-Manager angebotenen Liste enthalten ist.
==Beschreibung==


Intensivnutzer haben FreeCAD um verschiedene kundenspezifische [[external workbenches/de|externe Arbeitsbereiche]] erweitert, die nicht in den FreeCAD Quellcodekern integriert sind,
==Installation unter 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.
'''Empfohlene Installationsmethode'''


<div class="mw-collapsible mw-collapsed toccolours">
{{Emphasis|Note:}} Die Verwendung des "Addons-Installers" wird nicht mehr empfohlen. Die Verwendung des [[Addon Manager|Addon Manager]] in allen Systemen wird empfohlen.


<span id="Installing_on_Windows"></span>
Benutzen Sie den [https://github.com/FreeCAD/FreeCAD-addons addons-installer von Github].
==Installation unter Windows==


Wie man zusätzliche Arbeitsbereiche und Erweiterungen unter Windows installiert
Während des Google Summer of Code 2016 begann der Student Mandeep Singh mit der Arbeit an einer verbesserten Version ([https://github.com/mandeeps708/PluginManager hier verfügbar]), die jedoch noch weiter bearbeitet werden muss, bevor sie vollständig in FreeCAD integriert werden kann.
<div class="mw-collapsible-content">


<span id="Manual_Install"></span>
'''Alternative Installationsmethode "Manuelle Installation”'''
=== 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.
*Lade den Arbeitsbereich von github herunter, indem Du auf der Github-Seite (oben rechts) auf die Schaltfläche "Klonen oder Herunterladen" klickst und "Download ZIP" wählst.
*Entpacke das heruntergeladene Archiv auf Deine lokale Festplatte.
*In FreeCAD findest Du den Makropfad über "Bearbeiten > Einstellungen > Allgemein > Makro" und suche nach dem "Makropfad".
*Angenommen, Dein Windows-Login ist "Benutzer-Name", der Standard-Makropfad ist "C:\Benutzer-Name\Appdata\Roaming\FreeCAD".
*im Makroverzeichnis einen Ordner namens "Mod" erstellen (falls nicht bereits vorhanden).
*innerhalb des Ordners mod einen Ordner mit dem Namen des Arbeitsbereichs erstellen, z.B. "Assembly2".
*nun verschieben Sie die entpackten Dateien und Unterordner des Arbeitsbereichs in den gerade erstellten Arbeitsbereichs-Ordner.
*nach dem Neustart von FreeCAD solltest Du nun einen Eintrag im Arbeitsbereichs-Aufklapp-Menü haben.


* 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