Std AddonManager

From FreeCAD Documentation
Revision as of 23:02, 7 April 2019 by Normandc (talk | contribs) (Created page with "* 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...")

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.
  • Bug reports and feature requests should be made directly to the creator of the add-on by visiting the indicated website. Many add-on authors are regular users of the FreeCAD forum, and can be contacted there.
  • 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

New workbenches and macros

If you developed a workbench or macro, and want to see it included in the Addon Manager, read how to do that on the repository pages (FreeCAD-addons and FreeCAD-macros). If you add your macro to the Macros recipes, there is nothing else to do, it will automatically be picked by the Addon Manager.

For python workbenches, you don't need any specific approval to have your workbench added to the Addon Manager and, being outside the FreeCAD source code, you can choose the license you want. If you request for your workbench to be added to the list (we will not add any new workbench without a request from its authors), either by asking so on the forum or by opening an issue on the FreeCAD-addons repository, your code will stay on your own git repository, we will just add it as a submodule to the FreeCAD-addons repository. Of course, before adding your workbench, we will take a look at it and make sure there is nothing potentially problematic with it.

If you develop a workbench in C++, it cannot be run directly by users and must be compiled first. You then have 2 options, either you provide precompiled versions of your workbench yourself, for the different operating systems, or you should request to have your code merged into the FreeCAD source code. For that, you should use the LGPL license (or fully compatible like MIT or BSD), and you must present your new tools to the community in the FreeCAD forum for review. Once your code has been tested and approved, you should fork the FreeCAD repository, if not done yet, create a new branch, push your code to it, and open a pull request so that your branch is merged into the main repository.