Addon/de: Difference between revisions

From FreeCAD Documentation
No edit summary
No edit summary
 
(20 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
{{TOCright}}


<span id="Introduction"></span>
== Einführung ==
==Einleitung==


In FreeCAD und dieser Dokumentation ist eine [[addon/de|Erweiterung]] eine beliebige Komponente, die nicht Teil der Basisinstallation ist, die aber dem System durch bestimmte Methoden hinzugefügt werden kann.
In FreeCAD und dieser Dokumentation ist ein [[addon/de|Addon]] (eine Erweiterung oder Ergänzung) eine beliebige Komponente, die nicht Teil der Basisinstallation ist, die aber dem System durch bestimmte Methoden hinzugefügt werden kann.


<span id="Different_types"></span>
== Verschiedene Typen ==
== Verschiedene Typen ==


Es gibt zwei Arten von Erweiterungen:
Es gibt drei Arten von Erweiterungen:
* [[Macros/de|Makros]]: kurze Schnipsel von [[Python/de|Python]] Code, der ein neues Werkzeug oder eine neue Funktionalität in einer einzigen Datei mit der Endung {{incode|.FCMacro}} bereitstellt.
* [[Macros/de|Makros]]: Kurzer Abschnitt von [[Python/de|Python]]-Kode, der ein neues Werkzeug oder eine neue Funktionalität in einer einzelnen Datei mit der Endung {{incode|.FCMacro}} bereitstellt.
* [[External workbenches/de|Arbeitsbereiche]]: Sammlungen von Python-Dateien, die zusammengehörige [[Gui_Command/de|GUI-Befehle]] (Werkzeuge) bereitstellen, die sich auf ein bestimmtes Thema beziehen, z.B. Werkzeuge für den Entwurf von Schränken, Werkzeuge für die Arbeit mit Architektur oder Werkzeuge für den Entwurf von Booten usw. Diese Arbeitsbereiche definieren normalerweise neue Werkzeugleisten, in denen [[Gui_Command/de|Befehle]] als Schaltflächen platziert werden.
* Modul: eine einzelne Python Quelldatei oder eine Sammlung von Python Dateien, die die Software in irgendeiner Weise erweitert. Module definieren nicht notwendigerweise einen grafischen "Arbeitsbereich", können aber eine unterstützende Funktion bieten, z.B. eine Bibliothek, die die Konvertierung von Formaten durchführt, oder Code, der die grafische [[interface/de|Oberfläche]] modifiziert.
* [[Preference_Packs|Voreinstellungspakete]]: Verteilbare Sammlung von Benutzervoreinstellungen. {{Version/de|0.20}}
* [[External workbenches/de|Arbeitsbereiche]]: Sammlungen von Python Dateien, die verwandte [[Gui_Command/de|Gui Befehle]] (Werkzeuge), die sich auf ein bestimmtes Thema konzentrieren, z.B. Werkzeuge für den Entwurf von Schränken oder Werkzeuge für die Arbeit mit Architektur oder Werkzeuge für den Entwurf von Booten usw. Diese Arbeitsbereiche definieren normalerweise neue Werkzeugleisten, in denen [[Gui_Command/de|Befehle]] als Schaltflächen platziert werden.


== Installation ==
Makros wie unter dem {{incode|Macro/}} Benutzerverzeichnis installiert, während Module und Arbeitsbereiche unter dem {{incode|Mod/}} Verzeichnis liegen.
{{Code|lang=bash|code=
$HOME/.FreeCAD/Macro/
$HOME/.FreeCAD/Mod/
}}


Beginnend mit FreeCAD 0.17 wird zur Installation von Erweiterungen die Verwendung des [[File:Std_AddonMgr.svg|24px]] [[Std_AddonMgr/de|Addon-Managers]] empfohlen.
<div class="mw-translate-fuzzy">
Makros starten normalerweise als Möglichkeit, eine Zeichnungsaufgabe oder Änderung eines bestimmtes Objekt zu vereinfachen oder zu automatisieren. Wenn viele dieser Makros innerhalb eines Verzeichnisses gesammelt werden, kann das gesamte Verzeichnis als ein neuer Arbeitsbereich verteilt werden.
</div>


Aber für Makros und Arbeitsbereiche ist auch eine manuelle Installation möglich:
Anders ausgedrückt, Makros, Module und Arbeitsbereiche sind im Grunde das gleiche Ding, Python-Code-Stücke, die die Basisinstallation erweitern. Makros sind normalerweise kurze Dienstprogramme fokussiert auf eine einzelne Aufgabe, Module stellen üblicherweise neue Funktionen oder Schnittstellen bereit, während Arbeitsbereiche Sammlungen von Werkzeugen (Schaltflächen, Menüs) und graphischen Schnittstellen sind, um verwandte Aufgaben zu erledigen.
* [[How to install macros/de|Wie Makros installiert werden]]
* [[Installing more workbenches/de|Weitere Arbeitsbereiche installieren]]


<span id="Information_for_developers"></span>
Wenn ein Arbeitsbereich ausreichend entwickelt und gut dokumentiert ist, wird er ggf. als einer der Basis-[[workbenches/de|Arbeitsbereiche]] in FreeCAD eingefügt.
==Informationen für Entwickler==


Hat man ein Makro oder einen Arbeitsbereich entwickelt und möchte es/ihn im Addon-Manager aufgelistet sehen, kann man auf den Seiten [https://github.com/FreeCAD/FreeCAD-addons/ FreeCAD-addons] und [https://github.com/FreeCAD/FreeCAD-macros/ FreeCAD-macros] (beide engl.) lesen, wie es funktioniert. Wird ein Makro zur Seite [[Macros_recipes/de|Makrorezepte]] hinzugefügt, muss nichts weiter getan werden, es wird automatisch vom Addon-Manager gefunden.
== Installation ==


Siehe auch:
Beginnend mit FreeCAD v.017 ist der empfohlene Weg zur Installation von Addons der [[Std_AddonMgr/de|Addon-Manager]].
* [[Workbench_creation/de#Programmpaket (distribution)|Programmpaket eines Python-Arbeitsbereiches herausgeben]]
* [[Workbench_creation/de#Distribution|Programmpaket eines C++ -Arbeitsbereiches herausgeben]]


Trotzdem ist manuelle Installation weiterhin möglich.
* [[How to install macros/de|Makros installieren]]
* [[Installing more workbenches/de|Weitere Arbeitsbereiche installieren]]


{{Userdocnavi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}

Latest revision as of 11:52, 25 November 2023

Einleitung

In FreeCAD und dieser Dokumentation ist ein Addon (eine Erweiterung oder Ergänzung) eine beliebige Komponente, die nicht Teil der Basisinstallation ist, die aber dem System durch bestimmte Methoden hinzugefügt werden kann.

Verschiedene Typen

Es gibt drei Arten von Erweiterungen:

  • Makros: Kurzer Abschnitt von Python-Kode, der ein neues Werkzeug oder eine neue Funktionalität in einer einzelnen Datei mit der Endung .FCMacro bereitstellt.
  • Arbeitsbereiche: Sammlungen von Python-Dateien, die zusammengehörige GUI-Befehle (Werkzeuge) bereitstellen, die sich auf ein bestimmtes Thema beziehen, z.B. Werkzeuge für den Entwurf von Schränken, Werkzeuge für die Arbeit mit Architektur oder Werkzeuge für den Entwurf von Booten usw. Diese Arbeitsbereiche definieren normalerweise neue Werkzeugleisten, in denen Befehle als Schaltflächen platziert werden.
  • Voreinstellungspakete: Verteilbare Sammlung von Benutzervoreinstellungen. eingeführt mit Version 0.20

Installation

Beginnend mit FreeCAD 0.17 wird zur Installation von Erweiterungen die Verwendung des Addon-Managers empfohlen.

Aber für Makros und Arbeitsbereiche ist auch eine manuelle Installation möglich:

Informationen für Entwickler

Hat man ein Makro oder einen Arbeitsbereich entwickelt und möchte es/ihn im Addon-Manager aufgelistet sehen, kann man auf den Seiten FreeCAD-addons und FreeCAD-macros (beide engl.) lesen, wie es funktioniert. Wird ein Makro zur Seite Makrorezepte hinzugefügt, muss nichts weiter getan werden, es wird automatisch vom Addon-Manager gefunden.

Siehe auch: