{"id":11786,"date":"2025-11-05T16:28:15","date_gmt":"2025-11-05T16:28:15","guid":{"rendered":"https:\/\/www.sweethome3d.com\/huong-dan-cho-nha-phat-trien-plug-in\/"},"modified":"2025-12-19T10:19:46","modified_gmt":"2025-12-19T10:19:46","slug":"huong-dan-cho-nha-phat-trien-plug-in","status":"publish","type":"page","link":"https:\/\/www.sweethome3d.com\/vi\/huong-dan-cho-nha-phat-trien-plug-in\/","title":{"rendered":"H\u01b0\u1edbng d\u1eabn cho nh\u00e0 ph\u00e1t tri\u1ec3n plug-in"},"content":{"rendered":"\n

Gi\u1edbi thi\u1ec7u<\/h2>\n\n

T\u1eeb phi\u00ean b\u1ea3n 1.5, c\u00f3 th\u1ec3 th\u00eam c\u00e1c t\u00ednh n\u0103ng m\u1edbi v\u00e0o Sweet Home 3D<\/a> v\u1edbi c\u00e1c t\u1ec7p plug-in \u0111\u1eb7t trong th\u01b0 m\u1ee5c plug-ins<\/a> c\u1ee7a b\u1ea1n. \u0110i\u1ec1u n\u00e0y cho ph\u00e9p c\u00e1c l\u1eadp tr\u00ecnh vi\u00ean Java ph\u00e1t tri\u1ec3n v\u00e0 ph\u00e2n ph\u1ed1i c\u00e1c t\u00ednh n\u0103ng m\u1edbi cho Sweet Home 3D<\/a> m\u00e0 kh\u00f4ng c\u1ea7n s\u1eeda \u0111\u1ed5i c\u00e1c t\u1ec7p ngu\u1ed3n c\u1ee7a phi\u00ean b\u1ea3n hi\u1ec7n t\u1ea1i (\u0111i\u1ec1u n\u00e0y t\u1ed1t cho kh\u1ea3 n\u0103ng t\u01b0\u01a1ng th\u00edch l\u00ean tr\u00ean), v\u00e0 kh\u00f4ng c\u1ea7n cung c\u1ea5p m\u1ed9t phi\u00ean b\u1ea3n \u0111\u1ea7y \u0111\u1ee7 c\u1ee7a ch\u01b0\u01a1ng tr\u00ecnh (\u0111i\u1ec1u n\u00e0y t\u1ed1t cho k\u00edch th\u01b0\u1edbc ph\u00e2n ph\u1ed1i).T\u00e0i li\u1ec7u n\u00e0y m\u00f4 t\u1ea3 c\u00e1c c\u00f4ng c\u1ee5<\/a> c\u1ea7n thi\u1ebft \u0111\u1ec3 t\u1ea1o plug-in, sau \u0111\u00f3 ch\u1ec9 ra c\u00e1ch l\u1eadp tr\u00ecnh m\u1ed9t plug-in<\/a> t\u00ednh to\u00e1n th\u1ec3 t\u00edch t\u1ed1i \u0111a c\u1ee7a \u0111\u1ed3 n\u1ed9i th\u1ea5t c\u00f3 th\u1ec3 di chuy\u1ec3n \u0111\u01b0\u1ee3c th\u00eam v\u00e0o nh\u00e0, v\u00e0 cu\u1ed1i c\u00f9ng cung c\u1ea5p m\u1ed9t s\u1ed1 th\u00f4ng tin b\u1ed5 sung<\/a> s\u1ebd gi\u00fap b\u1ea1n ti\u1ebfn xa h\u01a1n. <\/p>\n\n

<\/div>\n\n

C\u00e0i \u0111\u1eb7t c\u00f4ng c\u1ee5 ph\u00e1t tri\u1ec3n<\/h2>\n\n

N\u1ebfu Sweet Home 3D h\u01b0\u1edbng \u0111\u1ebfn \u0111\u1ed1i t\u01b0\u1ee3ng chung, ph\u00e1t tri\u1ec3n plug-in \u0111\u00f2i h\u1ecfi k\u1ef9 n\u0103ng \u0111\u1eb7c bi\u1ec7t, v\u00e0 b\u1ea1n n\u00ean bi\u1ebft c\u00e1ch l\u1eadp tr\u00ecnh trong Java<\/a> v\u1edbi m\u1ed9t IDE<\/a> tr\u01b0\u1edbc khi ti\u1ebfn xa h\u01a1n. H\u01b0\u1edbng d\u1eabn n\u00e0y ch\u1ec9 ra c\u00e1ch x\u00e2y d\u1ef1ng m\u1ed9t plug-in v\u1edbi Eclipse<\/a>, nh\u01b0ng b\u1ea1n c\u00f3 th\u1ec3 s\u1eed d\u1ee5ng IDE m\u00e0 b\u1ea1n ch\u1ecdn, ho\u1eb7c kh\u00f4ng c\u1ea7n IDE n\u00e0o c\u1ea3. <\/p>\n\n

T\u1ea3i xu\u1ed1ng v\u00e0 c\u00e0i \u0111\u1eb7t Eclipse<\/h3>\n\n

Tr\u01b0\u1edbc ti\u00ean, t\u1ea3i xu\u1ed1ng Eclipse t\u1eeb https:\/\/www.eclipse.org\/<\/a>. Phi\u00ean b\u1ea3n c\u00f3 t\u00ean Eclipse IDE for Java Developers<\/em> l\u00e0 \u0111\u1ee7 \u0111\u1ec3 ph\u00e1t tri\u1ec3n m\u1ed9t plug-in, nh\u01b0ng b\u1ea1n c\u00f3 th\u1ec3 t\u1ea3i xu\u1ed1ng b\u1ea5t k\u1ef3 phi\u00ean b\u1ea3n n\u00e0o cho ph\u00e1t tri\u1ec3n Java. Sau khi t\u1ea3i xu\u1ed1ng, c\u00e0i \u0111\u1eb7t Eclipse r\u1ea5t \u0111\u01a1n gi\u1ea3n: ch\u1ec9 c\u1ea7n gi\u1ea3i n\u00e9n t\u1ec7p l\u01b0u tr\u1eef b\u1ea1n s\u1ebd nh\u1eadn \u0111\u01b0\u1ee3c, m\u1edf th\u01b0 m\u1ee5c eclipse v\u00e0 t\u00f9y thu\u1ed9c v\u00e0o h\u1ec7 th\u1ed1ng c\u1ee7a b\u1ea1n, ch\u1ea1y t\u1ec7p c\u00f3 t\u00ean eclipse.exe<\/code> (tr\u00ean Windows), eclipse.app<\/code> (tr\u00ean Mac OS X) ho\u1eb7c eclipse<\/code> (tr\u00ean Linux).L\u1ea7n \u0111\u1ea7u ti\u00ean ch\u1ea1y, Eclipse s\u1ebd y\u00eau c\u1ea7u b\u1ea1n ch\u1ecdn m\u1ed9t th\u01b0 m\u1ee5c workspace<\/em>, n\u01a1i s\u1ebd l\u01b0u tr\u1eef c\u00e1c d\u1ef1 \u00e1n plug-in.Sau khi ho\u00e0n t\u1ea5t, ch\u1ecdn File > New > Project<\/em> t\u1eeb menu \u0111\u1ec3 t\u1ea1o m\u1ed9t d\u1ef1 \u00e1n m\u1edbi, ch\u1ecdn Java > Java project<\/em> trong tr\u00ecnh h\u01b0\u1edbng d\u1eabn New project<\/em> s\u1ebd \u0111\u01b0\u1ee3c hi\u1ec3n th\u1ecb, nh\u1eadp VolumePlugin l\u00e0m t\u00ean d\u1ef1 \u00e1n v\u00e0 nh\u1ea5p v\u00e0o n\u00fat Finish<\/em>. Cu\u1ed1i c\u00f9ng, \u0111\u00f3ng tab Welcome<\/em> \u0111\u1ec3 kh\u00e1m ph\u00e1 workspace c\u1ee7a b\u1ea1n nh\u01b0 \u0111\u01b0\u1ee3c hi\u1ec3n th\u1ecb trong h\u00ecnh 1. <\/p>\n\n

\n
\"\"
H\u00ecnh 1. Kh\u00f4ng gian l\u00e0m vi\u1ec7c c\u1ee7a Eclipse <\/figcaption><\/figure>\n<\/div>\n\n

T\u1ea3i xu\u1ed1ng v\u00e0 c\u00e0i \u0111\u1eb7t th\u01b0 vi\u1ec7n Sweet Home 3D<\/h3>\n\n

Vi\u1ec7c ph\u00e1t tri\u1ec3n m\u1ed9t plug-in d\u1ef1a tr\u00ean m\u1ed9t s\u1ed1 l\u1edbp c\u1ee7a Sweet Home 3D m\u00e0 Eclipse ph\u1ea3i bi\u1ebft \u0111\u1ec3 c\u00f3 th\u1ec3 x\u00e2y d\u1ef1ng d\u1ef1 \u00e1n c\u1ee7a b\u1ea1n. C\u00e1ch d\u1ec5 nh\u1ea5t \u0111\u1ec3 th\u00eam c\u00e1c l\u1edbp Sweet Home 3D v\u00e0o Eclipse l\u00e0 t\u1ea3i xu\u1ed1ng phi\u00ean b\u1ea3n JAR th\u1ef1c thi c\u1ee7a Sweet Home 3D c\u00f3 s\u1eb5n t\u1ea1i https:\/\/sourceforge.net\/projects\/sweethome3d\/files\/SweetHome3D\/SweetHome3D-7.5\/SweetHome3D-7.5.jar\/download<\/a>. Sau khi t\u1ea3i xu\u1ed1ng, k\u00e9o v\u00e0 th\u1ea3 t\u1ec7p SweetHome3D-7.5.jar v\u00e0o bi\u1ec3u t\u01b0\u1ee3ng d\u1ef1 \u00e1n VolumePlugin<\/em> trong ch\u1ebf \u0111\u1ed9 xem Package Explorer<\/em> c\u1ee7a Eclipse, v\u00e0 ch\u1ecdn m\u1ee5c Build Path > Add to Build Path<\/em> trong menu ng\u1eef c\u1ea3nh c\u1ee7a t\u1ec7p SweetHome3D-7.5.jar, nh\u01b0 \u0111\u01b0\u1ee3c hi\u1ec3n th\u1ecb trong h\u00ecnh 2. <\/p>\n\n

\n
\"\"
H\u00ecnh 2. Th\u00eam SweetHome3D-7.5.jar v\u00e0o Build Path <\/figcaption><\/figure>\n<\/div>\n\n

L\u1eadp tr\u00ecnh m\u1ed9t plug-in<\/h2>\n\n

B\u00e2y gi\u1edd b\u1ea1n \u0111\u00e3 c\u00e0i \u0111\u1eb7t c\u00e1c c\u00f4ng c\u1ee5 c\u1ea7n thi\u1ebft, h\u00e3y xem c\u00e1ch b\u1ea1n c\u00f3 th\u1ec3 l\u1eadp tr\u00ecnh plug-in \u0111\u1ea7u ti\u00ean c\u1ee7a m\u00ecnh cho Sweet Home 3D.<\/p>\n\n

T\u1ea1o l\u1edbp plug-in<\/h3>\n\n

\u0110\u1ea7u ti\u00ean, t\u1ea1o m\u1ed9t l\u1edbp con m\u1edbi c\u1ee7a com.eteks.sweethome3d.plugin.Plugin b\u1eb1ng c\u00e1ch ch\u1ecdn m\u1ee5c menu File > New > Class<\/em> trong Eclipse.<\/p>\n\n

\n
\"\"
H\u00ecnh 3. T\u1ea1o m\u1ed9t l\u1edbp m\u1edbi <\/figcaption><\/figure>\n<\/div>\n\n

Trong h\u1ed9p tho\u1ea1i New Java Class<\/em>, nh\u1eadp VolumePlugin l\u00e0m t\u00ean l\u1edbp, nh\u1eadp m\u1ed9t g\u00f3i (\u1edf \u0111\u00e2y g\u00f3i \u0111\u01b0\u1ee3c ch\u1ecdn l\u00e0 com.eteks.test), v\u00e0 ch\u1ecdn com.eteks.sweethome3d.plugin.Plugin l\u00e0m l\u1edbp cha c\u1ee7a VolumePlugin. Sau khi ho\u00e0n t\u1ea5t, nh\u1ea5p v\u00e0o Finish<\/em>. Eclipse s\u1ebd t\u1ea1o t\u1ec7p c\u1ee7a l\u1edbp m\u1edbi v\u1edbi n\u1ed9i dung sau: <\/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
Nh\u01b0 b\u1ea1n c\u00f3 th\u1ec3 \u0111o\u00e1n t\u1eeb nh\u1eadn x\u00e9t TODO, b\u1ea1n ph\u1ea3i thay \u0111\u1ed5i vi\u1ec7c tri\u1ec3n khai ph\u01b0\u01a1ng th\u1ee9c getActions \u0111\u1ec3 tr\u1ea3 v\u1ec1 m\u1ed9t h\u00e0nh \u0111\u1ed9ng plug-in c\u00f3 th\u1ec3 t\u00ednh to\u00e1n th\u1ec3 t\u00edch c\u1ee7a \u0111\u1ed3 n\u1ed9i th\u1ea5t c\u00f3 th\u1ec3 di chuy\u1ec3n. Thay th\u1ebf return null; b\u1eb1ng c\u00e2u l\u1ec7nh sau: <\/p>\n\n
 return new PluginAction<\/strong> [] {new VolumeAction<\/strong>()}; <\/pre>\n\n
v\u00e0 ch\u1ecdn Edition > Quick Fix<\/em> t\u1eeb menu Eclipse \u0111\u1ec3 t\u1ea1o l\u1edbp VolumeAction b\u1ecb thi\u1ebfu, nh\u01b0 \u0111\u01b0\u1ee3c hi\u1ec3n th\u1ecb trong h\u00ecnh 4.<\/p>\n\n
\n
\"\"
H\u00ecnh 4. S\u1eed d\u1ee5ng Quick fix \u0111\u1ec3 t\u1ea1o m\u1ed9t l\u1edbp b\u1ecb thi\u1ebfu <\/figcaption><\/figure>\n<\/div>\n\n
Trong h\u1ed9p tho\u1ea1i New Java Class<\/em> xu\u1ea5t hi\u1ec7n, ch\u1ecdn h\u1ed9p ki\u1ec3m Enclosing type<\/em> \u0111\u1ec3 t\u1ea1o m\u1ed9t l\u1edbp b\u00ean trong c\u1ee7a VolumePlugin v\u00e0 nh\u1ea5p v\u00e0o Finish<\/em>. \u0110i\u1ec1u n\u00e0y s\u1ebd t\u1ea1o l\u1edbp VolumeAction k\u1ebf th\u1eeba t\u1eeb l\u1edbp com.eteks.sweethome3d.plugin.PluginAction v\u00e0 ch\u1ee9a m\u1ed9t ph\u01b0\u01a1ng th\u1ee9c execute tr\u1ed1ng: <\/p>\n\n
 public class VolumeAction<\/strong> extends PluginAction<\/strong> { @Override public void execute<\/strong>() { \/\/ TODO Auto-generated method stub }}<\/pre>\n\n
Ph\u01b0\u01a1ng th\u1ee9c n\u00e0y l\u00e0 ph\u01b0\u01a1ng th\u1ee9c m\u00e0 Sweet Home 3D s\u1ebd g\u1ecdi khi ng\u01b0\u1eddi d\u00f9ng kh\u1edfi ch\u1ea1y h\u00e0nh \u0111\u1ed9ng plug-in; do \u0111\u00f3 \u0111\u00e2y l\u00e0 n\u01a1i b\u1ea1n ph\u1ea3i tri\u1ec3n khai c\u00e1ch t\u00ednh to\u00e1n th\u1ec3 t\u00edch c\u1ee7a \u0111\u1ed3 n\u1ed9i th\u1ea5t v\u00e0 hi\u1ec3n th\u1ecb n\u00f3:<\/p>\n\n
 public class VolumeAction<\/strong> extends PluginAction<\/strong> {   @Override public void execute<\/strong>() {  float volumeInCm3 = 0; \/\/ T\u00ednh t\u1ed5ng th\u1ec3 t\u00edch c\u1ee7a h\u1ed9p bao quanh c\u1ee7a  \/\/ m\u1ed7i m\u1ea3nh \u0111\u1ed3 n\u1ed9i th\u1ea5t c\u00f3 th\u1ec3 di chuy\u1ec3n trong nh\u00e0 for (PieceOfFurniture piece : getHome<\/strong>(). getFurniture<\/strong>()) { if (piece. isMovable<\/strong>()) { volumeInCm3 += piece. getWidth<\/strong>()  * piece. getDepth<\/strong>()  * piece. getHeight<\/strong>(); }} \/\/ Hi\u1ec3n th\u1ecb k\u1ebft qu\u1ea3 trong m\u1ed9t h\u1ed9p th\u00f4ng b\u00e1o (\u00b3 l\u00e0 s\u1ed1 3 \u1edf d\u1ea1ng si\u00eau k\u00fd t\u1ef1) String message = String. format<\/strong>( \"Th\u1ec3 t\u00edch t\u1ed1i \u0111a c\u1ee7a \u0111\u1ed3 n\u1ed9i th\u1ea5t c\u00f3 th\u1ec3 di chuy\u1ec3n trong nh\u00e0 l\u00e0 %.2f m\u00b3.\",  volumeInCm3 \/ 1000000); JOptionPane. showMessageDialog<\/strong>(null, message);  }  }<\/pre>\n\n
B\u00e2y gi\u1edd b\u1ea1n \u0111\u00e3 x\u00e1c \u0111\u1ecbnh nh\u1eefng g\u00ec b\u1ea1n mu\u1ed1n plug-in th\u1ef1c hi\u1ec7n, b\u1ea1n ph\u1ea3i m\u00f4 t\u1ea3 c\u00e1ch ng\u01b0\u1eddi d\u00f9ng s\u1ebd kh\u1edfi ch\u1ea1y h\u00e0nh \u0111\u1ed9ng m\u1edbi n\u00e0y. B\u1ea1n c\u00f3 th\u1ec3 ch\u1ecdn th\u00eam m\u1ed9t m\u1ee5c menu<\/strong> m\u1edbi v\u00e0o m\u1ed9t menu, v\u00e0\/ho\u1eb7c m\u1ed9t n\u00fat<\/strong> m\u1edbi v\u00e0o thanh c\u00f4ng c\u1ee5. L\u1ef1a ch\u1ecdn n\u00e0y \u0111\u01b0\u1ee3c th\u1ef1c hi\u1ec7n b\u1eb1ng c\u00e1ch thi\u1ebft l\u1eadp c\u00e1c thu\u1ed9c t\u00ednh th\u00edch h\u1ee3p c\u1ee7a h\u00e0nh \u0111\u1ed9ng plug-in khi t\u1ea1o ra n\u00f3. V\u00ed d\u1ee5, n\u1ebfu b\u1ea1n mu\u1ed1n ng\u01b0\u1eddi d\u00f9ng kh\u1edfi ch\u1ea1y h\u00e0nh \u0111\u1ed9ng th\u1ec3 t\u00edch v\u1edbi m\u1ee5c menu Compute volume<\/em> \u0111\u01b0\u1ee3c t\u00ecm th\u1ea5y trong menu Tools<\/em>, b\u1ea1n s\u1ebd th\u00eam h\u00e0m t\u1ea1o sau v\u00e0o l\u1edbp VolumnAction:   <\/p>\n\n
 public VolumeAction<\/strong>() { putPropertyValue<\/strong>(Property.NAME, \"Compute volume\"); putPropertyValue<\/strong>(Property.MENU, \"Tools\"); \/\/ K\u00edch ho\u1ea1t h\u00e0nh \u0111\u1ed9ng theo m\u1eb7c \u0111\u1ecbnh setEnabled<\/strong>(true);}<\/pre>\n\n
L\u1edbp plug-in VolumePlugin<\/a> b\u00e2y gi\u1edd \u0111\u00e3 \u0111\u01b0\u1ee3c l\u1eadp tr\u00ecnh, v\u00e0 g\u1ea7n nh\u01b0 s\u1eb5n s\u00e0ng ho\u1ea1t \u0111\u1ed9ng nh\u01b0 m\u1ed9t plug-in trong Sweet Home 3D. Hai \u0111i\u1ec1u cu\u1ed1i c\u00f9ng c\u1ea7n l\u00e0m l\u00e0: <\/p>\n\n