How to install additional workbenches/de: Difference between revisions

From FreeCAD Documentation
(Created page with "==Installation auf Mac==")
No edit summary
 
(83 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.
'''Zusätzliche Empfehlung zur Aktualisierung von Werkbänken'''
* 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'''
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.


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 (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">
'''Empfohlene Installationsmethode'''


<span id="Installing_on_Linux"></span>
Hinzufügen der [https://launchpad.net/~freecad-community/+archive/ubuntu/ppa communityity-ppa] innerhalb des ppa-manager.<br />
Installation des Arbeitsbereichs über den synaptischen Paketmanager.
==Installation unter Linux ==


Wie man zusätzliche Arbeitsbereiche und Erweiterungen unter Linux installiert
'''Alternative Installationsmethode "Installation über 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
}}
}}


FreeCAD erhält nun einen neuen Arbeitsbereichs-Eintrag namens "Assembly 2". Nach der Installation können Sie mit git wie folgt auf die neueste Version über .bash aktualisieren.
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:


{{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 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 "clone or download" klickst und "Download ZIP" wählst.
*Entpacke das heruntergeladene Archiv auf Deiner lokalen Festplatte.
*In FreeCAD findest Du den Makropfad über "Bearbeiten > Einstellungen > Allgemein > Makro" und suchst nach dem "Makropfad".
*standardmäßig ist das Makroverzeichnis das (versteckte) "/.FreeCAD"-Verzeichnis in Deinem Home-Verzeichnis.
*im Makroverzeichnis einen Ordner namens "Mod" erstellen (falls nicht bereits vorhanden).
*innerhalb des Ordners "mod" einen Ordner mit dem Namen des Arbeitsbereichs anlegen, z.B. "Assembly2".
*nun verschiebe die entpackten Dateien und Unterordner des Arbeitsbereichs in den gerade erstellten Arbeitsbereichs-Ordner.
*nach dem Neustart von FreeCAD sollte nun ein Eintrag im Arbeitsbereichs-Aufklapp-Menü vorhanden 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">
==Installation auf Mac==
==Installation auf Mac==


Wie man zusätzliche Arbeitsbereiche und Erweiterungen auf macOS installiert
'''Recommended installation method'''
<div class="mw-collapsible-content">

<span id="Manual_Installation"></span>
=== 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