Instalaci\u00f3n de herramientas de desarrollo<\/h2>\n\n
Si Sweet Home 3D est\u00e1 dirigido a un p\u00fablico general, el desarrollo de plug-ins requiere habilidades especiales, y debe saber programar en Java<\/a> con un IDE<\/a> antes de seguir adelante. Esta gu\u00eda muestra c\u00f3mo construir un plug-in con Eclipse<\/a>, pero puede utilizar el IDE de su elecci\u00f3n, o ninguno. <\/p>\n\n Primero, descargue Eclipse desde https:\/\/www.eclipse.org\/<\/a>. La versi\u00f3n llamada Eclipse IDE for Java Developers<\/em> es suficiente para desarrollar un plug-in, pero puede descargar cualquier versi\u00f3n para el desarrollo de Java. El desarrollo de un plug-in se basa en algunas clases de Sweet Home 3D que Eclipse debe conocer para poder construir su proyecto. La forma m\u00e1s f\u00e1cil de a\u00f1adir clases de Sweet Home 3D a Eclipse es descargar la versi\u00f3n JAR ejecutable de Sweet Home 3D disponible en https:\/\/sourceforge.net\/projects\/sweethome3d\/files\/SweetHome3D\/SweetHome3D-7.5\/SweetHome3D-7.5.jar\/download<\/a>. Una vez descargado, arrastre y suelte el archivo SweetHome3D-7.5.jar en el icono del proyecto VolumePlugin<\/em> en la vista Package Explorer<\/em> de Eclipse, y elija el elemento Build Path > Add to Build Path<\/em> en el men\u00fa contextual del archivo SweetHome3D-7.5.jar, como se muestra en la figura 2. <\/p>\n\n Ahora que ha instalado las herramientas necesarias, veamos c\u00f3mo puede programar su primer plug-in para Sweet Home 3D.<\/p>\n\n En primer lugar, cree una nueva subclase de com.eteks.sweethome3d.plugin.Plugin eligiendo el elemento de men\u00fa File > New > Class<\/em> en Eclipse.<\/p>\n\n En el di\u00e1logo New Java Class<\/em>, introduzca VolumePlugin como nombre de la clase, introduzca un paquete (aqu\u00ed el paquete elegido fue com.eteks.test) y elija com.eteks.sweethome3d.plugin.Plugin como la superclase de VolumePlugin. Una vez hecho esto, haga clic en Finish<\/em>. Eclipse crear\u00e1 el archivo de la nueva clase con el siguiente contenido: <\/p>\n\n Como puede adivinar por el comentario TODO, ahora debe cambiar la implementaci\u00f3n del m\u00e9todo getActions para que devuelva una acci\u00f3n de plug-in capaz de calcular el volumen de los muebles m\u00f3viles. Sustituya return null; por la siguiente declaraci\u00f3n: <\/p>\n\n y elija Edition > Quick Fix<\/em> en el men\u00fa de Eclipse para crear la clase VolumeAction que falta, como se muestra en la figura 4.<\/p>\n\n En el di\u00e1logo New Java Class<\/em> que aparece, seleccione la casilla de verificaci\u00f3n Enclosing type<\/em> para crear una clase interna de VolumePlugin y haga clic en Finish<\/em>. Esto crear\u00e1 la clase VolumeAction que hereda de la clase com.eteks.sweethome3d.plugin.PluginAction y contiene un m\u00e9todo execute vac\u00edo: <\/p>\n\n Este m\u00e9todo es el que Sweet Home 3D llamar\u00e1 cuando el usuario inicie la acci\u00f3n del plug-in; por lo tanto, este es el lugar donde debe implementar c\u00f3mo calcular el volumen de los muebles y mostrarlo:<\/p>\n\n Ahora que ha especificado lo que quiere que haga el plug-in, debe describir c\u00f3mo el usuario iniciar\u00e1 esta nueva acci\u00f3n. Tiene la opci\u00f3n de a\u00f1adir un nuevo elemento de men\u00fa<\/strong> a un men\u00fa, y\/o un nuevo bot\u00f3n<\/strong> a la barra de herramientas. Esta elecci\u00f3n se realiza estableciendo las propiedades apropiadas de la acci\u00f3n del plug-in en su creaci\u00f3n. Por ejemplo, si quiere que los usuarios inicien la acci\u00f3n de volumen con el elemento de men\u00fa Compute volume<\/em> que se encuentra en el men\u00fa Tools<\/em>, a\u00f1adir\u00e1 el siguiente constructor a la clase VolumnAction: <\/p>\n\n La clase de plug-in VolumePlugin<\/a> ya est\u00e1 programada y casi lista para funcionar como un plug-in en Sweet Home 3D. Las dos \u00faltimas cosas que hay que hacer son: <\/p>\n\n Un archivo ApplicationPlugin.properties<\/tt>\n describe el nombre del plug-in, su clase, las versiones m\u00ednimas de Sweet Home 3D y Java bajo las que se soporta,\n y aspectos legales. Elija File > New > File<\/i> en el men\u00fa\n de Eclipse, introduzca el nombre de archivo ApplicationPlugin.properties<\/tt> y haga clic en Finish<\/i>, como se muestra\n en la figura 5. <\/p>\n\n A continuaci\u00f3n, introduzca la siguiente descripci\u00f3n<\/a> en el nuevo archivo y gu\u00e1rdelo:<\/p>\n\n El JAR del plug-in contiene los archivos class<\/tt> creados a partir de la compilaci\u00f3n del archivo VolumePlugin.java<\/tt>,\n y el archivo ApplicationPlugin.properties<\/tt>. Como Eclipse compila un archivo Java tan pronto como lo guarda, solo tiene que elegir File > Export…<\/i> en el men\u00fa y seleccionar Java > JAR file<\/i> en el di\u00e1logo Export<\/i>\n que se mostrar\u00e1. En el asistente Jar Export<\/i> que aparece como se muestra en la figura 6, seleccione la casilla de verificaci\u00f3n del proyecto\n e introduzca la ruta de un archivo JAR colocado en la carpeta de plug-ins de Sweet Home 3D. Esta carpeta apropiada depende\n de su sistema de la siguiente manera: <\/p>\n\n El plug-in<\/a> que ha desarrollado se ejecutar\u00e1 en Sweet Home 3D, ya sea con la versi\u00f3n de Java Web Start<\/a>, la versi\u00f3n de instaladores<\/a> o el archivo SweetHome3D-7.5.jar<\/a> que descarg\u00f3 anteriormente. Como este \u00faltimo es un JAR ejecutable, puede ejecutarlo haciendo doble clic en \u00e9l o con el siguiente comando: <\/p>\n\n El plug-in<\/a> que ha desarrollado se ejecutar\u00e1 en Sweet Home 3D, ya sea con la versi\u00f3n de Java Web Start<\/a>, la versi\u00f3n de instaladores<\/a> o el archivo SweetHome3D-7.5.jar<\/a> que descarg\u00f3 anteriormente. Como este \u00faltimo es un JAR ejecutable, puede ejecutarlo haciendo doble clic en \u00e9l o con el siguiente comando: <\/p>\n\n Mientras est\u00e9 probando, probablemente preferir\u00e1 ejecutar Sweet Home 3D con este comando, para poder leer en la consola el seguimiento de la pila de las excepciones lanzadas durante la ejecuci\u00f3n de su plug-in.<\/p>\n\n Una vez que se inicie Sweet Home 3D, ver\u00e1 el nuevo men\u00fa y su elemento aparecer como se muestra en la figura 7:<\/p>\n\n Si elige el nuevo elemento de men\u00fa para el ejemplo de vivienda<\/a> creado en la gu\u00eda del usuario<\/a>, obtendr\u00e1 el siguiente resultado:<\/p>\n\n Si necesita depurar su plug-in desde Eclipse, cree una configuraci\u00f3n de depuraci\u00f3n siguiendo estos pasos:<\/p>\n\n Cada vez que modifique el c\u00f3digo fuente de su plug-in, no olvide generar el JAR del plug-in<\/a> antes de iniciar la configuraci\u00f3n de depuraci\u00f3n que ha creado. Para acelerar el proceso de exportaci\u00f3n de JAR en Eclipse, vaya al segundo paso del asistente de exportaci\u00f3n de JAR y seleccione la opci\u00f3n Save the description of this JAR in the workspace<\/em>. Esto a\u00f1adir\u00e1 un nuevo elemento en el proyecto con un elemento de men\u00fa contextual Create JAR<\/em>. <\/p>\n<\/div>\n\n Una vez listo, su plug-in puede ser implementado en el ordenador de otros usuarios de Sweet Home 3D simplemente copi\u00e1ndolo en su carpeta de plug-ins<\/a>. A partir de la versi\u00f3n 1.6, un archivo de plug-in tambi\u00e9n puede instalarse en la carpeta de plug-ins de Sweet Home 3D haciendo doble clic en \u00e9l, si su extensi\u00f3n es SH3P (simplemente cambie la extensi\u00f3n del archivo de .zip a .sh3p). Si al hacer doble clic en un archivo .sh3p no se inicia Sweet Home 3D (lo m\u00e1s probable es que ocurra en Linux), tambi\u00e9n puede instalar un plug-in con el siguiente comando en una ventana de Terminal<\/em> (donde Para dejar de usar un plug-in, elimine su archivo de la carpeta de plug-ins y reinicie Sweet Home 3D.<\/p>\n\n Si quiere que su plug-in pueda ejecutarse con todos los instaladores de Sweet Home 3D<\/a> disponibles en este sitio web, tenga cuidado de mantenerlo compatible con Java 5, seleccionando La programaci\u00f3n del primer plug-in le mostr\u00f3 la imagen completa. Aqu\u00ed tiene informaci\u00f3n adicional que le ayudar\u00e1 a ir m\u00e1s all\u00e1. <\/p>\n\n La documentaci\u00f3n m\u00e1s \u00fatil para desarrollar un nuevo plugin es la API de Sweet Home 3D<\/a> (Interfaz de Programaci\u00f3n de Aplicaciones), generada con la herramienta javadoc. Sweet Home 3D se basa en una arquitectura MVC (Modelo Vista Controlador), por lo que es esencial comprender c\u00f3mo est\u00e1 organizada su capa de Modelo. La figura 13 (tambi\u00e9n disponible en formato PDF<\/a>) presenta casi todas las clases e interfaces disponibles en la versi\u00f3n 1.5 del paquete com.eteks.sweethome3d.model<\/a> que coincide con esta capa de Modelo. <\/p>\n\n [uml_diagram slug=\u00bbmodel-classes-diagram\u00bb map_name=\u00bbmodel-classes-diagram\u00bb caption=\u00bbFigure 13. UML diagram of com.eteks.sweethome3d.model package\u00bb caption_small=\u00bb(click on a class to view its javadoc)\u00bb]<\/p>\n\n La clase central en la capa de Modelo es la clase HomeApplication<\/a> (10), la superclase abstracta de la clase principal de la aplicaci\u00f3n SweetHome3D<\/a>. La instancia de esta clase da acceso a las instancias de Home<\/a> (7) que se est\u00e1n editando actualmente, y al objeto UserPreferences<\/a> (11) que almacena la unidad de longitud<\/a> en uso (12), el cat\u00e1logo de muebles<\/a> (14) y el cat\u00e1logo de texturas<\/a> (15) desde el que el usuario elige muebles<\/a> (17) y texturas<\/a> (18). Estos objetos implementan la interfaz Selectable<\/a> (1) as\u00ed como el objeto ObserverCamera<\/a> (4), que almacena la ubicaci\u00f3n de la c\u00e1mara en el modo Visitante virtual<\/em>. Se accede a toda la informaci\u00f3n externa gestionada por los objetos del Modelo, como el icono y el modelo 3D de un mueble<\/a> (16), o la imagen de una textura<\/a> (20) a trav\u00e9s de la interfaz Content<\/a> (19), implementada por la clase URLContent<\/a> y otras clases del paquete com.eteks.sweethome3d.tools<\/a>. <\/p>\n\n Este diagrama UML deber\u00eda ayudarle a comprender qu\u00e9 clases est\u00e1n disponibles en el modelo de Sweet Home 3D y c\u00f3mo puede acceder a ellas, pero probablemente notar\u00e1 que no se citan constructores ni mutadores (o setters si lo prefiere). Es solo por falta de espacio, pero puede usarlos sin problema en una clase de plugin. Tenga en cuenta tambi\u00e9n que cualquier modificaci\u00f3n de un objeto existente del modelo se notificar\u00e1 a los componentes mostrados ya sea con PropertyChangeEvent<\/a>s, con CollectionEvent<\/a>s (8) o con SelectionEvent<\/a>s (6), lo que permite que todos los cambios se reflejen inmediatamente en la pantalla. <\/p>\n\n El modelo de Sweet Home 3D no<\/strong> es seguro para subprocesos por razones de rendimiento. Todas las modificaciones<\/strong> de un objeto perteneciente al modelo deben realizarse en el hilo de despacho de eventos (Event Dispatch Thread). <\/p>\n<\/div>\n\n La arquitectura de las clases de plugin es mucho m\u00e1s sencilla de entender que la de la capa de Modelo. El paquete com.eteks.sweethome3d.plugin<\/a> contiene solo tres clases entre las que se supone que solo debe usar las clases Plugin<\/a> y PluginAction<\/a>, como se muestra en la figura 14 (tambi\u00e9n disponible en formato PDF<\/a>). <\/p>\n\n [uml_diagram slug=\u00bbplugin-classes-diagram\u00bb map_name=\u00bbplugin-classes-diagram\u00bb caption=\u00bbFigure 14. UML diagram of com.eteks.sweethome3d.plugin package\u00bb caption_small=\u00bb(click on a class to view its javadoc)\u00bb]<\/p>\n\n Se crea una instancia de PluginManager<\/a> (1) al iniciar la aplicaci\u00f3n y busca los plugins instalados en la carpeta de plugins<\/a> del usuario. Cada vez que se edita una nueva casa, este administrador crea instancias y configura un objeto Plugin<\/a> (3) para cada plugin encontrado en el momento del inicio. A continuaci\u00f3n, llama al m\u00e9todo getActions<\/a> para recuperar todas las acciones<\/a> (4) que se a\u00f1adir\u00e1n como elementos de men\u00fa y\/o botones de la barra de herramientas en la ventana de la casa. Cada acci\u00f3n es una instancia de PluginAction<\/a>, que se parece a la clase Action<\/a>, con su m\u00e9todo execute<\/a> y sus propiedades<\/a> modificables (2). <\/p>\n\n Tenga en cuenta que la clase Plugin<\/a> le da acceso a una instancia de UndoableEditSupport<\/a> a trav\u00e9s de su m\u00e9todo getUndoableEditSupport<\/a>. Tan pronto como modifique una casa o sus objetos (muebles, paredes…) en el m\u00e9todo execute de una instancia de PluginAction<\/a>, tambi\u00e9n debe publicar un objeto UndoableEdit<\/a> en el soporte de edici\u00f3n deshacible devuelto por el m\u00e9todo getUndoableEditSupport, de lo contrario, los usuarios no podr\u00e1n deshacer\/rehacer correctamente los cambios que haya realizado. <\/p>\n\n Si planea desarrollar un plugin para la comunidad de usuarios de Sweet Home 3D, intente localizar las cadenas que muestra, ya sea en el nombre de las acciones y el men\u00fa o en los di\u00e1logos que cree (o al menos prepare su localizaci\u00f3n). Dos constructores de la clase PluginAction<\/a> le ayudar\u00e1n a organizar la traducci\u00f3n de las propiedades de las acciones con archivos .properties, y si necesita traducir otras cadenas en su plugin (como la del di\u00e1logo mostrado por el plugin probado<\/a>) reutilice estos archivos .properties con la clase Java ResourceBundle<\/a>. Si quiere un ejemplo que utilice esta arquitectura, descargue el plugin Descargar e instalar Eclipse<\/h3>\n\n
eclipse.exe<\/code> (en Windows), eclipse.app<\/code> (en Mac OS X) o eclipse<\/code> (en Linux).![\"\"](\"https:\/\/www.sweethome3d.com\/wp-content\/uploads\/2025\/12\/eclipse.png\")
Descargar e instalar la biblioteca de Sweet Home 3D<\/h3>\n\n
![\"\"](\"https:\/\/www.sweethome3d.com\/wp-content\/uploads\/2025\/12\/addToBuildPath.png\")
Programaci\u00f3n de un plug-in<\/h2>\n\n
Creaci\u00f3n de la clase de plug-in<\/h3>\n\n
![\"\"](\"https:\/\/www.sweethome3d.com\/wp-content\/uploads\/2025\/12\/newJavaClass.png\")
package com.eteks.test;
return new PluginAction<\/strong> [] {new VolumeAction<\/strong>()}; <\/pre>\n\n![\"\"](\"https:\/\/www.sweethome3d.com\/wp-content\/uploads\/2025\/12\/quickFix.png\")
public class VolumeAction<\/strong> extends PluginAction<\/strong> { public class VolumeAction<\/strong> extends PluginAction<\/strong> { public VolumeAction<\/strong>() {\n
Creaci\u00f3n del archivo de descripci\u00f3n del plug-in<\/h3>\n\n
![\"\"](\"https:\/\/www.sweethome3d.com\/wp-content\/uploads\/2025\/12\/newFile.png\")
name<\/strong>=Volumen de muebles m\u00f3viles
Creaci\u00f3n del JAR del plug-in<\/h3>\n\n
\n
![\"\"](\"https:\/\/www.sweethome3d.com\/wp-content\/uploads\/2025\/12\/jarExport.png\")
Prueba del plug-in<\/h3>\n\n
java -jar \/ruta<\/em>\/a<\/em>\/SweetHome3D-7.5.jar<\/pre>\n\n
![\"\"](\"https:\/\/www.sweethome3d.com\/wp-content\/uploads\/2025\/12\/pluginMenu.png\")
![\"\"](\"https:\/\/www.sweethome3d.com\/wp-content\/uploads\/2025\/12\/pluginInAction.png\")
Depuraci\u00f3n del plug-in<\/h3>\n\n
\n
![\"\"](\"https:\/\/www.sweethome3d.com\/wp-content\/uploads\/2025\/12\/debugConfiguration.png\")
\n
![\"\"](\"https:\/\/www.sweethome3d.com\/wp-content\/uploads\/2025\/12\/classpathConfiguration.png\")
\n
![\"\"](\"https:\/\/www.sweethome3d.com\/wp-content\/uploads\/2025\/12\/sourcepathConfiguration.png\")
\n
![\"\"](\"https:\/\/www.sweethome3d.com\/wp-content\/uploads\/2025\/12\/eclipseDebug.png\")
![\"\"](\"https:\/\/www.sweethome3d.com\/wp-content\/uploads\/2025\/09\/warning-1.gif\")
<\/figure>\n\n\n\nImplementaci\u00f3n del plug-in<\/h3>\n\n
SweetHome3D<\/code> es el nombre del archivo ejecutable proporcionado con los instaladores de Sweet Home 3D):<\/p>\n\n\/ruta\/a\/<\/em>SweetHome3D \/ruta\/a\/<\/em>plugin.sh3p<\/pre>\n\n
<\/figure>\n\n\n\n1.5<\/code> en el campo Compiler compliance level<\/em> disponible en la secci\u00f3n Java Compiler<\/em> del cuadro de di\u00e1logo que muestra el elemento de men\u00fa Project > Properties<\/em> de Eclipse.javaMinimumVersion<\/code> en el archivo ApplicationPlugin.properties<\/code> de su plug-in en consecuencia.<\/p>\n<\/div>\n\nYendo m\u00e1s all\u00e1<\/h2>\n\n
API de Sweet Home 3D – Javadoc<\/h3>\n\n
Arquitectura de las clases del modelo<\/h3>\n\n
\n
![\"\"](\"https:\/\/www.sweethome3d.com\/wp-content\/uploads\/2025\/11\/Frame-281.png\")
<\/figure>\n\n\n\nArquitectura de las clases de plugin<\/h3>\n\n
Localizaci\u00f3n<\/h3>\n\n
![formato PDF<\/a>) presenta casi todas las clases e interfaces disponibles en la versi\u00f3n 1.5 del paquete](\"https:\/\/www.sweethome3d.com\/wp-content\/uploads\/2025\/12\/modelClassesDiagram.png\"){kind=link}
![formato PDF<\/a>). <\/p>\n\n[uml_diagram slug=\u00bbplugin-classes-diagram\u00bb map_name=\u00bbplugin-classes-diagram\u00bb caption=\u00bbFigure 14. UML diagram of com.eteks.sweethome3d.plugin package\u00bb caption_small=\u00bb(click on a class to view its javadoc)\u00bb]<\/p>\n\nSe crea una instancia de PluginManager<\/a> (1) al iniciar la aplicaci\u00f3n y busca los plugins instalados en la carpeta de plugins<\/a> del usuario. Cada vez que se edita una nueva casa, este administrador crea instancias y configura un objeto Plugin<\/a> (3) para cada plugin encontrado en el momento del inicio. A continuaci\u00f3n, llama al m\u00e9todo getActions<\/a> para recuperar todas las acciones<\/a> (4) que se a\u00f1adir\u00e1n como elementos de men\u00fa y\/o botones de la barra de herramientas en la ventana de la casa. Cada acci\u00f3n es una instancia de PluginAction<\/a>, que se parece a la clase Action<\/a>, con su m\u00e9todo execute<\/a> y sus propiedades<\/a> modificables (2). <\/p>\n\nTenga en cuenta que la clase Plugin<\/a> le da acceso a una instancia de UndoableEditSupport<\/a> a trav\u00e9s de su m\u00e9todo getUndoableEditSupport<\/a>. Tan pronto como modifique una casa o sus objetos (muebles, paredes…) en el m\u00e9todo execute de una instancia de PluginAction<\/a>, tambi\u00e9n debe publicar un objeto UndoableEdit<\/a> en el soporte de edici\u00f3n deshacible devuelto por el m\u00e9todo getUndoableEditSupport, de lo contrario, los usuarios no podr\u00e1n deshacer\/rehacer correctamente los cambios que haya realizado. <\/p>\n\nLocalizaci\u00f3n<\/h3>\n\nSi planea desarrollar un plugin para la comunidad de usuarios de Sweet Home 3D, intente localizar las cadenas que muestra, ya sea en el nombre de las acciones y el men\u00fa o en los di\u00e1logos que cree (o al menos prepare su localizaci\u00f3n). Dos constructores de la clase PluginAction<\/a> le ayudar\u00e1n a organizar la traducci\u00f3n de las propiedades de las acciones con archivos .properties, y si necesita traducir otras cadenas en su plugin (como la del di\u00e1logo mostrado por el plugin probado<\/a>) reutilice estos archivos .properties con la clase Java ResourceBundle<\/a>.Si prefiere limitar el n\u00famero de archivos de propiedades, incluso podr\u00eda escribir los valores de las propiedades de la acci\u00f3n y otras cadenas en el archivo de descripci\u00f3n<\/a> ApplicationPlugin.properties de su plugin. <\/p>\n\nSi quiere un ejemplo que utilice esta arquitectura, descargue el plugin](\"https:\/\/www.sweethome3d.com\/wp-content\/uploads\/2025\/12\/pluginClassesDiagram.png\"){kind=link}