{"id":3607,"date":"2025-10-03T22:23:34","date_gmt":"2025-10-03T20:23:34","guid":{"rendered":"https:\/\/davidka.net\/?p=3607"},"modified":"2025-10-24T12:41:28","modified_gmt":"2025-10-24T09:41:28","slug":"lektion-2-dein-erstes-addon-hello-world","status":"publish","type":"post","link":"http:\/\/de.davidka.net\/de\/lektion-2-dein-erstes-addon-hello-world\/","title":{"rendered":"Lektion 2. Dein erstes Addon: \u201eHello World\u201c"},"content":{"rendered":"\n

Tutorial: Erstellen von Addons f\u00fcr FreeCAD<\/strong><\/p>\n\n\n\n

Lernziel:<\/strong> Erstelle ein einfaches Addon, das eine neue Arbeitsumgebung mit einer Schaltfl\u00e4che hinzuf\u00fcgt und beim Klicken eine Nachricht anzeigt.<\/p>\n\n\n\n

\n\n\n\n

Schritt 1. Vorbereitung des Addon-Ordners<\/strong>
Stelle sicher, dass du folgenden Ordner hast:<\/p>\n\n\n\n

...\/FreeCAD\/Mod\/HelloWorldAddon\/<\/code><\/pre>\n\n\n\n

Falls nicht \u2013 erstelle ihn.<\/p>\n\n\n\n
Der Ordnername ist wichtig: Er muss mit dem Modulnamen im Code \u00fcbereinstimmen.
Wir verwenden HelloWorldAddon<\/code>.<\/p>\n\n\n\n
Erstelle in diesem Ordner zwei Dateien:<\/p>\n\n\n\n
    \n
  • InitGui.py<\/code><\/li>\n\n\n\n
  • hello_workbench.py<\/code><\/li>\n<\/ul>\n\n\n\n
    Wichtig:<\/strong> Verwende keine Leerzeichen oder kyrillische Zeichen<\/strong> in Datei- und Ordnernamen!<\/p>\n\n\n\n
    \n\n\n\n
    Schritt 2. Datei InitGui.py<\/code> \u2013 Einstiegspunkt<\/strong>
    Diese Datei wird von FreeCAD beim Start automatisch ausgef\u00fchrt, wenn sie sich im Addon-Ordner befindet.<\/p>\n\n\n\n
    \u00d6ffne sie in einem Editor und f\u00fcge folgenden Code ein:<\/p>\n\n\n\n
    # InitGui.py\nimport FreeCADGui\nfrom HelloWorldAddon.hello_workbench import HelloWorldWorkbench\n\nFreeCADGui.addWorkbench(HelloWorldWorkbench())<\/code><\/pre>\n\n\n\n
    Was macht dieser Code?<\/strong><\/p>\n\n\n\n
      \n
    1. Importiert unsere Arbeitsumgebung aus der Datei hello_workbench.py<\/code><\/li>\n\n\n\n
    2. Registriert sie in der FreeCAD-Oberfl\u00e4che \u00fcber FreeCADGui.addWorkbench()<\/code><\/li>\n<\/ol>\n\n\n\n
      Hinweis:<\/strong>
      from HelloWorldAddon.hello_workbench<\/code> \u2013 hier ist HelloWorldAddon<\/code> der Ordnername und hello_workbench<\/code> der Dateiname ohne<\/strong> die Erweiterung .py<\/code>.<\/p>\n\n\n\n
      \n\n\n\n
      Schritt 3. Datei hello_workbench.py<\/code> \u2013 Addon-Logik<\/strong>
      Nun erstellen wir die Arbeitsumgebung selbst.<\/p>\n\n\n\n
      F\u00fcge folgenden Code in hello_workbench.py<\/code> ein:<\/p>\n\n\n\n
      # hello_workbench.py\nimport FreeCAD, FreeCADGui\nfrom PySide import QtGui\n\n# === BEFEHL: Was passiert beim Klick auf die Schaltfl\u00e4che? ===\nclass HelloWorldCommand:\n    def GetResources(self):\n        """Gibt Daten zur Anzeige des Befehls zur\u00fcck"""\n        return {\n            "MenuText": "Sag Hallo",        # Text im Men\u00fc\n            "ToolTip": "Zeige eine Begr\u00fc\u00dfung",  # Tooltip\n            "Pixmap": ""                    # Pfad zum Symbol (zun\u00e4chst leer)\n        }\n\n    def Activated(self):\n        """Wird aufgerufen, wenn die Schaltfl\u00e4che geklickt wird"""\n        QtGui.QMessageBox.information(\n            None,\n            "FreeCAD Addon",\n            "Hallo Welt!\\nDu hast gerade dein erstes Addon gestartet!"\n        )\n\n    def IsActive(self):\n        """Wann ist der Befehl verf\u00fcgbar? (hier: immer \u2192 True)"""\n        return True\n\n# === ARBEITSUMGEBUNG: fasst Befehle zusammen ===\nclass HelloWorldWorkbench(FreeCADGui.Workbench):\n    # Name, der in der Liste angezeigt wird\n    MenuText = "Hello World"\n    ToolTip = "Meine erste Arbeitsumgebung"\n\n    def Initialize(self):\n        """Wird aufgerufen, wenn die Arbeitsumgebung aktiviert wird"""\n        # Liste der Befehlsnamen\n        self.list = ["HelloWorldCommand"]\n        # Symbolleiste hinzuf\u00fcgen\n        self.appendToolbar("Hello Tools", self.list)\n        # Men\u00fceintrag hinzuf\u00fcgen\n        self.appendMenu("Hello World", self.list)\n\n    def GetClassName(self):\n        """Erforderliche Methode f\u00fcr Python-Arbeitsumgebungen"""\n        return "Gui::PythonWorkbench"\n\n# === BEFEHLSREGISTRIERUNG ===\nFreeCADGui.addCommand("HelloWorldCommand", HelloWorldCommand())<\/code><\/pre>\n\n\n\n
      \n\n\n\n
      Code-Analyse nach Komponenten:<\/strong><\/p>\n\n\n\n
        \n
      1. Befehl (HelloWorldCommand<\/code>)<\/strong><\/li>\n<\/ol>\n\n\n\n
          \n
        • GetResources()<\/code> \u2013 beschreibt, wie der Befehl in der Oberfl\u00e4che erscheint<\/li>\n\n\n\n
        • Activated()<\/code> \u2013 definiert, was beim Klick geschieht<\/li>\n\n\n\n
        • IsActive()<\/code> \u2013 legt fest, wann die Schaltfl\u00e4che aktiv ist (z.\u202fB. nur bei ge\u00f6ffnetem Dokument)<\/li>\n<\/ul>\n\n\n\n
            \n
          1. Arbeitsumgebung (HelloWorldWorkbench<\/code>)<\/strong><\/li>\n<\/ol>\n\n\n\n
              \n
            • Erbt von FreeCADGui.Workbench<\/code><\/li>\n\n\n\n
            • Die Methode Initialize()<\/code> f\u00fcgt Befehle zur Symbolleiste und zum Men\u00fc hinzu<\/li>\n\n\n\n
            • GetClassName()<\/code> teilt FreeCAD mit: \u201eDies ist eine Python-Arbeitsumgebung\u201c<\/li>\n<\/ul>\n\n\n\n
                \n
              1. Registrierung<\/strong><\/li>\n<\/ol>\n\n\n\n
                  \n
                • FreeCADGui.addCommand()<\/code> verkn\u00fcpft den Namen "HelloWorldCommand"<\/code> mit der Klasse<\/li>\n<\/ul>\n\n\n\n
                  \n\n\n\n
                  Schritt 4. Funktionspr\u00fcfung<\/strong><\/p>\n\n\n\n
                    \n
                  1. Speichere beide Dateien<\/li>\n\n\n\n
                  2. Starte FreeCAD neu<\/li>\n\n\n\n
                  3. W\u00e4hle in der Arbeitsumgebung-Auswahl \u201eHello World\u201c<\/strong><\/li>\n\n\n\n
                  4. Klicke auf die Schaltfl\u00e4che \u201eSag Hallo\u201c<\/strong><\/li>\n<\/ol>\n\n\n\n
                    Ein Fenster mit der Nachricht \u201eHallo Welt!\u201c<\/strong> sollte erscheinen.<\/p>\n\n\n\n
                    \n\n\n\n
                    Praktische Aufgabe<\/strong><\/p>\n\n\n\n
                      \n
                    1. \u00c4ndere den angezeigten Text.<\/li>\n\n\n\n
                    2. F\u00fcge ein zweites Kommando hinzu \u2013 z.\u202fB. \u201eZeige Datum\u201c<\/strong>, das das aktuelle Datum anzeigt.<\/li>\n\n\n\n
                    3. Experimentiere mit IsActive()<\/code> \u2013 lasse die Schaltfl\u00e4che z.\u202fB. nur aktiv sein, wenn ein Dokument ge\u00f6ffnet ist:<\/li>\n<\/ol>\n\n\n\n
                         def IsActive(self):\n       return FreeCAD.ActiveDocument is not None<\/code><\/pre>\n\n\n\n
                      \n\n\n\n
                      Was kommt als N\u00e4chstes?<\/strong>
                      In Lektion 3<\/strong> werden wir:<\/p>\n\n\n\n
                        \n
                      • Lernen, wie man echte 3D-Objekte (Quader, Zylinder) per Python erstellt<\/li>\n\n\n\n
                      • Die Dokumentenstruktur von FreeCAD verstehen<\/li>\n\n\n\n
                      • Ein Addon bauen, das parametrische K\u00f6rper erzeugt<\/li>\n<\/ul>\n\n\n\n
                        Damit beginnt die echte CAD-Entwicklung!<\/p>\n\n\n\n
                        <\/p>\n","protected":false},"excerpt":{"rendered":"
                        Lernziel: Erstelle ein einfaches Addon, das eine neue Arbeitsumgebung mit einer Schaltfl\u00e4che hinzuf\u00fcgt und beim Klicken eine Nachricht anzeigt.<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"neve_meta_sidebar":"","neve_meta_container":"","neve_meta_enable_content_width":"","neve_meta_content_width":0,"neve_meta_title_alignment":"","neve_meta_author_avatar":"","neve_post_elements_order":"","neve_meta_disable_header":"","neve_meta_disable_footer":"","neve_meta_disable_title":"","_themeisle_gutenberg_block_has_review":false,"footnotes":""},"categories":[],"tags":[],"class_list":["post-3607","post","type-post","status-publish","format-standard","hentry"],"_links":{"self":[{"href":"https:\/\/de.davidka.net\/de\/wp-json\/wp\/v2\/posts\/3607","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/de.davidka.net\/de\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/de.davidka.net\/de\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/de.davidka.net\/de\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/de.davidka.net\/de\/wp-json\/wp\/v2\/comments?post=3607"}],"version-history":[{"count":0,"href":"https:\/\/de.davidka.net\/de\/wp-json\/wp\/v2\/posts\/3607\/revisions"}],"wp:attachment":[{"href":"https:\/\/de.davidka.net\/de\/wp-json\/wp\/v2\/media?parent=3607"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/de.davidka.net\/de\/wp-json\/wp\/v2\/categories?post=3607"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/de.davidka.net\/de\/wp-json\/wp\/v2\/tags?post=3607"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}