Std AddonMgr/de: Difference between revisions

From FreeCAD Documentation
(Updating to match new version of source page)
(Updating to match new version of source page)
(2 intermediate revisions by the same user not shown)
Line 1: Line 1:
<languages/>
<languages/>

{{Docnav
|[[Std_DlgCustomize|Std DlgCustomize]]
|
|[[Std_Tools_Menu|Std Tools Menu]]
|IconL=Std_DlgCustomize.svg
|IconR=
|IconC=Freecad.svg
}}

<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">
{{GuiCommand/de
{{GuiCommand/de
Line 11: Line 21:
</div>
</div>


==Description==

<div class="mw-translate-fuzzy">
Der '''Addon-Manager''' ist ein Werkzeug zum installieren und verwalten von [[external workbenches/de|externen Arbeitsbereichen]] und [[macros/de|Makros]], die von der FreeCAD Gemeinschaft bereitgestellt werden. Falls das Paket [https://github.com/gitpython-developers/GitPython git-python] auf Deinem Computer installiert ist, wird der Addon Manager es verwenden, um installierte Arbeitsbereiche zu aktualisieren und Downloads zu beschleunigen.
Der '''Addon-Manager''' ist ein Werkzeug zum installieren und verwalten von [[external workbenches/de|externen Arbeitsbereichen]] und [[macros/de|Makros]], die von der FreeCAD Gemeinschaft bereitgestellt werden. Falls das Paket [https://github.com/gitpython-developers/GitPython git-python] auf Deinem Computer installiert ist, wird der Addon Manager es verwenden, um installierte Arbeitsbereiche zu aktualisieren und Downloads zu beschleunigen.
</div>


Please note that addons that are marked as {{emphasis|Python 2 Only}} will not work in FreeCAD version 0.19 or higher.
Die Listen der installierbaren Arbeitsbereiche und Makros stammen aus zwei Repositories,[https://github.com/FreeCAD/FreeCAD-addons/ FreeCAD-addons] und [https://github.com/FreeCAD/FreeCAD-macros/FreeCAD-macros], sowie aus den [[Macros recipes/de|Makro Rezepte]].


[[Image:Std_AddonMgr_dialog.png]]
<div class="mw-translate-fuzzy">
[[Image:Addon_Manager_example.png]]
[[Image:Addon_Manager_example.png]]
{{Caption|Schnittstelle des [[AddonManager/de|Addon-Managers]]}}
{{Caption|Schnittstelle des [[AddonManager/de|Addon-Managers]]}}
</div>


<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">
Line 33: Line 50:
</div>
</div>


==Options==
=== Manuelle Installation ===
Wenn Sie den Addon-Manager nicht verwenden, können Sie die neuen Werkzeuge manuell installieren, indem Sie deren Code in Ihrem {{incode|FreeCAD/}}-Benutzerverzeichnis ablegen. Details finden Sie unter:
* [[How to install macros/de|Makros installieren]]
* [[How to install additional workbenches/de|Zusätzliche Arbeitsbereiche installieren]]


The Addon manager dialog box has two tabs on the left, one listing the available workbenches and the other listing the available macros. The information panel on the right will display the homepage of the selected addon.
==Einschränkungen==


===Uninstall===
* 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.


# Select an installed addon on the [[Image:Folder.svg|16px]] '''Workbenches''' tab or the [[Image:Applications-python.svg|16px]] '''Macros''' tab.
* Fehlerberichte und Feature-Anfragen sollten direkt auf jeder Add-On-Seite oder an den Ersteller des Add-ons im [https://forum.freecadweb.org FreeCAD Forum] erfolgen.
# Press the {{Button|[[Image:Delete.svg|16px]] Uninstall selected}} button.


===Install/update===
* 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


# Select an addon on the [[Image:Folder.svg|16px]] '''Workbenches''' tab or the [[Image:Applications-python.svg|16px]] '''Macros''' tab.
:{{Code|code=
# Press the {{Button|[[Image:Edit_OK.svg|16px]] Install/update selected}} button.
$ROOT/Mod/AddonManager/AddonManager.py
# 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#Toolbars|Interface Customization]].
}}
# To change the position of an addon workbench in the [[Std_Workbench|Workbench selector]] list see [[Interface_Customization#Workbenches|Interface Customization]].


===Configuration===
<div class="mw-translate-fuzzy">
wobei {{incode|$ROOT}} das FreeCAD-Installationsverzeichnis auf Ihrem jeweiligen System ist, bspw.
* Linux: {{incode|/usr/lib/freecad/Mod/AddonManager/AddonManager.py}}
* Windows: {{Incode|C:\Program Files\FreeCAD version\Mod\AddonManager.py}}
</div>


# Press the {{Button|[[Image:Preferences-general.svg|16px]] Configure...}} button.
== Neue Arbeitsbereiche und Makros ==
# The Addon manager options dialog box opens.
# Optionally check the {{CheckBox|TRUE|Automatically check for updates at start (requires GitPython)}} checkbox.
# Optionally add repositories to the '''Custom repositories''' list. Addons from these repositories will be added on the [[Image:Folder.svg|16px]] '''Workbenches''' tab or the [[Image:Applications-python.svg|16px]] '''Macros''' tab.
# Optionally choose proxy settings.
# Press the {{Button|OK}} button or the {{Button|Cancel}} button to close the dialog box.


==Notes==
Wenn Sie einen Arbeitsbereich oder ein Makro entwickelt haben und es im Addon-Manager sehen möchten, lesen Sie auf den Repository-Seiten ([https://github.com/FreeCAD/FreeCAD-addons/ FreeCAD-addons] und [https://github.com/FreeCAD/FreeCAD-macros/ FreeCAD-macros]), was zu tun ist. Wenn Sie Ihr Makro zu den [[Macros recipes/de|Maco-Rezepten]] hinzufügen, ist nichts weiteres tun, denn es wird automatisch vom Addon-Manager ausgewählt.


* 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.
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 [https://github.com/FreeCAD/FreeCAD-addons/ FreeCAD-addons]-Repository, bleibt Ihr Code in Ihrem eigenen git-Repository, und wir werden ihn einfach als Submodul zum [https://github.com/FreeCAD/FreeCAD-addons/ 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.
* 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 [https://forum.freecadweb.org FreeCAD forum], and can also be contacted there.
* If the [https://github.com/gitpython-developers/GitPython 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|How to install additional workbenches]] and [[How_to_install_macros|How to install macros]].


==Information for developers==
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 [https://forum.freecadweb.org 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.


<div class="mw-translate-fuzzy">
== Testen des Addon Managers ==
Wenn Sie einen Arbeitsbereich oder ein Makro entwickelt haben und es im Addon-Manager sehen möchten, lesen Sie auf den Repository-Seiten ([https://github.com/FreeCAD/FreeCAD-addons/ FreeCAD-addons] und [https://github.com/FreeCAD/FreeCAD-macros/ FreeCAD-macros]), was zu tun ist. Wenn Sie Ihr Makro zu den [[Macros recipes/de|Maco-Rezepten]] hinzufügen, ist nichts weiteres tun, denn es wird automatisch vom Addon-Manager ausgewählt.
{{VeryImportantMessage|Dieser Abschnitt ist für Entwickler}}
</div>
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 {{incode|FreeCAD/src/Mod/AddonManager}} und eine erneute Ausführung von FreeCAD.


===Python workbenches===
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_Workbench/de|A2plus]]):


<div class="mw-translate-fuzzy">
{{Code|code=
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 [https://github.com/FreeCAD/FreeCAD-addons/ FreeCAD-addons]-Repository, bleibt Ihr Code in Ihrem eigenen git-Repository, und wir werden ihn einfach als Submodul zum [https://github.com/FreeCAD/FreeCAD-addons/ 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.
cd ~/FreeCAD/Mod/A2plus/
</div>
git reset --hard "v0.4.21"
}}


===C++ workbenches===
Die CLI Ausgabe sollte '''HEAD is now at b2c53a4 Merge pull request #281 from kbwbe/devel''' zeigen.


<div class="mw-translate-fuzzy">
Was wir im Wesentlichen getan haben, war die Verwendung eines früheren Release-Tags, um die Version zurückzusetzen.
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 [https://forum.freecadweb.org 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.
Aktualisiere nun im Addon Manager die Liste der Arbeitsbereiche und es sollte zeigen, dass der A2plus Arbeitsbereich eine minderwertige Version verwendet.
</div>


{{clear}}
{{Docnav
|[[Std_DlgCustomize|Std DlgCustomize]]
|
|[[Std_Tools_Menu|Std Tools Menu]]
|IconL=Std_DlgCustomize.svg
|IconR=
|IconC=Freecad.svg
}}


{{Std Base navi{{#translation:}}}}
{{Std Base navi{{#translation:}}}}

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

[[Category:Addons{{#translation:}}]]

Revision as of 20:03, 2 August 2020

Addon manager

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

Description

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.

Please note that addons that are marked as Python 2 Only will not work in FreeCAD version 0.19 or higher.

File:Std AddonMgr dialog.png

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.

Options

The Addon manager dialog box has two tabs on the left, one listing the available workbenches and the other listing the available macros. The information panel on the right will display the homepage of the selected addon.

Uninstall

  1. Select an installed addon on the Workbenches tab or the Macros tab.
  2. Press the Uninstall selected button.

Install/update

  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.

Configuration

  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.

Notes

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

Information for developers

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.

Python workbenches

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.

C++ workbenches

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.