{"id":11561,"date":"2025-11-05T16:28:15","date_gmt":"2025-11-05T16:28:15","guid":{"rendered":"https:\/\/www.sweethome3d.com\/anleitung-fuer-plug-in-entwickler\/"},"modified":"2025-12-19T10:19:36","modified_gmt":"2025-12-19T10:19:36","slug":"anleitung-fuer-plug-in-entwickler","status":"publish","type":"page","link":"https:\/\/www.sweethome3d.com\/de\/anleitung-fuer-plug-in-entwickler\/","title":{"rendered":"Anleitung f\u00fcr Plug-in-Entwickler"},"content":{"rendered":"\n

Einf\u00fchrung<\/h2>\n\n

Ab Version 1.5 ist es m\u00f6glich, Sweet Home 3D<\/a> mit Plug-in-Dateien, die sich in Ihrem Plug-in-Ordner<\/a> befinden, neue Funktionen hinzuzuf\u00fcgen. Dies erm\u00f6glicht es Java-Programmierern, neue Funktionen f\u00fcr Sweet Home 3D<\/a> zu entwickeln und zu verteilen, ohne die Quelldateien der aktuellen Version zu ver\u00e4ndern (was gut f\u00fcr die Aufw\u00e4rtskompatibilit\u00e4t ist) und ohne eine Vollversion des Programms auszuliefern (was gut f\u00fcr die Liefergr\u00f6\u00dfe ist).Dieses Dokument beschreibt die Werkzeuge<\/a>, die zur Erstellung von Plug-ins ben\u00f6tigt werden, und zeigt dann, wie man ein Plug-in programmiert<\/a>, das das maximale Volumen der beweglichen M\u00f6bel berechnet, die einem Haus hinzugef\u00fcgt wurden, und gibt schlie\u00dflich einige zus\u00e4tzliche Informationen<\/a>, die Ihnen helfen werden, weiterzukommen. <\/p>\n\n

<\/div>\n\n

Installation von Entwicklungswerkzeugen<\/h2>\n\n

Wenn Sweet Home 3D ein allgemeines Publikum anspricht, erfordert die Entwicklung von Plug-ins spezielle Kenntnisse, und Sie sollten wissen, wie man in Java<\/a> mit einer IDE<\/a> programmiert, bevor Sie fortfahren. Diese Anleitung zeigt, wie man ein Plug-in mit Eclipse<\/a> erstellt, aber Sie k\u00f6nnen die IDE Ihrer Wahl oder gar keine IDE verwenden. <\/p>\n\n

Eclipse herunterladen und installieren<\/h3>\n\n

Laden Sie zuerst Eclipse von https:\/\/www.eclipse.org\/<\/a> herunter. Die Version mit dem Namen Eclipse IDE for Java Developers<\/em> reicht aus, um ein Plug-in zu entwickeln, aber Sie k\u00f6nnen jede Version f\u00fcr die Java-Entwicklung herunterladen. Nach dem Herunterladen ist die Installation von Eclipse sehr einfach: Entpacken Sie einfach das Archiv, das Sie erhalten, \u00f6ffnen Sie den Eclipse-Ordner und f\u00fchren Sie je nach System die Datei mit dem Namen aus eclipse.exe<\/code> (unter Windows), eclipse.app<\/code> (unter Mac OS X) oder eclipse<\/code> (unter Linux).Beim ersten Start fordert Eclipse Sie auf, einen Arbeitsbereichsordner<\/em> auszuw\u00e4hlen, in dem Plug-in-Projekte gespeichert werden.W\u00e4hlen Sie anschlie\u00dfend Datei > Neu > Projekt<\/em> aus dem Men\u00fc, um ein neues Projekt zu erstellen, w\u00e4hlen Sie Java > Java-Projekt<\/em> im Assistent f\u00fcr neue Projekte<\/em>, der angezeigt wird, geben Sie VolumePlugin als Projektnamen ein und klicken Sie auf die Schaltfl\u00e4che Fertigstellen<\/em>. Schlie\u00dfen Sie abschlie\u00dfend die Registerkarte Willkommen<\/em>, um Ihren Arbeitsbereich wie in Abbildung 1 dargestellt zu entdecken. <\/p>\n\n

\n
\"\"
Abbildung 1. Eclipse-Arbeitsbereich <\/figcaption><\/figure>\n<\/div>\n\n

Sweet Home 3D-Bibliothek herunterladen und installieren<\/h3>\n\n

Die Entwicklung eines Plug-ins basiert auf einigen Klassen von Sweet Home 3D, die Eclipse kennen muss, um Ihr Projekt erstellen zu k\u00f6nnen. Der einfachste Weg, Sweet Home 3D-Klassen zu Eclipse hinzuzuf\u00fcgen, ist das Herunterladen der ausf\u00fchrbaren JAR-Version von Sweet Home 3D, die unter https:\/\/sourceforge.net\/projects\/sweethome3d\/files\/SweetHome3D\/SweetHome3D-7.5\/SweetHome3D-7.5.jar\/download<\/g> verf\u00fcgbar ist. Ziehen Sie nach dem Herunterladen die Datei SweetHome3D-7.5.jar auf das VolumePlugin<\/em>-Projektsymbol in der Ansicht Package Explorer<\/em> von Eclipse und w\u00e4hlen Sie den Eintrag Build Path > Zum Build-Pfad hinzuf\u00fcgen<\/em> im Kontextmen\u00fc der Datei SweetHome3D-7.5.jar, wie in Abbildung 2 dargestellt. <\/p>\n\n

\n
\"\"
Abbildung 2. Hinzuf\u00fcgen von SweetHome3D-7.5.jar zum Build-Pfad <\/figcaption><\/figure>\n<\/div>\n\n

Programmierung eines Plug-ins<\/h2>\n\n

Nachdem Sie die erforderlichen Werkzeuge installiert haben, wollen wir sehen, wie Sie Ihr erstes Plug-in f\u00fcr Sweet Home 3D programmieren k\u00f6nnen.<\/p>\n\n

Erstellung der Plug-in-Klasse<\/h3>\n\n

Erstellen Sie zun\u00e4chst eine neue Unterklasse von com.eteks.sweethome3d.plugin.Plugin, indem Sie den Men\u00fcpunkt Datei > Neu > Klasse<\/em> in Eclipse ausw\u00e4hlen.<\/p>\n\n

\n
\"\"
Abbildung 3. Erstellung einer neuen Klasse <\/figcaption><\/figure>\n<\/div>\n\n

Geben Sie im Dialogfeld Neue Java-Klasse<\/em> VolumePlugin als Klassennamen ein, geben Sie ein Paket ein (hier wurde das Paket com.eteks.test gew\u00e4hlt) und w\u00e4hlen Sie com.eteks.sweethome3d.plugin.Plugin als Superklasse von VolumePlugin. Klicken Sie anschlie\u00dfend auf Fertigstellen<\/em>. Eclipse erstellt die Datei der neuen Klasse mit folgendem Inhalt: <\/p>\n\n

package com.eteks.test;import com.eteks.sweethome3d.plugin.Plugin;import com.eteks.sweethome3d.plugin.PluginAction;public class VolumePlugin<\/strong> extends Plugin<\/strong> { @Override public PluginAction[] getActions<\/strong>() { \/\/ TODO Auto-generated method stub return null; }}<\/pre>\n\n
Wie Sie aus dem TODO-Kommentar erraten k\u00f6nnen, m\u00fcssen Sie nun die Implementierung der Methode getActions \u00e4ndern, um eine Plug-in-Aktion zur\u00fcckzugeben, die in der Lage ist, das Volumen der beweglichen M\u00f6bel zu berechnen. Ersetzen Sie return null; durch die folgende Anweisung: <\/p>\n\n
  return new PluginAction<\/strong> [] {new VolumeAction<\/strong>()};  <\/pre>\n\n
und w\u00e4hlen Sie Edition > Schnellkorrektur<\/em> aus dem Eclipse-Men\u00fc, um die fehlende Klasse VolumeAction zu erstellen, wie in Abbildung 4 dargestellt.<\/p>\n\n
\n
\"\"
Abbildung 4. Verwenden der Schnellkorrektur, um eine fehlende Klasse zu generieren <\/figcaption><\/figure>\n<\/div>\n\n
Aktivieren Sie im Dialogfeld Neue Java-Klasse<\/em>, das angezeigt wird, das Kontrollk\u00e4stchen Umschlie\u00dfender Typ<\/em>, um eine innere Klasse von VolumePlugin zu erstellen, und klicken Sie auf Fertigstellen<\/em>. Dadurch wird die Klasse VolumeAction erstellt, die von der Klasse com.eteks.sweethome3d.plugin.PluginAction erbt und eine leere Execute-Methode enth\u00e4lt: <\/p>\n\n
  public class VolumeAction<\/strong> extends PluginAction<\/strong> { @Override public void execute<\/strong>() { \/\/ TODO Auto-generated method stub } }<\/pre>\n\n
Diese Methode ist diejenige, die Sweet Home 3D aufruft, wenn der Benutzer die Plug-in-Aktion startet; dies ist also der Ort, an dem Sie implementieren m\u00fcssen, wie das Volumen der M\u00f6bel berechnet und angezeigt wird:<\/p>\n\n
  public class VolumeAction<\/strong> extends PluginAction<\/strong> {    @Override  public void execute<\/strong>() {   float volumeInCm3 = 0; \/\/ Compute the sum of the volume of the bounding box of  \/\/ each movable piece of furniture in home for (PieceOfFurniture piece : getHome<\/strong>(). getFurniture<\/strong>()) { if (piece. isMovable<\/strong>()) { volumeInCm3 += piece. getWidth<\/strong>()  * piece. getDepth<\/strong>()  * piece. getHeight<\/strong>();  } }             \/\/ Display the result in a message box (\u00b3 is for 3 in supercript) String message = String. format<\/strong>( \"The maximum volume of the movable furniture in home is %.2f m\u00b3.\",  volumeInCm3 \/ 1000000); JOptionPane. showMessageDialog<\/strong>(null, message);  }  }<\/pre>\n\n
Nachdem Sie nun festgelegt haben, was das Plug-in tun soll, m\u00fcssen Sie beschreiben, wie der Benutzer diese neue Aktion starten wird. Sie haben die Wahl zwischen dem Hinzuf\u00fcgen eines neuen Men\u00fcpunkts<\/strong> zu einem Men\u00fc und\/oder einer neuen Schaltfl\u00e4che<\/strong> zur Werkzeugleiste. Diese Wahl wird durch das Setzen der entsprechenden Eigenschaften der Plug-in-Aktion bei ihrer Erstellung getroffen. Wenn Sie beispielsweise m\u00f6chten, dass die Benutzer die Volumenaktion mit dem Men\u00fcpunkt Volumen berechnen<\/em> im Men\u00fc Werkzeuge<\/em> starten, f\u00fcgen Sie der VolumnAction-Klasse den folgenden Konstruktor hinzu:   <\/p>\n\n
  public VolumeAction<\/strong>() {           putPropertyValue<\/strong>(Property.NAME, \"Compute volume\");           putPropertyValue<\/strong>(Property.MENU, \"Tools\"); \/\/ Enables the action by default           setEnabled<\/strong>(true); }<\/pre>\n\n
Die Plug-in-Klasse VolumePlugin<\/a> ist nun programmiert und fast bereit, als Plug-in in Sweet Home 3D zu arbeiten. Die beiden letzten Dinge, die zu tun sind, sind: <\/p>\n\n