Std AddonMgr/de: Difference between revisions

From FreeCAD Documentation
(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...")
(Updating to match new version of source page)
(37 intermediate revisions by 6 users 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">
{{GuiCommand/de
{{GuiCommand/de
|Name/de=Addon manager
|Name/de=Addon manager
Line 8: Line 19:
|Version=0.17
|Version=0.17
}}
}}
</div>

==Description==


<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">
Der Addon-Manager erlaubt es, [[external workbenches/de|externe Arbeitsbereiche]] und [[macros/de|Makros]] zu installieren, zu aktualisieren und zu löschen. Falls das [https://github.com/gitpython-developers/GitPython git-python]-Paket auf Deinem Computer installiert ist, wird es der Addon-Manager benutzen, 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>
</div>


Please note that addons that are marked as {{emphasis|Python 2 Only}} will not work in FreeCAD version 0.19 or higher.
Eine vollständige Liste der Arbeitsbereiche und Makros finden Sie in zwei Repositories, [https://github.com/FreeCAD/FreeCAD-addons/ FreeCAD-addons] und [https://github.com/FreeCAD/FreeCAD-macros/ FreeCAD-macros], sowie den [[Macros recipes/de|Macro Rezepten]].


[[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">
== Anwendung ==
== Anwendung ==
</div>


<div class="mw-translate-fuzzy">
* Öffnen Sie das Werkzeug im Menü {{MenuCommand|Werkzeuge → Extras → Addon-Manager}}.
* Öffne das Werkzeugs im Menü {{MenuCommand/de|Werkzeuge → 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 {{Button|Install/update}}, um das neue Werkzeug zu installieren. Bei Makros drücken Sie {{MenuCommand|Makros}} und wiederholen Sie die Schritte.
* 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.
* 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 {{Button|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 {{Button|Install/update}}.
* 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}}.
* Nach Updates suchen: Drücken Sie die Taste {{Button|[[File: Std Refresh.png | 24px]]}}. ( 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 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 ein Makro auszuführen: Installieren Sie zuerst das gewünschte Makro, wählen Sie es erneut in der Liste und drücken Sie den {{Button|Execute}}-Button.
* 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.
* Drücken Sie {{Button|Close}}, um den Manager zu beenden.
* Drücke {{Button|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|Std DlgCustomize]] neu angeordnet werden.
</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.
* 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 [https://forum.freecadweb.org FreeCAD forum], and can be contacted there.
# Press the {{Button|[[Image:Delete.svg|16px]] Uninstall selected}} button.


===Install/update===
* 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
{{Code|code=
$ROOT/Mod/AddonManager/AddonManager.py
}}


# Select an addon on the [[Image:Folder.svg|16px]] '''Workbenches''' tab or the [[Image:Applications-python.svg|16px]] '''Macros''' tab.
where {{incode|$ROOT}} is the installation directory of FreeCAD in your particular system, for example,
# Press the {{Button|[[Image:Edit_OK.svg|16px]] Install/update selected}} button.
* Linux: {{incode|/usr/lib/freecad/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]].
* Windows: {{Incode|C:\Program Files\FreeCAD version\Mod\AddonManager.py}}
# To change the position of an addon workbench in the [[Std_Workbench|Workbench selector]] list see [[Interface_Customization#Workbenches|Interface Customization]].


===Configuration===
== New workbenches and macros ==


# Press the {{Button|[[Image:Preferences-general.svg|16px]] Configure...}} button.
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 ([https://github.com/FreeCAD/FreeCAD-addons/ FreeCAD-addons] and [https://github.com/FreeCAD/FreeCAD-macros/ 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.
# 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==
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 [https://github.com/FreeCAD/FreeCAD-addons/ FreeCAD-addons] repository, your code will stay on your own git repository, we will just add it as a submodule to the [https://github.com/FreeCAD/FreeCAD-addons/ 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.


* 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.
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 [https://forum.freecadweb.org 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.
* 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==
{{Userdocnavi}}


<div class="mw-translate-fuzzy">
[[Category:Addons]]
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.
</div>


===Python workbenches===

<div class="mw-translate-fuzzy">
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.
</div>

===C++ workbenches===

<div class="mw-translate-fuzzy">
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>

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


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

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.