{"id":11701,"date":"2025-11-05T16:28:15","date_gmt":"2025-11-05T16:28:15","guid":{"rendered":"https:\/\/www.sweethome3d.com\/guia-do-desenvolvedor-de-plug-ins\/"},"modified":"2025-12-19T10:19:42","modified_gmt":"2025-12-19T10:19:42","slug":"guia-do-desenvolvedor-de-plug-ins","status":"publish","type":"page","link":"https:\/\/www.sweethome3d.com\/pt-br\/guia-do-desenvolvedor-de-plug-ins\/","title":{"rendered":"Guia do desenvolvedor de plug-ins"},"content":{"rendered":"\n

Introdu\u00e7\u00e3o<\/h2>\n\n

A partir da vers\u00e3o 1.5, \u00e9 poss\u00edvel adicionar novos recursos ao Sweet Home 3D<\/a> com arquivos de plug-in colocados na sua pasta de plug-ins<\/a>. Isso permite que programadores Java desenvolvam e distribuam novos recursos para o Sweet Home 3D<\/a> sem modificar os arquivos de origem da vers\u00e3o atual (o que \u00e9 bom para a compatibilidade ascendente) e sem fornecer uma vers\u00e3o completa do programa (o que \u00e9 bom para o tamanho da entrega).Este documento descreve as ferramentas<\/a> necess\u00e1rias para criar plug-ins, depois mostra como programar um plug-in<\/a> que calcula o volume m\u00e1ximo dos m\u00f3veis m\u00f3veis adicionados a uma casa e, finalmente, fornece algumas informa\u00e7\u00f5es adicionais<\/a> que o ajudar\u00e3o a ir mais longe. <\/p>\n\n

<\/div>\n\n

Instalando ferramentas de desenvolvimento<\/h2>\n\n

Se o Sweet Home 3D for destinado a um p\u00fablico geral, o desenvolvimento de plug-ins requer habilidades especiais, e voc\u00ea deve saber como programar em Java<\/a> com um IDE<\/a>, antes de prosseguir. Este guia mostra como construir um plug-in com o Eclipse<\/a>, mas voc\u00ea pode usar o IDE de sua escolha ou nenhum IDE. <\/p>\n\n

Baixe e instale o Eclipse<\/h3>\n\n

Primeiro, baixe o Eclipse em https:\/\/www.eclipse.org\/<\/a>. A vers\u00e3o chamada Eclipse IDE for Java Developers<\/em> \u00e9 suficiente para desenvolver um plug-in, mas voc\u00ea pode baixar qualquer vers\u00e3o para desenvolvimento Java. Depois de baixado, instalar o Eclipse \u00e9 muito simples: basta descompactar o arquivo que voc\u00ea receber\u00e1, abrir a pasta do Eclipse e, dependendo do seu sistema, executar o arquivo chamado eclipse.exe<\/code> (no Windows), eclipse.app<\/code> (no Mac OS X) ou eclipse<\/code> (no Linux).Na primeira execu\u00e7\u00e3o, o Eclipse exigir\u00e1 que voc\u00ea escolha uma pasta de workspace<\/em>, onde os projetos de plug-in ser\u00e3o armazenados.Depois de feito, escolha Arquivo > Novo > Projeto<\/em> no menu para criar um novo projeto, selecione Java > Projeto Java<\/em> no assistente Novo projeto<\/em> que ser\u00e1 exibido, insira VolumePlugin como nome do projeto e clique no bot\u00e3o Concluir<\/em>. Finalmente, feche a guia Bem-vindo<\/em> para descobrir seu workspace, como mostrado na figura 1. <\/p>\n\n

\n
\"\"
Figura 1. Workspace do Eclipse <\/figcaption><\/figure>\n<\/div>\n\n

Baixe e instale a biblioteca Sweet Home 3D<\/h3>\n\n

O desenvolvimento de um plug-in \u00e9 baseado em algumas classes do Sweet Home 3D que o Eclipse deve conhecer para poder construir seu projeto. A maneira mais f\u00e1cil de adicionar classes do Sweet Home 3D ao Eclipse \u00e9 baixar a vers\u00e3o JAR execut\u00e1vel do Sweet Home 3D dispon\u00edvel em https:\/\/sourceforge.net\/projects\/sweethome3d\/files\/SweetHome3D\/SweetHome3D-7.5\/SweetHome3D-7.5.jar\/download<\/g>. Depois de baixado, arraste e solte o arquivo SweetHome3D-7.5.jar no \u00edcone do projeto VolumePlugin<\/em> na visualiza\u00e7\u00e3o Package Explorer<\/em> do Eclipse e escolha o item Build Path > Adicionar ao Build Path<\/em> no menu contextual do arquivo SweetHome3D-7.5.jar, como mostrado na figura 2. <\/p>\n\n

\n
\"\"
Figura 2. Adicionando SweetHome3D-7.5.jar ao Build Path <\/figcaption><\/figure>\n<\/div>\n\n

Programando um plug-in<\/h2>\n\n

Agora que voc\u00ea instalou as ferramentas necess\u00e1rias, vamos ver como voc\u00ea pode programar seu primeiro plug-in para Sweet Home 3D.<\/p>\n\n

Criando a classe de plug-in<\/h3>\n\n

Primeiro, crie uma nova subclasse de com.eteks.sweethome3d.plugin.Plugin escolhendo o item de menu Arquivo > Novo > Classe<\/em> no Eclipse.<\/p>\n\n

\n
\"\"
Figura 3. Criando uma nova classe <\/figcaption><\/figure>\n<\/div>\n\n

Na caixa de di\u00e1logo Nova Classe Java<\/em>, insira VolumePlugin como o nome da classe, insira um pacote (aqui o pacote escolhido foi com.eteks.test) e escolha com.eteks.sweethome3d.plugin.Plugin como a superclasse de VolumePlugin. Depois de feito, clique em Concluir<\/g>. O Eclipse criar\u00e1 o arquivo da nova classe com o seguinte conte\u00fado: <\/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
Como voc\u00ea pode imaginar pelo coment\u00e1rio TODO, agora voc\u00ea deve alterar a implementa\u00e7\u00e3o do m\u00e9todo getActions para retornar uma a\u00e7\u00e3o de plug-in capaz de calcular o volume dos m\u00f3veis m\u00f3veis. Substitua return null; pela seguinte declara\u00e7\u00e3o: <\/p>\n\n
  return new PluginAction<\/strong> [] {new VolumeAction<\/strong>()};  <\/pre>\n\n
e escolha Edi\u00e7\u00e3o > Corre\u00e7\u00e3o R\u00e1pida<\/em> no menu do Eclipse para criar a classe VolumeAction ausente, como mostrado na figura 4.<\/p>\n\n
\n
\"\"
Figura 4. Usando a corre\u00e7\u00e3o r\u00e1pida para gerar uma classe ausente <\/figcaption><\/figure>\n<\/div>\n\n
Na caixa de di\u00e1logo Nova Classe Java<\/em> que aparece, marque a caixa de sele\u00e7\u00e3o Tipo delimitador<\/em> para criar uma classe interna de VolumePlugin e clique em Concluir<\/em>. Isso criar\u00e1 a classe VolumeAction que herda da classe com.eteks.sweethome3d.plugin.PluginAction e cont\u00e9m um m\u00e9todo execute vazio: <\/p>\n\n
  public class VolumeAction<\/strong> extends PluginAction<\/strong> { @Override public void execute<\/strong>() { \/\/ TODO Auto-generated method stub } }<\/pre>\n\n
Este m\u00e9todo \u00e9 aquele que o Sweet Home 3D chamar\u00e1 quando o usu\u00e1rio iniciar a a\u00e7\u00e3o do plug-in; portanto, este \u00e9 o lugar onde voc\u00ea deve implementar como calcular o volume dos m\u00f3veis e exibi-lo:<\/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<\/g>()) { 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<\/g>( \"The maximum volume of the movable furniture in home is %.2f m\u00b3.\",  volumeInCm3 \/ 1000000); JOptionPane. showMessageDialog<\/strong>(null, message);  }  }<\/pre>\n\n
Agora que voc\u00ea especificou o que deseja que o plug-in fa\u00e7a, voc\u00ea deve descrever como o usu\u00e1rio iniciar\u00e1 esta nova a\u00e7\u00e3o. Voc\u00ea tem a op\u00e7\u00e3o de adicionar um novo item de menu<\/strong> a um menu e\/ou um novo bot\u00e3o<\/strong> \u00e0 barra de ferramentas. Esta escolha \u00e9 feita definindo as propriedades apropriadas da a\u00e7\u00e3o do plug-in em sua cria\u00e7\u00e3o. Por exemplo, se voc\u00ea quiser que os usu\u00e1rios iniciem a a\u00e7\u00e3o de volume com o item de menu Calcular volume<\/em> encontrado no menu Ferramentas<\/em>, voc\u00ea adicionar\u00e1 o seguinte construtor \u00e0 classe VolumnAction:   <\/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
A classe de plug-in VolumePlugin<\/a> agora est\u00e1 programada e quase pronta para funcionar como um plug-in no Sweet Home 3D. As duas \u00faltimas coisas a fazer s\u00e3o: <\/p>\n\n