Panduan Pemaketan Debian Cara Sederhana
Tujuan
Dokumen ini menjelaskan langkah-langkah pembuatan paket Debian sederhana.
Pengetahuan dasar
Pengetahuan akan hal-hal berikut akan membantu Anda membuat paket Debian dengan benar:
- Mekanisme pembangunan perangkat lunak, misalnya dengan Makefile atau autotools.
- Cara kerja instalasi paket Debian (dpkg, apt-get).
Dalam dokumen ini diasumsikan paket khayalan yang dibangun menggunakan autotools.
Peralatan
Silakan mulai dengan menginstal peralatan berikut:
- cdbs
- debhelper
- devscripts
- penyunting teks
Mulai bekerja
Siapkan paket yang belum ada paket Debiannya. Ciri-cirinya adalah dengan tidak ada direktori `DEBIAN` atau debian di dalamnya. Misalnya kita punya perangkat lunak bernama `labusiyam`. Perangkat lunak ini menggunakan autotools (ciri-cirinya, dibangun dengan cara `./configure` kemudian `make` dan `make install`).
Pendataan berkas yang diinstal
Saat melakukan `make install` perangkat lunak ini akan menginstal:
- /usr/bin/labusiyam
- /usr/lib/liblabusiyam.so.0.0.1
- /usr/lib/liblabusiyam.so.0 (symlink)
- /usr/lib/liblabusiyam.so (symlink)
- /usr/include/labusiyam.h
- /etc/labusiyam/config.txt
- /usr/share/labusiyam/data.txt
Tahu dari mana bahwa berkas-berkas di atas yang diinstal? Silakan tengok Makefile.am di seluruh direktori yang ada di dalam kode sumbernya. Ciri-ciri berkas yang diinstal adalah berkas yang ada didefinisikan dalam variabel:
- bin_PROGRAMS
- LTLIBRARIES
- variabel yang mengandung kata 'dir', misalnya:
configdir$(sysconf) config_DATAconfig.txt
berarti berkas-berkas yang ada di dalam variabel berikutnya (yang tanpa kata `dir` akan diinstal ke dalam direktori itu).
Semua berkas yang akan diinstal harus dicatat dengan baik.
Pengategorian paket
Dalam daftar berkas ada tiga jenis paket yang akan kita buat:
- Paket binari, Paket ini berisi semua program dalam `/usr/bin` atau `/usr/sbin` atau direktori eksekutabel lainnya. Juga berisi berkas-berkas pendukung (data dan konfigurasi)
- Paket pustaka program, Paket ini berisi semua pustaka program yang memiliki pola nama `/usr/lib/lib*`. Nama paket ini harus dimulai dengan kata `lib` dan diakhiri dengan nomor SONAME.
- Paket pengembangan, Paket ini berisi symlink ke pustaka program dan semua berkas yang dibutuhkan untuk pengembangan (misalnya berkas-berkas kepala kode sumber (header files)).
- Paket debug, Paket ini berisi salinan binari dan pustaka program dengan menyertakan simbol di dalamnya. Gunanya untuk menelusuri kesalahan program dengan debugger.
Jadi dalam kasus kita kita akan buat paket-paket berikut:
- labusiyam
- liblabusiyamX
- liblabusiyam-dev
- liblabusiyamX-dbg
- labusiyam-dbg
X dalam liblabusiyamX belum kita ketahui. Namun nilainya dapat kita cari dengan cara:
$ make
# asumsi proses berjalan lancar
$ cd src/.libs
# asumsi lokasinya ada di src/
$ objdump -x liblabusiyam.so.0.0.1 | grep SONAME
Perintah di atas akan menghasilkan sesuatu seperti :
SONAME liblabusiyam.so.0
Angka terakhir itulah (0) yang dijadikan X. Jadi daftar final paket kita adalah:
- labusiyam
- liblabusiyam0
- liblabusiyam-dev
- liblabusiyam0-dbg
- labusiyam-dbg
Pendefinisian paket
$ mkdir debian
cd debian
touch changelog control rules
chmod +x rules
touch labusiyam.install labusiyam0.install labusiyam-dev.install
echo 4 > compat
Sekarang kalau dilihat kita akan lihat:
$ ls -l
hasilnya:
total 8 -rw-r--r-- 1 mdamt mdamt 0 2007-07-11 16:07 changelog -rw-r--r-- 1 mdamt mdamt 2 2007-07-11 16:07 compat -rw-r--r-- 1 mdamt mdamt 0 2007-07-11 16:07 control -rw-r--r-- 1 mdamt mdamt 0 2007-07-11 16:07 labusiyam0.install -rw-r--r-- 1 mdamt mdamt 0 2007-07-11 16:07 labusiyam-dev.install -rw-r--r-- 1 mdamt mdamt 0 2007-07-11 16:07 labusiyam.install -rwxr-xr-x 1 mdamt mdamt 0 2007-07-11 16:07 rules
Membuat program pembangun paket
Sunting berkas rules. Isikan informasi berikut:
#!/usr/bin/make -f include /usr/share/cdbs/1/rules/debhelper.mk include /usr/share/cdbs/1/class/autotools.mk DEB_DH_STRIP_ARGS := --dbg-package=liblabusiyam0 --dbg-package=labusiyam
Berkas di atas menandakan bahwa pembangunan paket akan menggunakan skrip cdbs. Di situ juga didefinisikan dua paket debug yang kita punya.
Membuat definisi paket
Sunting berkas control. Isikan informasi berikut:
Source: labusiyam Section: base Priority: optional Maintainer: Prajurit Ryan <ryan@private.tentara.mil> Build-Depends: debhelper, cdbs, pkg-config, libgtk2.0-dev Standards-Version: 3.6.0 Package: labusiyam Section: base Architecture: any Depends: ${shlibs:Depends}, ${misc:Depends}, Description: Labusiyam Labusiyam digunakan untuk membuat sayur. Package: liblabusiyam0 Section: base Architecture: any Depends: ${shlibs:Depends}, ${misc:Depends}, Description: Pustaka Labusiyam Pustaka Labusiyam digunakan untuk membuat sayur lainnya. Package: labusiyam-dev Section: base Architecture: all Depends: ${shlibs:Depends}, ${misc:Depends}, Description: Pengembangan Labusiyam Paket ini digunakan untuk membantu pembuatan sayur lain.
Perhatikan untuk mengisi kolom-kolom `Section`, `Architecture`, dan `Build-Depends` dengan benar. Mari kita lihat satu-persatu:
- Definisi pertama kali dibuka dengan mendefinisikan paket sumber, ditandai dengan adanya kolom `Source`. Isikan dengan nama paketnya. `Build-Depends` diisi dengan paket-paket yang dibutuhkan selama pembangunan paket ini (semua paket yang Anda butuhkan saat melakukan make dan make install).
Source: labusiyam Section: base Priority: optional Maintainer: Prajurit Ryan <ryan@private.tentara.mil> Build-Depends: debhelper, cdbs, pkg-config, libgtk2.0-dev Standards-Version: 3.6.0
- Kemudian definisikan paket binari kita, yaitu `labusiyam`. Section diisi sesuai dengan kategori perangkat lunaknya. Silakan konsultasi dengan manual Debian. Arsitektur diisi dengan `any` karena mengandung berkas-berkas binari.
Package: labusiyam Section: base Architecture: any Depends: ${shlibs:Depends}, ${misc:Depends}, Description: Labusiyam Labusiyam digunakan untuk membuat sayur.
- Lalu paket pustaka.
Package: liblabusiyam0 Section: base Architecture: any Depends: ${shlibs:Depends}, ${misc:Depends}, Description: Pustaka Labusiyam Pustaka Labusiyam digunakan untuk membuat sayur lainnya.
- Lalu paket pengembangan. Arsitektur kita isi dengan `all` karena ia hanya menginstal berkas labusiyam.h dan tautan simbolik saja. Bila ia juga menyertakan berkas binari maka harus kita ganti ke `any`.
Package: labusiyam-dev Section: base Architecture: all Depends: ${shlibs:Depends}, ${misc:Depends}, Description: Pengembangan Labusiyam Paket ini digunakan untuk membantu pembuatan sayur lain.
- Cukup sekian. Paket debug tidak perlu kita definisikan dalam `debian/control`.
Mendaftarkan berkas
Selanjutnya adalah mendaftarkan berkas yang akan diinstal dalam masing-masing paket. Mari kita sunting berkas-berkas berikut dan mengisinya dengan informasi yang juga diberikan di bawah.
- labusiyam.install
debian/tmp/usr/bin/labusiyam debian/tmp/etc/labusiyam/config.txt debian/tmp/usr/share/labusiyam/data.txt
- liblabusiyam0.install
debian/tmp/usr/lib/liblabusiyam.so.0.0.1 debian/tmp/usr/lib/liblabusiyam.so.0
atau boleh juga:debian/tmp/usr/lib/liblabusiyam.so.*
- liblabusiyam-dev.install
debian/tmp/usr/lib/liblabusiyam.so debian/tmp/usr/include/labusiyam.h
Membuat catatan versi
Sunting berkas changelog, isikan:
labusiyam (0.0.1-0blankon1) konde; urgency=low * New release. -- Prajurit Ryan <ryan@private.tentara.mil> Wed, 4 Jul 2007 11:37:37 +0300
Perhatikan bahwa penulisan tanggal harus dilakukan dengan bentuk seperti di atas. Silakan konsultasi dengan manual Debian untuk lebih jelasnya. Perhatikan di mana harus menulis spasi dan di mana tidak. Penomoran nomor versi bergantung dengan konvensi distribusi. Kata `konde` di atas menandakan bahwa paket ini ditujukan untuk distribusi `konde`. Pada Debian biasanya menggunakan `unstable` atau `testing`.
Membangun paket
Sekarang mari kita bangun paketnya:
$ cd ..
# tadi ada di dalam direktori debian/ sekarang kita naik satu tingkat
$ dpkg-buildpackage -rfakeroot
Bila tidak ada aral melintang, maka dalam direktori atasnya lagi kita akan punya berkas-berkas berikut:
- labusiyam_0.0.1-0ubuntu1_i386.deb
- liblabusiyam0_0.0.1-0ubuntu1_i386.deb
- liblabusiyam-dev_0.0.1-0ubuntu1_all.deb
- liblabusiyam0-dbg_0.0.1-0ubuntu1_i386.deb
- labusiyam-dbg_0.0.1-0ubuntu1_i386.deb
- labusiyam_0.0.1-0ubuntu1.dsc
- labusiyam_0.0.1-0ubuntu1.tar.gz
Pengecekan
Pengecekan perlu kita lakukan pada tiap-tiap paket yang dihasilkan guna memastikan bahwa paket-paket tersebut berisi berkas-berkas yang benar.
Pengecekan daftar isi
Mengeceknya mudah. Gunakan perintah:
$ dpkg --contents nama-berkas.deb
Dalam hasil keluaran biasanya akan muncul bahwa ada berkas bernama changelog.gz, changelog.Debian.gz, dan copyright. Ini tidak apa-apa. Namun pastikan bahwa berkas-berkas yang sudah kita masukkan ke dalam berkas*.install benar-benar ada dalam hasil keluarannya.
Pengecekan instalasi
Cek dengan menginstal paket tersebut:
$ sudo dpkg -i nama-berkas.deb
Biasanya masalah yang timbul disini adalah ketidakcocokan dalam ketergantungan paket, dsb.
Pengecekan kesalahan lain
Gunakan perangkat lunak khusus pengecekan paket, misalnya linda atau lintian. Caranya silakan lihat halaman manualnya masing-masing.
Ada pertanyaan?
Silakan tanya ke milis ubuntu-id@googlegroups.com dengan subyek [PAKET].
Tautan penting
- [http://www.debian.org/doc/debian-policy Debian Policy Manual]
- [https://perso.duckcorp.org/duck/cdbs-doc/cdbs-doc.xhtml Manual CDBS]
Tidak ada komentar:
Posting Komentar