Std AddonManager

From FreeCAD Documentation
Revision as of 19:08, 10 November 2020 by Maker (talk | contribs)

Std ErweiterungVerw

Menüeintrag
Werkzeuge → ErweiterungsVerwalter
Arbeitsbereich
Alle
Standardtastenkürzel
Keiner
Eingeführt in Version
0.17
Siehe auch
Externe Arbeitsbereiche

, Makros


Beschreibung

Der Std ErweiterungVerw Befehl öffnet den Erweiterungsverwalter.

ist ein Werkzeug zum installieren und verwalten von externen Arbeitsbereichen und Makros, die von der FreeCAD Gemeinschaft bereitgestellt werden. Falls das Paket git-python auf Deinem Computer installiert ist, wird der Addon Manager es verwenden, um installierte Arbeitsbereiche zu aktualisieren und Downloads zu beschleunigen.

Bitte beachte, dass Erweiterungen, die als Python 2 Only markiert sind, in FreeCAD Version 0.19 oder höher nicht funktionieren.

File:Std AddonMgr dialog.png

Das Dialogfeld des Erweiterungsverwalters

Anwendung

  • Öffne das Werkzeugs im Menü Template:MenuCommand/de.
  • Zur Installation eines Arbeitsbereichs: Blättere durch die Liste und wähle das Add-on aus; eine kurze Beschreibung sowie die Homepage werden unterhalb der Liste angezeigt. Drücke die Taste Install/update, um das neue Werkzeug zu installieren. Klicke bei Makros auf die Registerkarte Template:MenuCommand/de und wiederhole die Schritte.
  • Um einen Arbeitsbereich oder ein Makro zu entfernen: Blättere durch die Liste, wähle das Add-on aus und drücke dann die Taste Remove.
  • Um einen Arbeitsbereich oder ein Makro zu aktualisieren: Blättere durch die Liste, wähle das Add-on aus und drücke dann die Taste Install/update.
  • Um nach Updates zu suchen: Drücke die Taste . Aktualisieren Schaltfläche; verfügbare Updates werden unterhalb der Liste angezeigt. Drücke die . Aktualisieren Schaltfläche erneut, um alle Aktualisierungen auf einmal zu installieren. Note: Das Icon-Symbol kann je nach Betriebssystem unterschiedlich aussehen.
  • Um ein Makro auszuführen, installiere zuerst das gewünschte Makro, wähle es dann erneut in der Liste aus und drücke dann die Taste Execute. Das Makro erscheint automatisch im FreeCAD-Makroeditor, um den Code zu zeigen.
  • Drücke Close, um den Manager zu verlassen.

FreeCAD muß neu gestart werden, bevor die neuen Arbeitsbereiche in der Liste der verfügbaren Arbeitsbereiche erscheinen. Sie werden am Ende angehängt. Wenn sie in alphabetischer Reihenfolge erscheinen sollen, können sie im Dialog Std DlgCustomize neu angeordnet werden.

Optionen

Das Dialogfeld des Erweiterungsverwalters hat zwei Reiter auf der linken Seite, eine mit den verfügbaren Arbeitsbereichen und die andere mit den verfügbaren Makros. Das Informationsfeld auf der rechten Seite zeigt die Startseite der ausgewählten Erweiterung an.

Deinstallieren

  1. Wähle eine installiertes Erweiterung auf der Seite Reiter Arbeitsbereiche oder den Makros Reiter.
  2. Drücke die Ausgewähltes deinstallieren Schaltfläche.

Installieren/Aktualisieren

  1. Select an addon on the Workbenches tab or the Macros tab.
  2. Press the Install/update selected button.
  3. If you want to add a macro to a custom toolbar then don't forget to manually download the icon image file, if available, by clicking on the link on the homepage in the information panel. See Interface Customization.
  4. To change the position of an addon workbench in the Workbench selector list see Interface Customization.

Konfiguration

  1. Press the Configure... button.
  2. The Addon manager options dialog box opens.
  3. Optionally check the Automatically check for updates at start (requires GitPython) checkbox.
  4. Optionally add repositories to the Custom repositories list. Addons from these repositories will be added on the Workbenches tab or the Macros tab.
  5. Optionally choose proxy settings.
  6. Press the OK button or the Cancel button to close the dialog box.

Hinweise

  • The addons available in the Addon manager are not part of the official FreeCAD program and are not supported by the core FreeCAD development team. You should read the provided information carefully to make sure you know what you are installing.
  • Bug reports and feature requests should be made directly to the creator of the addon by visiting the indicated website. Many addon developers are regular users of the FreeCAD forum, and can also be contacted there.
  • If the GitPython package is installed on your computer the Addon manager will make use of it, making downloads faster.
  • You can also install addons manually. See How to install additional workbenches and How to install macros.

Informationen für Entwickler

Wenn du einen Arbeitsbereich oder ein Makro entwickelt hast und es im Erweiterungsverwalter sehen möchtest, lies auf den Repositoriumsseiten (FreeCAD-Erweiterungen und FreeCAD-Makros), was zu tun ist. Wenn du dein Makro zu den Makro Rezepte Seiten hinzufügst, ist nichts weiteres tun, denn es wird automatisch vom Erweiterungsverwalter ausgewählt.

Python Arbeitsbereiche

Für Python Arbeitsbereiche benötigst du keine besondere Genehmigung, damit dein Arbeitsbereich zum Erweiterungsverwalter hinzugefügt wird, und da sie außerhalb des FreeCAD Quellcodes liegen, kannst du die gewünschte Lizenz wählen. Wenn du darum anfragst, dass dein Arbeitsbereich in die Liste aufgenommen wird (wir werden keine neuen Arbeitsnbereich ohne eine Anfrage der Autoren hinzufügen), entweder durch eine entsprechende Anfrage im Forum oder durch das Öffnen einer Ausgabe im FreeCAD-Erweiterungs Repositorium, bleibt dein Code in deinem eigenen git Repositorium, wir fügen ihn einfach als Untermodul zum FreeCAD-Erweiterungs Repositorium hinzu. Natürlich werden wir, bevor wir deinen Arbeitsbereich hinzufügen, einen Blick darauf werfen und sicherstellen, dass es keine potentiellen Probleme damit gibt.

C++ Arbeitsbereiche

Wenn du einen Arbeitsbereich in C++ entwickelst, kann er nicht direkt durch Benutzer ausgeführt, sondern muss zuerst kompiliert werden. Du hast zwei Optionen, entweder stellst du vorkompilierte Versionen deines Arbeitsbereichs für die verschiedenen Betriebssysteme zur Verfügung oder du solltest anfragen, dass dein Code in den FreeCAD Quellcode integriert wird. Dafür solltest du die LGPL Lizenz (oder vollkompatible wie MIT oder BSD) verwenden, und du musst deine neuen Werkzeuge der Gemeinschaft im FreeCAD Forum zur Überprüfung vorstellen. Sobald dein Code getestet und genehmigt wurde, solltest du, falls noch nicht geschehen, einen Fork für das FreeCAD Repositorium durchführen, einen neuen Zweig erstellen, deinen Code dorthin schieben und eine Pull Anfrage öffnen, so dass dein Zweig mit dem Haupt Repositorium zusammengeführt wird.