Std AddonManager

From FreeCAD Documentation
Revision as of 08:45, 8 April 2019 by FuzzyBot (talk | contribs) (Updating to match new version of source page)

Addon manager

Menüeintrag
Werkzeuge → Addon manager
Arbeitsbereich
Alle
Standardtastenkürzel
Keiner
Eingeführt in Version
0.17
Siehe auch
Makros,Externe Arbeitsbereiche

Der Addon-Manager erlaubt es, externe Arbeitsbereiche und Makros zu installieren, zu aktualisieren und zu löschen. Falls das git-python-Paket auf Deinem Computer installiert ist, wird es der Addon-Manager benutzen, um installierte Arbeitsbereiche zu aktualisieren und Downloads zu beschleunigen.

Eine vollständige Liste der Arbeitsbereiche und Makros finden Sie in zwei Repositories, FreeCAD-addons und FreeCAD-macros, sowie den Macro Rezepten.

Schnittstelle des Addon-Managers

Anwendung

  • Öffnen Sie das Werkzeug im Menü Werkzeuge → Extras → Addon-Manager.
  • Um eine Workbench zu installieren: Scrollen Sie durch die Liste und wählen Sie das Add-On. Die Beschreibung des Add-Ons wird unter der Liste sowie der Link zur Add-On-Seite angezeigt. Drücken Sie dann die Taste Install/update, um das neue Werkzeug zu installieren. Bei Makros drücken Sie Makros und wiederholen Sie die Schritte.
  • So entfernen Sie eine Workbench oder ein Makro: Blättern Sie durch die Liste, wählen Sie das Add-on aus und drücken Sie die Taste Remove Taste.
  • Um eine Workbench oder ein Makro zu aktualisieren: Blättern Sie durch die Liste, wählen Sie das Add-on und drücken Sie die Taste Install/update.
  • Nach Updates suchen: Drücken Sie die Taste . ( Hinweis: das Symbol kann je nach Betriebssystem anders aussehen. ) Verfügbare Updates werden unterhalb der Liste angezeigt. Durch erneutes Drücken der Update-Taste werden alle Updates gleichzeitig aktualisiert.
  • Um ein Makro auszuführen: Installieren Sie zuerst das gewünschte Makro, wählen Sie es erneut in der Liste und drücken Sie den Execute-Button.
  • Drücken Sie Close, um den Manager zu beenden.

Manuelle Installation

Wenn Sie den Addon-Manager nicht verwenden, können Sie die neuen Werkzeuge manuell installieren, indem Sie deren Code in Ihrem FreeCAD/-Benutzerverzeichnis ablegen. Details finden Sie unter:

Einschränkungen

  • Diese Add-Ons gehören nicht zum offiziellen FreeCAD-Programm und werden vom FreeCAD-Core-Team nicht unterstützt. Sie sollten die Informationen auf jeder der Add-On-Seiten lesen, bevor Sie sie installieren, um sicherzustellen, dass Sie wissen, was Sie installieren.
  • Fehlerberichte und Feature-Anfragen sollten direkt auf jeder Add-On-Seite oder an den Ersteller des Add-ons im FreeCAD Forum erfolgen.
  • The web addresses of the repositories for add-ons and macros are hard coded into the AddonManager. As this application is written in Python, experienced users can change these locations by editing the appropriate fields in
$ROOT/Mod/AddonManager/AddonManager.py

where $ROOT is the installation directory of FreeCAD in your particular system, for example,

  • Linux: /usr/lib/freecad/Mod/AddonManager/AddonManager.py
  • Windows: C:\Program Files\FreeCAD version\Mod\AddonManager.py

Neue Arbeitsbereiche und Makros

Wenn Sie einen Arbeitsbereich oder ein Makro entwickelt haben und es im Addon-Manager sehen möchten, lesen Sie auf den Repository-Seiten (FreeCAD-addons und FreeCAD-macros), was zu tun ist. Wenn Sie Ihr Makro zu den Maco-Rezepten hinzufügen, ist nichts weiteres tun, denn es wird automatisch vom Addon-Manager ausgewählt.

Bei Python-Arbeitsbereichen benötigen Sie keine bestimmte Genehmigung, damit Ihr Arbeitsbereich zum Addon-Manager hinzugefügt wird, und da Sie sich außerhalb des FreeCAD-Quellcodes befinden, können Sie die Lizenz wählen, die Sie möchten. Wenn Sie darum bitten, dass Ihr Arbeitsbereich zur Liste hinzugefügt wird (wir werden keine neuen Arbeitsbereiche ohne die Bitte der Autoren hinzufügen), entweder durch Anfrage im Forum oder durch Eröffnen eines Themas im FreeCAD-addons-Repository, bleibt Ihr Code in Ihrem eigenen git-Repository, und wir werden ihn einfach als Submodul zum FreeCAD-addons-Repository hinzufügen. Vor dem Hinzufügen des Arbeitsbereichs werden wir natürlich einen Blick darauf werfen, um sicherzustellen, dass er nichts potenziell Gefährliches enthält.

Wenn Sie einen Arbeitsbereich in C++ entwickeln, kann er nicht direkt durch Benutzer ausgeführt, sondern muss zuerst kompiliert werden. Sie haben zwei Optionen, entweder stellen Sie vorkompilierte Versionen Ihres Arbeitsbereichs für die verschiedenen Betriebssysteme zur Verfügung oder Sie sollten darum bitten, dass Ihr Code in den FreeCAD-Quellcode integriert wird. Dafür sollten Sie die LGPL-Lizenz (oder vollkompatible wie MIT oder BSD) verwenden, und Sie müssen Ihre Werkzeuge der Community im FreeCAD Forum für ein Review vorstellen. Sobald Ihr Code getestet und freigegeben ist, sollten Sie das FreeCAD-Repository forken (sofern noch nicht geschehen), einen neuen Branch anlegen, den Code dorthin pushen, und einen Pull-Request öffnen, damit Ihr Branch zum Main-Repository hinzugefügt wird.