Menyiapkan Lingkungan Pengembangan aplikasi berbasis Openfire

Menyiapkan lingkungan pengembangan ini bertujuan untuk menyediakan lingkungan developmnet yang nantinya akan kita gunakan untuk membuat aplikasi berupa plugin di openfire. Seperti hal-nya project2 Java pada umumnya, pengembangan aplikasi akan kita bangun menggunakan IDE dg menyertakan library/pustaka lain yang diibutuhkan.

1. Persiapan (Instalasi JDK, Eclipse, MySQL, dll)

   JDK

   • Download JDK dari situs SUN di http://java.sun.com/javase/downloads/index.jsp.
   • Jalankan  file .exe dan ikuti instruksi yang diberikan
   • Set JAVA_HOME dan PATH dalam  System Properties – Environment Variables
   • Test menggunakan command prompt, ketikkan java -version. Seharusnya terlihat versi dari JDK yang terinstal

   Eclipse

   • Download Eclipse IDE dari situs Eclipse di http://www.eclipse.org/downloads/. Gunakan  Eclipse IDE for  JavaEE. Tutorial ini menggunakan  Eclipse IDE Ganymede (3.4.x)
   • Ekstrak file  zip ke C:/Program Files/Eclipse.
   • Buka folder C:/Program Files/Eclipse.
   • Klik kanan dan seret eclipse.exe ke  desktop (atau Windows taskbar) untuk membuat  ikon shortcut.
   • Klik kanan ikon tersebut dan pilih Properties. Jendela Eclipse Properties akan ditampilkan.
   • Pastikan pada bagian Target seharusnya tertulis seperti ini “C:\Program Files\Eclipse\eclipse.exe” -vm “C:\Program Files\Java\jdk1.6.0\bin\javaw” tergantung versi  JDK yang anda gunakan dan dimana lokasinya.
   • Tutup jendela Eclipse Properties.

   MySQL

   MySQL adalah satu dari beberapa server database yang open source dan powerful. MySQL akan digunakan untuk menyimpan data Openfire dan aplikasi anda nantinya.

   • Download database MySQL dari situsnya MySQL di  http://dev.mysql.com/downloads/.
   • Jalankan file .exe /.msi dan  ikuti petunjuknya atau cukup anda ekstraksi file .zip dan menjalankan mysqld.bat(sh) jika anda memilih yang versi non- installer.
   • Lakukan test menggunakan command prompt dan ketikkan mysql dari folder bin dan pastikan MySQL servernya aktif/jalan
   • Jika anda membutuhkan sebuah antar muka MySQL Client, anda boleh menginstal dan menggunakan salah satu dari tool berikut: MySQL Workbench, PHPMyAdmin, MySQL GUI Tool, dll.

   Subversive

   Subversive digunakan untuk kolaborasi team pengembang serta pen-versi-an kode sumber. Meskipun saat ini anda tidak memerlukan akses ke suatu SVN server tetapi di lain kesempatan mungkin akan berguna juga.

   • Jalankan Eclipse IDE dengan klik dua kali ikon Eclipse shortcut
   • Pilih dan tentukan lokasi workspace anda dan klik OK
   • Klik  menu Help –> Software Updates
   • Klik pada tab Available Software dan klik Next
   • Klik tombol Add Site
   • Masukkan Enter lokasi update Subversive di kotak lokasi: http://download.eclipse.org/technology/subversive/0.7/update-site/
   • Karena plugin subversive membutuhkan SVN Connectors, jadi tambahkan juga update site yang ini: http://community.polarion.com/projects/subversive/download/eclipse/2.0/update-site/
   • Pastikan kedua URL di-centangdipilih
   • Klik tombol Install dan ikuti instruksinya
2. Download Openfire

   Untuk mendapatkan kode sumber dari Openfire, anda bisa memilih opsi berikut: (opsi yg 1 sangat direkomendasikan)

   • Download dari The released Source Code

   Download kode sumber terbaru dari  http://www.igniterealtime.org/downloads/source.jsp dan ekstrak ke lokasi yang sesuai.

   atau

   • Dari  SVN

     Anda bisa checkout dari URL SVN openfire berikut: http://svn.igniterealtime.org/svn/repos. Bagaiman cara checkout? Mari kita jelaskan sama-sama.
     Asumsi kita Eclipse sudah jalan.

     • Klik menu Window –> Open Perspective –> Other
     • Pada dialog, pilih SVN Repository Exploring lalu klik OK
     • Klik File –>  New –> Repository Location. Jika anda tidak menemukan pilihan tersebut, pilih Other dan temukan pilihan Repository Location dalam kategori SVN.
     • Pada kotak New Repository Location masukkan  http://svn.igniterealtime.org/svn/repos dalam kotak URL dan klik Finish. Kamu akan menemukan lokasi URL di dalam Repositories
     • Perluas/expand lokasi URL
     • Perluas  pohon tree dari openfire .
     • Klik kanan pada trunk dan pilih Check Out. tunggu sampai proses checkout selesai.
3. Membuat project Eclipse
   • Klik menu Window –> Open Perspective –> Java
   • Dalam Project Explorer, jika terdapat project “openfire”, hapus saja. Project ini dibuat saat proses checkout. Pada dialog Confirm Project Delete, pilih “Do not delete contents”, lalu klik Yes.
   • selanjutnya klik File –> New –> Project.
   • Pilih Java Project dalam kategori Java dan klik Next.
   • Dalam jendela New Java Project pilih “Create project from existing source” dan cari dimana folder openfire berada.
   • Dalam kotak project name masukkan: openfire. Jika tidak tombol Next dan Finish akan tetap disabled. Selanjutnya klik Next. Eclipse akan membaca struktur directori untuk menyiapkan lingkungan kerja secara otomatis. Kemudian klik Finish.
   • Jika ada konfirmasi “Open Associated Perspective windows”, maka klik Yes.
4. Build Openfire
   • Klik menu Window –> Show View –> Ant
   • Klik kanan pada tab Ant dan pilih pilihan Add Buildfiles
   • Expand folder openfire::build dan pilih build.xml, kemudian klik OK.
   • Pada tab Ant, expand  Openfire XMPP Server dan klik dua kali pada openfire ant task.
5. Build all plugins
   • Klik menu Window –> Show View –> Ant
   • Pada tab Ant, expand Openfire XMPP Server dan klik dua kali pada plugins ant task.
6. Membuat server launcher
   • Klik menu Run –> Run Configuration.
   • Pilih Java Application dan klik tombol New
   • Pada tab Main dari jendela Run, ubah nama “New configuration” menjadi  “Openfire”.
   • Klik tombol Project Browse dan pilih openfire lalu klik OK.
   • Klik pada tab Main –> Main Class –> tombol Search dan pilih ServerStarter – org.jivesoftware.openfire.starter. ServerStarter lalu klik OK.
   • Saya menyarakan untuk men-check pilihan Stop pada main check box, jadi anad bisa memverifikasi proses debug nantinya.
   • Klik pada tab Arguments.
   • PAda kotak VM arguments, masukkan  -DopenfireHome=”C:\path_to_openfire_folder /target/openfire”. Sesuaikan dengan folder openfire anda.
   • Klik pada tab Classpath.
   • Pilih User Entries, jadi tombol Advanced… enable.
   • Klik pada tombol  Advanced…
   • Pada jendela pilihan Advanced dan  pilih Add Folders lalu klik OK.
   • Pada jendela Folder Selection pilih folder openfire/src/i18n lalu klik OK.
   • Klik Advanced dan pilih Add Folders. Sekali lagi tambahkan folder openfire/src/resources/jar.
   • Klik Advanced dan pilih Add Folders. Sekali lagi tambahkan folder openfire/build/lib/dist.
   • Klik pada tab Common.
   • Pilih Debug dan Run.
   • Selanjutnya klik tombol Apply.
   • Klik tombol  Close.
   • Kemudian jalankan server dengan cara: klik menu Run –> Run History –> Openfire

Demikian langkah-langkah menyiapkan lingkungan development openfire. Selanjutnya pada tutorial berikutnya, akan dijelaskan bagaimana cara membuat plugin dalam openfire. Semoga bermanfaat.

DM

=======
Referensi:

1. http://www.igniterealtime.org/community/docs/DOC-1020

2. http://www.igniterealtime.org/community/docs/DOC-1200