Alwin Arrasyid Blog

Build From Source: CMake

Diterbitkan pada 25 September 2022 18:30 +0700

Build From Source merupakan series baru yang akan diterbitkan secara berkala. Series ini akan mengulas catatan-catatan tentang cara-cara instalasi program open source secara manual dengan mengkompilasi kode program tersebut.

Lingkungan

Lingkungan yang digunakan adalah lingkungan Ubuntu Linux. Jika lingkungan tersebut tidak tersedia, maka Docker Desktop untuk Windows atau macOS dapat digunakan.

docker run --name cmake-ubuntu18 -it ubuntu:18.04 bash

Dengan demikian, lingkungan minimalis Ubuntu Linux 18.04 tersedia di macOS atau Windows.

Hampir semua aktivitas di series ini dilakukan di jendela terminal. Jika lingkungan Docker digunakan, hilangkan sudo dari semua perintah yang akan dijalankan.

CMake

CMake merupakan sebuah perangkat lunak yang dikembangkan oleh Kitware. CMake biasanya digunakan sebagai penengan antara kode program bahasa C/C++ dengan build system yang tersedia di sistem operasi yang digunakan. Di sistem operasi Linux, misalnya, CMake dapat menghasilkan Makefile yang dapat digunakan oleh make untuk mengkompilasi kode program.

Build From Source

Kode CMake dapat diunduh dari laman web resmi CMake di cmake.org/download. Versi terakhir yang tersedia ketika tulisan ini disusun adalah versi 3.24.2, sehingga versi tersebut yang akan digunakan.

Gunakan program CLI cURL untuk mengunduh kode program CMake. Gunakan apt untuk menginstall cURL jika belum tersedia di sistem operasi Ubuntu.

sudo apt update && sudo apt install -y curl

Unduh CMake ke direktori $HOME/build-from-source/cmake.

mkdir -p $HOME/build-from-source/cmake
cd $HOME/build-from-source/cmake
curl -OL https://github.com/Kitware/CMake/releases/download/v3.24.2/cmake-3.24.2.tar.gz

Berkas cmake-3.24.2.tar.gz tersedia di direktori $HOME/build-from-source/cmake jika cURL berhasil mengunduh kode sumber CMake.

Kode program yang diunduh masih dalam bentuk arsip tarball. Buka arsip tersebut dengan menggunakan CLI tar.

cd $HOME/build-from-source/cmake

tar -xzf cmake-3.24.2.tar.gz

Kode program CMake akan tersedia di direktori cmake-3.24.2 jika tar berhasil membuka tarball tersebut.

Sebelum mengkompilasi kode program CMake, unduh dan install package berikut ini dengan menggunakan apt:

  • make
  • gcc
  • g++
  • libssl-dev
sudo apt install -y make gcc g++ libssl-dev

Konfigurasi instalasi CMake dengan menjalankan perintah configure di direktori cmake-3.24.2.

cd cmake-3.24.2

./configure

Perintah ./configure melakukan serangkaian pengecekan dan penyesuaian dengan lingkungan sistem operasi yang digunakan dan akan menentukan lokasi instalasi atau installation prefix CMake. Lokasi instalasi tersebut biasanya berada di direktori /usr/local jika tidak ditentukan secara eksplisit.

Argumen --prefix=PREFIX_LOCATION dapat digunakan untuk menentukan lokasi instalasi CMake. Contoh, jika direktori $HOME/cmake akan digunakan sebagai prefix instalasi CMake, maka perintah configure yang dijalankan adalah

./configure --prefix=$HOME/cmake

Proses ini akan berjalan beberapa menit.

Jika pesan berikut ini sudah muncul di jendela terminal, maka kode program CMake sudah dapat dikompilasi.

CMake has bootstrapped.  Now run make.

Jalankan perintah make untuk mengkompilasi kode program CMake.

make

Proses kompilasi akan berjalan beberapa menit. Jika indikator proses menunjukkan angka 100% dan tidak ada pesan galat yang terlihat pada jendela terminal, maka proses kompilasi sudah selesai.

Gunakan kembali make untuk menginstall CMake yang telah dikompilasi.

make install

atau

sudo make install

Jalankan perintah berikut untuk memastikan bahwa proses instalasi berjalan lancar:

cmake --version

Jika instalasi berhasil, keluaran berikut akan tampil jika perintah di atas dijalankan.

cmake version 3.24.2

CMake suite maintained and supported by Kitware (kitware.com/cmake).

Jika pengaturan prefix instalasi diubah, pastikan prefix tersebut dikenali oleh environment variabel PATH. Misalkan, prefix instalasi CMake adalah $HOME/cmake, executable cmake akan tersedia di folder bin.

export PATH=$HOME/cmake/bin:$PATH

cmake --version

Baris export dapat ditambahkan ke $HOME/.bashrc agar CMake selalu tersedia ketika jendela terminal dibuka.

Menghapus CMake

CMake yang dikompilasi secara mandiri dapat dihapus dengan menjalankan perintah berikut di direktori kode program CMake:

cd $HOME/build-from-source/cmake/cmake-3.24.2

sudo make uninstall