Std AddonMgr/de: Difference between revisions

From FreeCAD Documentation
No edit summary
(Updating to match new version of source page)
Line 21: Line 21:
==Beschreibung==
==Beschreibung==


<div class="mw-translate-fuzzy">
Der '''Std ErweiterungVerw''' Befehl öffnet den Erweiterungsverwalter. Mit dem Erweiterungsverwalter kannst du [[external_workbenches/de|externe Arbeitsbereiche]] und [[macros/de|Makros]], die von der FreeCAD Gemeinschaft bereitgestellt werden, installieren und verwalten. Die verfügbaren Arbeitsbereiche und Makros stammen aus zwei Repositorien, [https://github.com/FreeCAD/FreeCAD-addons/ FreeCAD-addons] und [https://github.com/FreeCAD/FreeCAD-macros/ FreeCAD-macros], sowie von der [[Macros_recipes/de|Makrosrezepte]] Seite.
Der '''Std ErweiterungVerw''' Befehl öffnet den Erweiterungsverwalter. Mit dem Erweiterungsverwalter kannst du [[external_workbenches/de|externe Arbeitsbereiche]] und [[macros/de|Makros]], die von der FreeCAD Gemeinschaft bereitgestellt werden, installieren und verwalten. Die verfügbaren Arbeitsbereiche und Makros stammen aus zwei Repositorien, [https://github.com/FreeCAD/FreeCAD-addons/ FreeCAD-addons] und [https://github.com/FreeCAD/FreeCAD-macros/ FreeCAD-macros], sowie von der [[Macros_recipes/de|Makrosrezepte]] Seite.
</div>


<div class="mw-translate-fuzzy">
Erweiterungen, die als {{emphasis|Nur Python 2}} markiert sind, funktionieren nicht in FreeCAD Version 0.19 oder höher.

Aufgrund von Änderungen an der GitHub Plattform im Jahr 2020 funktioniert der Erweiterungsverwalter nicht mehr, wenn du FreeCAD Version 0.17 oder früher verwendest. Du musst auf die Version [https://github.com/FreeCAD/FreeCAD/releases/tag/0.18.5 0.18.5] oder eine neuere Version [https://github.com/FreeCAD/FreeCAD/releases/tag/0.19_pre 0.19] aktualisieren. Alternativ kannst du Erweiterungen auch manuell installieren, siehe [[#Hinweise|Hinweise]] unten.
Aufgrund von Änderungen an der GitHub Plattform im Jahr 2020 funktioniert der Erweiterungsverwalter nicht mehr, wenn du FreeCAD Version 0.17 oder früher verwendest. Du musst auf die Version [https://github.com/FreeCAD/FreeCAD/releases/tag/0.18.5 0.18.5] oder eine neuere Version [https://github.com/FreeCAD/FreeCAD/releases/tag/0.19_pre 0.19] aktualisieren. Alternativ kannst du Erweiterungen auch manuell installieren, siehe [[#Hinweise|Hinweise]] unten.
</div>

[[Image:Std_AddonMgr_dialog.png]]
{{Caption|Das Dialogfeld des Erweiterungsverwalters}}


==Anwendung==
==Anwendung==


<div class="mw-translate-fuzzy">
# Wähle die {{MenuCommand|Werkzeuge → [[Image:Std_AddonMgr.svg|16px]] Erweiterungsverwalter}} Option aus dem Menü.
# Wähle die {{MenuCommand|Werkzeuge → [[Image:Std_AddonMgr.svg|16px]] Erweiterungsverwalter}} Option aus dem Menü.
# Wenn du den Erweiterungsverwalter zum ersten Mal verwendest, wird ein Dialogfeld geöffnet, das dich darauf hinweist, dass die Erweiterungen im Erweiterungsverwalter nicht offiziell Teil von FreeCAD sind. Drücke die {{Button|OK}} Schaltfläche, um zu bestätigen und fortzufahren.
# Wenn du den Erweiterungsverwalter zum ersten Mal verwendest, wird ein Dialogfeld geöffnet, das dich darauf hinweist, dass die Erweiterungen im Erweiterungsverwalter nicht offiziell Teil von FreeCAD sind. Drücke die {{Button|OK}} Schaltfläche, um zu bestätigen und fortzufahren.
Line 38: Line 38:
# Drücke die {{Button|[[Image:Process-stop.svg|16px]] Schließen}} Schaltfläche, um das Dialogfeld zu schließen.
# Drücke die {{Button|[[Image:Process-stop.svg|16px]] Schließen}} Schaltfläche, um das Dialogfeld zu schließen.
# Wenn du einen Arbeitsbereich installiert oder aktualisiert hast, wird ein neues Dialogfeld geöffnet, das dich darauf hinweist, dass du FreeCAD neu starten musst, damit die Änderungen wirksam werden.
# Wenn du einen Arbeitsbereich installiert oder aktualisiert hast, wird ein neues Dialogfeld geöffnet, das dich darauf hinweist, dass du FreeCAD neu starten musst, damit die Änderungen wirksam werden.
</div>


==Optionen==
==Optionen==


[[File:AddonManager_Main.png|600px]]
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.


# The Addon manager provides two view layouts: "Condensed" and "Expanded". In "Condensed" view, each addon takes a single line, and its description is truncated to fit the available space. "Expanded" shows additional details, including more of the description text as well as maintainer information, more installation details, etc.
===Deinstallieren===
# Three different types of addons are supported: [[external_workbenches|workbenches]], [[macros|macros]], and [[Preference_Packs|preference packs]]. You can choose to show just one type, or all of them in a single list.
# The list can be limited to show just installed packages, just packages with available updates, or just packages that are not yet installed.
# The list can be filtered, searching for a keyword in the title, description, and tags (description and tags must be specified by the addon developer in their addon's metadata). The filter can even be a regular expression, for fine-grained control of the exact search term.
# The expanded view shows available version information, description, maintainer information, and installation version information, for packages that provide a [[Package_Metadata|package metadata]] file (or for macros with embedded metadata).
# Addon data is cached locally, with a variable cache update frequency set in the user preferences.
# At any time you can choose to manually update your local cache to see the latest updates available for each addon.
# Update checks may be set up to be automatic, or done manually via a button click (configured in user preferences). If GitPython and git are installed on your system then update information is fetched using git. If not, then update information is obtained from any present metadata file.


Clicking on an addon in this view brings up the addon's Details page:
# Wähle eine installiertes Erweiterung auf der Seite [[Image:Folder.svg|16px]] Reiter '''Arbeitsbereiche''' oder den [[Image:Applications-python.svg|16px]] '''Makros''' Reiter.
# Drücke die {{Button|[[Image:Delete.svg|16px]] Ausgewähltes deinstallieren}} Schaltfläche.


[[File:AddonManager_Details.png|600px]]
===Installieren/Aktualisieren===


The details page shows buttons allowing installing, uninstalling, updating, and temporarily disabling an addon. For installed addons it lists the currently installed version and the installation date, and whether that is the most recent version available. Below is an embedded web browser window showing the addon's README page (for workbenches and preference packs), or Wiki page (for macros).
# Wähle eine Erweiterung auf dem [[Image:Folder.svg|16px]] '''Arbeitsbereiche''' Reiter oder dem [[Image:Applications-python.svg|16px]] '''Makros''' Reiter.
# Drücke die {{Button|[[Image:Edit_OK.svg|16px]] Installieren/Aktualisieren ausgewählt}} Schaltfläche .
# Wenn du ein Makro zu einer benutzerdefinierten Werkzeugleiste hinzufügen möchtest, vergiss nicht, die Symbol Bilddatei, falls verfügbar, manuell herunterzuladen, indem du auf den Verweis auf der Homepage im Informationsfenster klickst. Siehe [[Interface_Customization/de#Werkzeugleisten|Schnittstellenanpassung]].
# Um die Position eines Erweiterungsarbeitsbereichs in der Liste [[Std_Workbench/de|Arbeistbereichswähler]] zu ändern, siehe [[Interface_Customization/de#Arbeitsbereiche|Oberflächenanpassung]].


===Konfiguration===
==Preferences==


The preferences for the Addon manager can be found in the [[Preferences_Editor#Addon_Manager|Preferences Editor]]. {{Version|0.20}}
# Drücke die {{Button|[[Image:Preferences-general.svg|16px]] Konfigurieren... }} Schaltfläche.
# Das Dialogfeld Erweiterungsverwalteroptionen wird geöffnet.
# Prüfe wahlweise die {{CheckBox|TRUE|Automatisch beim Start nach Updates suchen (erfordert GitPython)}} Kontrollkästchen.
# Wahlweise Repositorien zur Liste '''Benutzerdefinierte Repositorien''' hinzufügen. Erweiterungen von diesen Repositorien werden auf dem [[Image:Folder.svg|16px]] '''Arbeitsbereiche''' Reiter oder die [[Image:Applications-python.svg|16px]] '''Makros''' Reiter hinzugefügt.
# Wähle optional Proxy Einstellungen.
# Drücke die {{Button|OK}} Schaltfläche oder die {{Button|Abbrechen}} Schaltfläche, um das Dialogfeld zu schließen.


==Hinweise==
==Hinweise==


<div class="mw-translate-fuzzy">
* Die Verwendung von Erweiterungen ist nicht auf die FreeCAD Version beschränkt, aus der sie installiert wurden. Du kannst sie auch in jeder anderen FreeCAD Version verwenden, die von der Erweiterung unterstützt wird und die du möglicherweise auf deinem System hast.
* Die Verwendung von Erweiterungen ist nicht auf die FreeCAD Version beschränkt, aus der sie installiert wurden. Du kannst sie auch in jeder anderen FreeCAD Version verwenden, die von der Erweiterung unterstützt wird und die du möglicherweise auf deinem System hast.
* Die im Erweiterungsverwalter verfügbaren Erweiterungen sind nicht Teil des offiziellen FreeCAD Programms und werden vom FreeCAD Kernentwicklungsteam nicht unterstützt. Du solltest die bereitgestellten Informationen sorgfältig lesen, um sicherzustellen, daß du weißt, was du installierst.
* Die im Erweiterungsverwalter verfügbaren Erweiterungen sind nicht Teil des offiziellen FreeCAD Programms und werden vom FreeCAD Kernentwicklungsteam nicht unterstützt. Du solltest die bereitgestellten Informationen sorgfältig lesen, um sicherzustellen, daß du weißt, was du installierst.
Line 71: Line 71:
* Wenn das [https://github.com/gitpython-developers/GitPython GitPython] Paket auf deinem Computer installiert ist, wird der Erweiterungsverwalter davon Gebrauch machen, was das Herunterladen beschleunigt.
* Wenn das [https://github.com/gitpython-developers/GitPython GitPython] Paket auf deinem Computer installiert ist, wird der Erweiterungsverwalter davon Gebrauch machen, was das Herunterladen beschleunigt.
* Du kannst Erweiterungen auch manuell installieren. Siehe [[How_to_install_additional_workbenches/de|Wie man zusätzliche Arbeitsbereiche installiert]] und [[How_to_install_macros/de|Wie man Makros installiert]].
* Du kannst Erweiterungen auch manuell installieren. Siehe [[How_to_install_additional_workbenches/de|Wie man zusätzliche Arbeitsbereiche installiert]] und [[How_to_install_macros/de|Wie man Makros installiert]].
</div>


==Informationen für Entwickler==
==Informationen für Entwickler==


See [[Addon#Information_for_developers|Addon]].
Wenn du einen Arbeitsbereich oder ein Makro entwickelt hast und es im Erweiterungsverwalter sehen möchtest, lies auf den Repositoriumsseiten ([https://github.com/FreeCAD/FreeCAD-addons/ FreeCAD-Erweiterungen] und [https://github.com/FreeCAD/FreeCAD-macros/ FreeCAD-Makros]), was zu tun ist. Wenn du dein Makro zu den [[Macros recipes/de|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 Addon-Manager hinzugefügt wird. Außerdem, da dein Addon außerhalb des FreeCAD-Quellcodes liegt, kannst du seine Lizenz frei wählen.
Wenn du darum anfragst, dass dein Arbeitsbereich in die vorgegebene Liste des Addon-Managers 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 eines Themas im [https://github.com/FreeCAD/FreeCAD-addons/ FreeCAD-Erweiterungen]-Repositorium, bleibt dein Code in deinem eigenen git-Repositorium, wir fügen ihn einfach als Untermodul zum [https://github.com/FreeCAD/FreeCAD-addons/ FreeCAD-Erweiterungen]-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.
Für mehr Details bezüglich des Strukturierens von Addons, einschließlich der Informationen über Metadaten, die der Addon-Manager verwendet; siehe [[Workbench_creation/de|Arbeitsbereich erstellen]].

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




Line 98: Line 89:
{{Std Base navi{{#translation:}}}}
{{Std Base navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{clear}}

Revision as of 08:43, 9 September 2022

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. Mit dem Erweiterungsverwalter kannst du externe Arbeitsbereiche und Makros, die von der FreeCAD Gemeinschaft bereitgestellt werden, installieren und verwalten. Die verfügbaren Arbeitsbereiche und Makros stammen aus zwei Repositorien, FreeCAD-addons und FreeCAD-macros, sowie von der Makrosrezepte Seite.

Aufgrund von Änderungen an der GitHub Plattform im Jahr 2020 funktioniert der Erweiterungsverwalter nicht mehr, wenn du FreeCAD Version 0.17 oder früher verwendest. Du musst auf die Version 0.18.5 oder eine neuere Version 0.19 aktualisieren. Alternativ kannst du Erweiterungen auch manuell installieren, siehe Hinweise unten.

Anwendung

  1. Wähle die Werkzeuge → Erweiterungsverwalter Option aus dem Menü.
  2. Wenn du den Erweiterungsverwalter zum ersten Mal verwendest, wird ein Dialogfeld geöffnet, das dich darauf hinweist, dass die Erweiterungen im Erweiterungsverwalter nicht offiziell Teil von FreeCAD sind. Drücke die OK Schaltfläche, um zu bestätigen und fortzufahren.
  3. Das Dialogfeld des Erweiterungsverwalters öffnet sich. Für weitere Informationen siehe Optionen.
  4. Die Alles aktualisieren Schaltfläche funktioniert zur Zeit nicht.
  5. Drücke die Schließen Schaltfläche, um das Dialogfeld zu schließen.
  6. Wenn du einen Arbeitsbereich installiert oder aktualisiert hast, wird ein neues Dialogfeld geöffnet, das dich darauf hinweist, dass du FreeCAD neu starten musst, damit die Änderungen wirksam werden.

Optionen

  1. The Addon manager provides two view layouts: "Condensed" and "Expanded". In "Condensed" view, each addon takes a single line, and its description is truncated to fit the available space. "Expanded" shows additional details, including more of the description text as well as maintainer information, more installation details, etc.
  2. Three different types of addons are supported: workbenches, macros, and preference packs. You can choose to show just one type, or all of them in a single list.
  3. The list can be limited to show just installed packages, just packages with available updates, or just packages that are not yet installed.
  4. The list can be filtered, searching for a keyword in the title, description, and tags (description and tags must be specified by the addon developer in their addon's metadata). The filter can even be a regular expression, for fine-grained control of the exact search term.
  5. The expanded view shows available version information, description, maintainer information, and installation version information, for packages that provide a package metadata file (or for macros with embedded metadata).
  6. Addon data is cached locally, with a variable cache update frequency set in the user preferences.
  7. At any time you can choose to manually update your local cache to see the latest updates available for each addon.
  8. Update checks may be set up to be automatic, or done manually via a button click (configured in user preferences). If GitPython and git are installed on your system then update information is fetched using git. If not, then update information is obtained from any present metadata file.

Clicking on an addon in this view brings up the addon's Details page:

The details page shows buttons allowing installing, uninstalling, updating, and temporarily disabling an addon. For installed addons it lists the currently installed version and the installation date, and whether that is the most recent version available. Below is an embedded web browser window showing the addon's README page (for workbenches and preference packs), or Wiki page (for macros).

Preferences

The preferences for the Addon manager can be found in the Preferences Editor. introduced in version 0.20

Hinweise

  • Die Verwendung von Erweiterungen ist nicht auf die FreeCAD Version beschränkt, aus der sie installiert wurden. Du kannst sie auch in jeder anderen FreeCAD Version verwenden, die von der Erweiterung unterstützt wird und die du möglicherweise auf deinem System hast.
  • Die im Erweiterungsverwalter verfügbaren Erweiterungen sind nicht Teil des offiziellen FreeCAD Programms und werden vom FreeCAD Kernentwicklungsteam nicht unterstützt. Du solltest die bereitgestellten Informationen sorgfältig lesen, um sicherzustellen, daß du weißt, was du installierst.
  • Fehlerberichte und Funktionenanfragen sollten direkt an den Ersteller der Erweiterung gerichtet werden, durch Besuch der angegebene Webseite. Viele Erweiterungsentwickler sind regelmäßige Nutzer des FreeCAD Forums, und können dort auch kontaktiert werden.
  • Wenn das GitPython Paket auf deinem Computer installiert ist, wird der Erweiterungsverwalter davon Gebrauch machen, was das Herunterladen beschleunigt.
  • Du kannst Erweiterungen auch manuell installieren. Siehe Wie man zusätzliche Arbeitsbereiche installiert und Wie man Makros installiert.

Informationen für Entwickler

See Addon.