PERTEMUAN-4

Otomatisasi Proses Build dengan Apache Ant

(Pengujian dengan Tools)
4.1 Tujuan

1. Mahasiswa memahami pengertian dari proses build.

2. Mahasiswa memahami berbagai macam software yang berfungsi sebagai build tool
3. Mahasiswa memahami kegunaan Apache Ant
4. Mahasiswa memahami dan bisa melakukan instalasi software Apache Ant
5. Mahasiswa mampu membedakan proses membangun software tanpa build tool serta dengan menggunakan build
tool
6. Mahasiswa memahami file-file yang terkait dan diperlukan oleh Apache Ant, yaitu file properties dan build.xml
7. Mahasiswa mampu menggunakan Apache ant dengan cara membuat build.xml untuk keperluan otomatisasi
proses build serta menggunakan berbagai target yang telah didefinisikan pada build.xml tersebut.

4.2 Teori Singkat

Apache Ant adalah software berbasis Java yang digunakan untuk keperluan build tool. Sebagai build tool, tugas utama
dari Ant adalah untuk menyediakan sumber daya dan melaksanakan proses yang memungkinkan membangun suatu
software dari bentuk source code menjadi aplikasi yang siap didistribusikan atau bahkan telah diinstall pada remote
server. Meskipun definisi tersebut kelihatannya sederhana, kita akan melihat bahwa Ant mempunyai banyak sekali tasks
yang bisa digunakan untuk berbagai keperluan sesuai dengan tujuan utama dari build tool. Ada banyak build tool yang
tersedia, beberapa diantaranya adalah build tool yang bersifat spesifik untuk sistem operasi tertentu. Beberapa contoh
dari build tool, diantaranya adalah:
 GNU Make (ingat siklus ./configure, make, make install)
 Jam
 rake (untuk Ruby), dan lain-lain

Ant merupakan software untuk keperluan build tool yang bersifat cross platform, bisa digunakan pada berbagai sistem
operasi yang mendukung Java. Meskipun demikian, pembahasan dalam tulisan ini akan menggunakan Linux. Jika anda
menggunakan Windows, silahkan sesuaikan dengan sistem operasi anda (hanya jika diperlukan). Selama tidak
menggunakan fitur spesifik dari sistem operasi yang bersangkutan (diantaranya dengan tag <exec>), maka pembahasan
ini bersifat cross platform.

Mengapa Harus Menggunakan Build Tool?

Build tool tidak diperlukan jika software yang akan kita bangun sangat sederhana (seperti misalnya hanya menampilkan
satu atau beberapa baris tulisan) dan kita tidak keberatan untuk menuliskan dan mencantumkan berbagai dependencies
dari software tersebut (misalnya berbagai file jar yang kita perlukan). Jika aplikasi yang kita bangun relatif kompleks,
melibatkan banyak dependencies, dengan struktur direktori tertentu, serta memerlukan banyak eksekusi atau
menjalankan tools (misalnya jar, rmic, javac, bzip2, dan lain-lain), maka kita memerlukan build tool untuk meng-
”otomatiskan” proses membangun (compile, test, run, deploy) software tersebut. Anda bisa membayangkan sendiri jika
harus mengetikkan berpuluh-puluh baris untuk siklus compile, test, run, deploy jika tidak menggunakan build tool.

4.3 Praktik

Instalasi ANT di Windows XP

Contents

1. 1 Kebutuhan Paket
2. 2 Instalasi
3. 3 Konfigurasi ANT_HOME dan PATH
4. 4 Testing

Kebutuhan Paket
 Sebelumnya Anda sudah harus memiliki instalasi JDK. Untuk referensinya dapat Anda lihat di artikel Install
Java di Windows XP Professional atau Windows 10.

Instalasi
 Ambil paket binary dalam bentuk zip file dari situs Apache Ant: http://ant.apache.org/bindownload.cgi.

20
 Ekstrak paket zip yang didownload ke folder C:\
 Struktur folder hasil ekstrak akan tampak seperti gambar di bawah.

Konfigurasi ANT_HOME dan PATH

 Masuk ke Start | My Computer | klik kanan lalu pilih Properties

 Masuk ke tab Advanced dan klik tombol Environment Variables dari dialog yang muncul

21
 Pada dialog berikutnya, di bagian System Variables klik tombol New
 Masukkan folder apache ant ke dalam variable ANT_HOME :
o Variable Name : ANT_HOME
o Variable Value : C:\apache-ant-1.7.0

 Klik tombol OK

22
 Cari variable PATH di bagian agak bawah dari System Variables dan klik Edit
 Tambahkan ;%ANT_HOME%\bin; di bagian akhir dari Variable Value

 Klik tombol OK
 Selesai

Testing

 Masuk ke Start | Run | ketik cmd untuk menjalankan console / command prompt Windows XP
 Ketik ant -version pada command prompt tersebut. Hasil akan tampak seperti pada gambar.

23
  Selesai

Instalasi Apache ANT di Linux

Ant adalah software bebas dan mempunyai lisensi ASF (Apache Software Foundation). Ant bisa diperoleh di
http://ant.apache.org. Versi terakhir saat tulisan ini dibuat adalah versi 1.7.1. Download distribusi Ant seperti berikut ini:
[bpdp@bpdp-arch ant]$ ls -la
total 7484
drwxr-xr-x 2 bpdp users 4096 2009-09-01 03:08 .
drwxr-xr-x 26 bpdp users 4096 2009-09-19 17:37 ..
-rw-r--r-- 1 bpdp users 7641928 2008-07-09 16:19 apache-ant-1.7.1-bin.tar.bz2
[bpdp@bpdp-arch ant]$

Asumsi:
 JDK telah terinstall dan JAVA_HOME telah di-set.
 Ant akan diinstall di direktori $HOME/software/

Berikut adalah langkahnya:

1. $ cd software
2. $ tar -xjvf apache-ant-1.7.1-bin.tar.bz2

Hasilnya:

[bpdp@bpdp-arch software]$ pwd

/home/bpdp/software
[bpdp@bpdp-arch software]$ ls -la apache-ant-1.7.1/
total 276
drwxr-xr-x 6 bpdp users 4096 2008-06-27 12:04 .
drwxr-xr-x 25 bpdp users 4096 2009-09-28 10:05 ..
-rw-r--r-- 1 bpdp users 126 2008-06-27 12:04 INSTALL
-rw-r--r-- 1 bpdp users 51380 2008-06-27 12:04 KEYS
-rw-r--r-- 1 bpdp users 15289 2008-06-27 12:04 LICENSE
-rw-r--r-- 1 bpdp users 1270 2008-06-27 12:04 NOTICE
-rw-r--r-- 1 bpdp users 4119 2008-06-27 12:04 README
-rw-r--r-- 1 bpdp users 146814 2008-06-27 12:04 WHATSNEW
drwxr-xr-x 2 bpdp users 4096 2009-09-04 10:23 bin
drwxr-xr-x 9 bpdp users 4096 2009-09-04 10:23 docs
drwxr-xr-x 3 bpdp users 4096 2009-09-04 10:23 etc
-rw-r--r-- 1 bpdp users 7160 2008-06-27 12:04 fetch.xml
-rw-r--r-- 1 bpdp users 4445 2008-06-27 12:04 get-m2.xml
drwxr-xr-x 2 bpdp users 4096 2009-09-04 10:23 lib
[bpdp@bpdp-arch software]$

24
Setelah itu, setting konfigurasi environment variable di $HOME/.bashrc sebagai berikut:

export ANT_HOME=/home/bpdp/software/apache-ant-1.7.1/
export PATH=$PATH:$ANT_HOME/bin

Setelah itu setiap kali login, shell sudah mengenali ant yang telah kita install. Jika telah terinstall dengan benar, hasil
instalasi adalah sebagai berikut:

[bpdp@bpdp-arch software]$ ant -version

Apache Ant version 1.7.1 compiled on June 27 2008
[bpdp@bpdp-arch software]$

Jika ingin mengetahui lebih lengkap lagi, gunakan parameter -diagnostics.

Struktur Direktori dan Berbagai File

Untuk keperluan praktikum ini, buat struktur direktori dengan berbagai file berikut ini:
|-- build
| `-- classes
`-- src
`-- simpleant
`-- HelloWorld.java

Isi dari file HelloWorld.java adalah sebagai berikut:

package simpleant;
public class HelloWorld {
public static void main(String[] args) {
System.out.println("Hello World");
}
}

Kompilasi dan Eksekusi Program Tanpa Apache Ant - Shell

$ javac -sourcepath src -d build/classes/ src/simpleant/HelloWorld.java

$ java -cp build/classes simpleant.HelloWorld
Hello World
$

Kompilasi dan Eksekusi Program Tanpa Apache Ant - jar

Untuk keperluan ini anda harus membuat file manifest terlebih dahulu (misalnya helloworld-manifest).

cd

$ cat helloworld-manifest
Main-Class: simpleant.HelloWorld
$ mkdir build/jar
$ jar cfm build/jar/HelloWorld.jar helloworld-manifest -C build/classes/ .
$ java -jar build/jar/HelloWorld.jar
Hello World

Kompilasi dan Eksekusi Menggunakan Apache Ant

Untuk menggunakan Apache Ant, kita harus membuait suatu file yang berisi tasks (berbagai tugas) yang bisa
dikerjakan oleh Apache Ant. File tersebut secara default mempunyai nama build.xml. Berikut ini adalah isi build.xml
yang terletak pada direktori root dari project.

<project name="HelloWorld" basedir="." default="main">

<property name="src.dir" value="src"/>
<property name="build.dir" value="build"/>

25
<property name="classes.dir" value="${build.dir}/classes"/>
<property name="jar.dir" value="${build.dir}/jar"/>
<property name="main-class" value="simpleant.HelloWorld"/>
<target name="clean">
<delete dir="${build.dir}"/>
</target>
<target name="compile">
<mkdir dir="${classes.dir}"/>
<javac srcdir="${src.dir}" destdir="${classes.dir}"/>
</target>
<target name="jar" depends="compile">
<mkdir dir="${jar.dir}"/>
<jar destfile="${jar.dir}/${ant.project.name}.jar" basedir="${classes.dir}">
<manifest>
<attribute name="Main-Class" value="${main-class}"/>
</manifest>
</jar>
</target>
<target name="run" depends="jar">
<java jar="${jar.dir}/${ant.project.name}.jar" fork="true"/>
</target>
<target name="clean-build" depends="clean,jar"/>
<target name="main" depends="clean,run"/>
</project>

Dengan demikian, direktori yang kita buat sekarang akan mempunyai struktur sebagai berikut:

[bpdp@bpdp-arch helloworld-with-ant]$ tree .

|-- build.xml
`-- src
`-- simpleant
`-- HelloWorld.java
2 directories, 2 files

Jalankan “ant” pada root directory project yang bersangkutan seperti berikut ini:

[bpdp@bpdp-arch helloworld-with-ant]$ ant clean

Buildfile: build.xml
clean:
[delete] Deleting directory /home/bpdp/kerjaan/src/java/helloworld-with-ant/build
BUILD SUCCESSFUL
Total time: 0 seconds
[bpdp@bpdp-arch helloworld-with-ant]$ ant run
Buildfile: build.xml
compile:
[mkdir] Created dir: /home/bpdp/kerjaan/src/java/helloworld-with-ant/build/classes
[javac] Compiling 1 source file to /home/bpdp/kerjaan/src/java/helloworld-with-
ant/build/classes
jar:
[mkdir] Created dir: /home/bpdp/kerjaan/src/java/helloworld-with-ant/build/jar
[jar] Building jar: /home/bpdp/kerjaan/src/java/helloworld-with-
ant/build/jar/HelloWorld.jar
run:
[java] Hello World
BUILD SUCCESSFUL
Total time: 1 second
[bpdp@bpdp-arch helloworld-with-ant]$

4.4 Latihan

Gantilah HelloWorld.java dengan program untuk menampilkan hasil perkalian 20*150 dan nama kelas Perkalian.

4.5 Tugas

Buatlah proyek baru yang terdiri atas 2 file source code Java. File pertama adalah definisi class, file kedua adalah file
utama yang di dalamnya akan membuat instance dari class yang telah didefinisikan pada file pertama. Buatlah file
build.xml untuk keperluan seperti pada praktik di atas dan tunjukkan bahwa program yang anda buat tersebut berhasil
dikompilasi dan dijalankan.

26