Panduan Pemaketan Debian Cara Sederhana

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:

1. cdbs
2. debhelper
3. devscripts
4. 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]