Std AddonMgr/de: Difference between revisions

From FreeCAD Documentation
mNo edit summary
No edit summary
Line 18: Line 18:
== Anwendung ==
== Anwendung ==


* Öffne das Werkzeugs im Menü {{MenuCommand/de|Werkzeuge → Addon manager}}.
<div class="mw-translate-fuzzy">
* 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 {{Button|Install/update}}, um das neue Werkzeug zu installieren. Klicke bei Makros auf die Registerkarte {{MenuCommand/de|Makros}} und wiederhole die Schritte.
* Öffne das Werkzeugs im Menü {{MenuCommand/de|Werkzeuge → Addon manager}}}.
* 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 {{Button|Install/update}}}, um das neue Werkzeug zu installieren. Klicke bei Makros auf die Registerkarte {{MenuCommand/de|Makros}}} 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 {{Button|Remove}}.
* 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 {{Button|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 {{Button|Install/update}}.
* Um nach Updates zu suchen: Drücke die Taste {{Button|[[File:Std Refresh.png|16px]]. Aktualisieren}} Schaltfläche; verfügbare Updates werden unterhalb der Liste angezeigt. Drücke die {{Button|[[File:Std Refresh.png|16px]]. Aktualisieren}} Schaltfläche erneut, um alle Aktualisierungen auf einmal zu installieren. {{Emphasis|Note:}} Das Icon-Symbol kann je nach Betriebssystem unterschiedlich aussehen.
* Um eine Arbeitsbereich oder ein Makro zu aktualisieren: Blättere durch die Liste, wähle das Add-on aus und drücke dann die Taste {{Button|Install/update}}}.
* 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 {{Button|Execute}}. Das Makro erscheint automatisch im FreeCAD-Makroeditor, um den Code zu zeigen.
* Um nach Updates zu suchen: Drücke die Taste {{Button|[[File:Std Refresh.png|16px]]]. Aktualisieren}}} Schaltfläche; verfügbare Updates werden unterhalb der Liste angezeigt. Drücke die Taste {{Button|[[File:Std Refresh.png|16px]]]. Aktualisieren}}} Schaltfläche erneut, um alle Updates auf einmal zu installieren. {{Emphasis|Note:}} Das Symbol kann je nach Betriebssystem unterschiedlich aussehen.
* Drücke {{Button|Close}}, um den Manager zu verlassen.
* 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 {{Button|Execute}}}. Das Makro wird automatisch im FreeCAD-Makroeditor bearbeitet, um den Code zu visualisieren.
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|Std DlgCustomize]] neu angeordnet werden.
* Drücke {{Button|Close}}}, um den Manager zu verlassen.
Du musst FreeCAD neu starten, bevor neue Arbeitsbereiche in der Liste der verfügbaren Arbeitsbereiche erscheinen. Sie werden am Ende angehängt, wenn Du sie in alphabetischer Reihenfolge haben möchtst, kannst Du sie im Dialog [[Std DlgCustomize|Std DlgCustomize]] neu anordnen.
</div>


=== Manuelle Installation ===
=== Manuelle Installation ===

Revision as of 07:23, 4 January 2020

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 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.

Die Listen der installierbaren Arbeitsbereiche und Makros stammen aus zwei Repositories,FreeCAD-addons und [1], sowie aus den Makro Rezepte.

Schnittstelle des Addon-Managers

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.

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.
  • Die Webadressen der Repositories für Add-ons und Makros sind fest im AddonManager kodiert. Da diese Anwendung in Python geschrieben ist, können erfahrene Benutzer diese Positionen ändern, indem sie die entsprechenden Felder in der Datei
$ROOT/Mod/AddonManager/AddonManager.py

wobei $ROOT das FreeCAD-Installationsverzeichnis auf Ihrem jeweiligen System ist, bspw.

  • 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.

Testen des Addon Managers

Dieser Abschnitt ist für Entwickler

Der Addon Manager ist in Python kodiert, so dass es möglich ist, den Quellcode zu ändern, ohne ihn zu kompilieren. Genauer gesagt, erfordert das Testen eine Änderung des Codes in FreeCAD/src/Mod/AddonManager} und eine erneute Ausführung von FreeCAD.

Um die Downloadfähigkeit des Addon Managers zu testen, kannst Du simulieren, dass z.B. eine frühere Version eines Arbeitsbereichs über die CLI heruntergeladen werden muss. Im folgenden Beispiel verwenden wir die Assembly2+ Workbench (kurz: A2plus):

cd ~/FreeCAD/Mod/A2plus/
git reset --hard "v0.4.21"

CLI output should show HEAD is now at b2c53a4 Merge pull request #281 from kbwbe/devel

Was wir im Wesentlichen getan haben, war die Verwendung eines früheren Release-Tags, um die Version zurückzusetzen. Aktualisiere nun im Addon Manager die Liste der Arbeitsbereiche und es sollte zeigen, dass der A2plus Arbeitsbereich eine minderwertige Version verwendet.