Mengkonfigurasi Zorba Menggunakan CMake

Sekarang kita akan mengkonfigurasi Zorba build dengan menjalankan CMake. Kami berasumsi bahwa persiapan membangun yang tepat (dijelaskan dalam Persiapan Membangun Zorba) telah dilakukan.

Instruksi di bagian ini didasarkan pada perintah eksekusi pada baris perintah. Hal ini juga memungkinkan mengkonfigurasi Zorba menggunakan utilitas konfigurasi GUI CMake jika Anda mau. Pada distro Linux, ini sering merupakan paket terpisah yang bernama “cmake-gui”. Pada Windows, GUI terinstal secara default dan bisa dimulai melalui menu Start. Di MacOS, tersedia sebagai varian “gui” dari paket CMake. Parameter konfigurasi penting – source and build directory; Generator CMake; flag konfigurasi – adalah sama apakah Anda menggunakan command-line atau bentuk GUI CMake. Hanya metode yang Anda tentukan akan berubah.

Langkah dasar untuk mengkonfigurasi Zorba adalah:

Ubah direktori kerja menjadi direktori {ZORBABUILD}:

cd {ZORBABUILD}

Jalankan cmake:

cmake [-G generator] [-D option = value …] {ZORBASRC}

di mana {ZORBASRC} mungkin merupakan jalur absolut atau relatif ke direktori sumber Zorba Anda. Misalnya, jika Anda menggunakan konvensi pembuatan direktori build sebagai subdirektori dari direktori sumber, Anda bisa mengetiknya saja

cmake ..

bersama dengan opsi -G atau -D yang diperlukan.

Perintah ini harus mengkonfigurasi Zorba dan bersiap untuk build. CMake akan memberitahu Anda jika lingkungan Anda kehilangan beberapa perpustakaan atau header pengembangan yang dibutuhkan. Arti argumen -G dan -D dijelaskan di bawah ini. Jika Anda perlu mengkonfigurasi ulang proyek nanti, CMake akan mengingat parameter generator dan parameter konfigurasi yang Anda pilih; Tidak perlu menentukan -G / -D setiap waktu.

Generator CMake (argumen -G)

CMake adalah meta build system. Ini mampu menghasilkan makefiles asli (misalnya GNU Make or NMake) dan ruang kerja IDE (misalnya Visual Studio atau KDevelop Projects), bergantung pada generator CMake mana yang dipilih. Secara default, ini akan menghasilkan proyek berbasis-Makefile bergaya UNIX. Anda menentukan generator yang akan digunakan dengan argumen -G untuk membuat cmake. Sebagai contoh, pada Windows, Anda dapat membuat solusi Visual Studio 10 dengan menjalankan perintah berikut di direktori {ZORBASRC}:

cmake -G “Visual Studio 10” {ZORBASRC}

Daftar Generator yang tersedia untuk instalasi CMake Anda dapat dilihat dengan mengetik

cmake –help

Parameter Konfigurasi (argumen -D)

Dalam kebanyakan keadaan, perlu ditentukan beberapa parameter ke CMake, seperti berbagai parameter konfigurasi yang disebutkan di atas dalam Lampiran Perpustakaan. Anda melakukan ini dengan serangkaian argumen -D untuk CMake. Misalnya, untuk membangun dukungan Zorba tanpa ICU (Unicode):

cmake -D ZORBA_NO_ICU = ON {ZORBASRC}

Daftar lengkap parameter konfigurasi Zorba dapat ditemukan di sini: Parameter Konfigurasi Zorba. CMake sendiri juga memiliki beberapa parameter konfigurasi yang mungkin penting bagi Anda; berikut ini adalah tiga yang paling umum:

CMake akan mencari perpustakaan pihak ketiga di berbagai lokasi standar. Jika Anda memasangnya di lokasi yang tidak biasa, Anda harus menyediakan jalur tambahan untuk mencari. Anda melakukan ini dengan menentukan parameter CMAKE_PREFIX_PATH. Parameter ini adalah daftar direktori terpisah yang dipisahkan titik koma di mana CMake seharusnya terlihat. Misalnya, jika Anda menginstal Xerces-C di / opt, coba yang berikut ini:

cmake -D CMAKE_PREFIX_PATH = / opt {ZORBASRC}

Kembali

Di Linux dan MacOS: Di baris perintah, titik koma diinterpretasikan oleh shell sebagai pemisah perintah. Agar bisa melewati daftar path yang dipisahkan tanda koma untuk parameter ini, pastikan untuk memperbesar daftar dalam tanda kutip tunggal atau ganda.

Pada Windows: Zorba menggunakan mekanisme khusus untuk menentukan jalur ke dependensi pihak ketiga pada Windows, yang menangani beberapa fitur tambahan seperti mengumpulkan DLL runtime untuk instalasi. Anda harus menggunakan mekanisme ini daripada CMAKE_PREFIX_PATH di Windows. Lihat Mekanisme Deteksi DLL

Zorba untuk informasi lebih lanjut.

Setelah Anda membangun Zorba, Anda mungkin ingin menginstalnya ke lokasi akhir. Anda menentukan lokasi ini dengan parameter CMAKE_INSTALL_PREFIX. Secara default, direktori ini akan menjadi {ZORBABUILD} / dist, yang tidak mungkin menjadi lokasi yang berguna.

Catatan: Setelah instalasi, direktori yang ditentukan disini akan berisi subdirektori seperti bin /, lib /, dan share /. Pada instalasi Unix dan MacOS, nilai umum untuk CMAKE_INSTALL_PREFIX adalah / usr / local. Pada Windows, seperti C: \ Program Files \ Zorba disarankan.

Catatan untuk proyek berbasis Makefile: Makefile yang diproduksi oleh CMake mendukung variabel DESTDIR yang umum. Namun, menentukan variabel ini pada waktu kompilasi tidak akan bekerja dengan Zorba, karena jalur instalasi tertentu dikodekan dengan keras ke dalam binari Zorba. Pastikan hanya menggunakan CMAKE_INSTALL_PREFIX.
Saat membuat proyek berbasis Makefile, CMake mendukung beberapa konfigurasi bangunan. Secara default, Zorba dibangun di konfigurasi Release, yang memungkinkan pengoptimalan kompilator dan tidak membangun informasi debug ke produk yang dihasilkan. Untuk mengubah mode build menjadi Debug, Anda dapat menentukan parameter CMAKE_BUILD_TYPE sebagai berikut:

cmake -D CMAKE_BUILD_TYPE = Debug {ZORBASRC}

Ini tidak diperlukan untuk ruang kerja berbasis IDE; Dalam hal ini, Anda dapat memilih tipe build dari dalam IDE.

Add a Comment

Your email address will not be published. Required fields are marked *