Ana içeriğe atla

IzPack ve Java kurulumları hazırlama

Bir projeyi bitirdikten sonra yaşanan en büyük sıkıntılardan biri tüm platformlarda çalışacak bir kurulum dosyası oluşturmaktır (installer). Java uygulamaları için son aşamaya geldiğinizde kullanabileceğiniz güzel bir aracı ben araştırmalar sonucu buldum. IzPack işimi gerçekten kolaylaştırdı ve hem linux hem de windows tabanlı makinelerde kurulum dosyası oluşturmamı sağladı.

IzPack sitesinden kurulumunu indiriyoruz. İndirdikten sonra java -jar izpack-dist-5.0.10-installer.jar komutuyla kurulumu başlatıyoruz. Daha sonra aşamaları izleyerek kurulumu tamamlıyoruz.

Kurulum tamamlandıktan sonra paketini hazırlayacağımız projenin çalıştırılabilir jar dosyasını oluşturuyoruz. Ve bu aşamadan sonra IzPack için gereken xml tanıtma dosyasını yazıp projemizin paketini hazırlayabiliriz.

Aşağıda açıklamasıyla bir örnek vardır. Bu örneği denemek için Dosya Parçalayıcıyı indirip oluşturduğunuz bir klasöre koyun. Ayrıca paketle beraber bir lisans dosyası göndereceğimizi varsayalım. Onu da siz yazabilirsiniz veya hazır bir lisans dosyası indirebilirsiniz. Bu örnek için GPL lisansını kullanacağız. Verdiğim adresten html dosyasını indirin ve aynı klasöre koyun. Daha sonra çok basit bir html dosyasını elimizle yazalım. İçeriğinde kurulum aşamalarını, programınız hakkında bilgiyi içerebilirsiniz. Örnek için dosyamız şu şekildedir:
Bu program dosyaları parçalamaya yarıyor. KodVeUs tarafından eğitim amaçlı yapılmıştır.
Ve kullanıcıların çalıştırma işlemini kolaylaştırmak için iki tane (linux için ve windows için) script yazıyoruz. İçerikleri oldukça basit:
Linux (calistir.sh):
#!/bin/bash/
java -jar DosyaParcalayici.jar

Windows(calistir.bat):
java -jar DosyaParcalayici.jar

Dil seçiminde kullanmak üzere de bir resmi aynı klasöre koyuyoruz. Aşamaları bitirdikten sonra aşağıdaki gibi bir klasörünüz olmalıdır:


Yukarıdaki klasor yapısından sonra aşağıdaki örnek IzPack derleyicisi için hazırladığımız xml dosyasını aynı klasorde yaratacağız:
<installation version="1.0">
<info>
<appname>Dosya Parçalayıcı</appname>
<appversion>0.1</appversion>
<authors>
<author name="Kod ve Us" email="kodveus@gmail.com" />
</authors>
<url>http://www.blogcu.com/kodveus</url>
<javaversion>1.5</javaversion>
</info>

<guiprefs height="600" resizable="yes" width="800">
<laf name="metouia">
<os family="unix" />
</laf>
<laf name="looks">
<os family="windows" />
<param name="variant" value="extwin" />
</laf>
</guiprefs>

<locale>
<!-- Hem ingilizce hem de Turkce calissin kurulum programi -->
<langpack iso3="tur"/>
<langpack iso3="eng"/>
</locale>

<resources>
<!-- HTML olarak bilgi panelinin icerigi (html dosyasi olmali)-->
<res src="oku.html" id="HTMLInfoPanel.info"/>
<!-- lisans panelinin icerigi (txt dosyasi olmali) -->
<res src="gpl.txt" id="LicencePanel.licence"/>
<!-- Dil ekranindaki resim -->
<res src="kvu.gif" id="installer.langsel.img"/>
</resources>

<panels>
<!-- Gosterilmesini istedigimiz paneller -->
<panel classname="HelloPanel"/>
<panel classname="HTMLInfoPanel"/>
<panel classname="LicencePanel"/>
<panel classname="PacksPanel"/>
<panel classname="TargetPanel"/>
<panel classname="InstallPanel"/>
<panel classname="SimpleFinishPanel"/>
</panels>

<packs>
<pack name="Core" required="yes">
<description>Dosya parçalayıcı için gereksinim duyulan çekirdek dosyalar.</description>
<fileset dir="" targetdir="$INSTALL_PATH">
<!-- Calistirilabilir dosyamizi ekliyoruz -->
<include name="DosyaParcalayici.jar" />
</fileset>
<!-- Linuxte calistirmayi saglayacak olan script -->
<file src="calistir.sh" os="unix" targetdir="$INSTALL_PATH/"/>
<!-- Windowsta calistirmayi saglayacak olan script -->
<file src="calistir.bat" os="windows" targetdir="$INSTALL_PATH/"/>
<!-- Kullanicilarin daha sonra da erismesi icin lisans ve oku dosyalarini ekliyoruz -->
<file src="oku.html" targetdir="$INSTALL_PATH/doc/"/>
<file src="gpl_tr.html" targetdir="$INSTALL_PATH/doc/"/>
<file src="gpl.txt" targetdir="$INSTALL_PATH/doc/"/>
<!-- Linuxte scriptin calismasi icin executable isaretini koyuyoruz -->
<executable targetfile="$INSTALL_PATH/calistir.sh" stage="never" />
</pack>
</packs>
</installation>


Daha sonra komut satırını açıp aşağıdaki komutları çalıştırıyoruz:

$ cd YarattigimizKlasor
$ IzPackKurulumKlasoru/bin/compile dp.xml

Bu komutu çalıştırdıktan sonra aynı klasorde dp.jar isimli bir dosya oluşacaktır. Bu dosyayı java -jar dp.jar ile çalıştırdığımızda kurulum aşamaları başlayacaktır.

Kurulum tamamlandıktan sonra seçilen konumda bizim dosyalarımızla birlikte bir Uninstaller klasoru oluşuyor. O klasorun içerisindeki uninstaller.jar dosyası (çift tıklayarak veya java -jar uninstaller.jar komutuyla) yardımıyla programımızın kaldırılması sağlanmaktadır.

Anlatılan klasör yapısını içeren zip
Aşamalar sonunda oluşan kurulum jarı

Kaynaklar:
-IzPack kurulumuyla birlikte klasör altında oluşan belgeler (doc klasörü altında)
-IzPack tutorial
-IzPack sitesi

Yorumlar