Tidadigi Logo

cmake command in linux

Tìm hiểu về CMake Command trong Linux: Hướng dẫn chi tiết cho người mới bắt đầu

Bạn là một lập trình viên C/C++ đang làm việc trên Linux và muốn tìm hiểu về cách quản lý dự án một cách hiệu quả? Chắc hẳn bạn đã từng nghe đến CMake, một công cụ build system generator mạnh mẽ. Trong bài viết này, chúng ta sẽ khám phá các CMake command quan trọng, cách chúng hoạt động và cách áp dụng chúng vào thực tế để đơn giản hóa quá trình xây dựng dự án của bạn.

CMake không trực tiếp biên dịch code của bạn. Thay vào đó, nó tạo ra các file build (ví dụ như Makefile cho Linux) mà bạn có thể sử dụng với các công cụ build khác như Make, Ninja, hoặc thậm chí IDE của bạn. Điều này giúp dự án của bạn trở nên portable hơn, vì CMake có thể tạo ra các build system khác nhau cho các nền tảng khác nhau.

Tại sao nên sử dụng CMake?

Trước khi đi sâu vào các command, hãy cùng điểm qua những lợi ích mà CMake mang lại:

  • Tính linh hoạt: CMake hỗ trợ nhiều nền tảng và trình biên dịch khác nhau.
  • Dễ dàng quản lý dependencies: CMake giúp bạn quản lý các thư viện và dependencies một cách hiệu quả.
  • Khả năng mở rộng: Bạn có thể mở rộng CMake bằng các module và function tùy chỉnh.
  • Khả năng tái sử dụng: CMake cho phép bạn tạo các build script tái sử dụng cho nhiều dự án.

Cấu trúc cơ bản của một CMake Project

Một dự án CMake thường bao gồm một hoặc nhiều file CMakeLists.txt. File này chứa các command CMake, chỉ dẫn cách build dự án. Một cấu trúc dự án đơn giản có thể trông như sau:

  my_project/
  ├── CMakeLists.txt
  ├── src/
  │   ├── main.cpp
  │   └── ...
  └── include/
      └── ...

File CMakeLists.txt nằm ở thư mục gốc của dự án và mô tả cách build các source code trong thư mục src và sử dụng các header files trong thư mục include.

Các CMake Command quan trọng

Bây giờ, chúng ta sẽ đi vào chi tiết các CMake command quan trọng nhất mà bạn cần biết:

cmake_minimum_required()

Command này chỉ định phiên bản tối thiểu của CMake cần thiết để build dự án. Nó thường là dòng đầu tiên trong file CMakeLists.txt.

  cmake_minimum_required(VERSION 3.10)

Ví dụ trên yêu cầu phiên bản CMake tối thiểu là 3.10.

project()

Command này khai báo tên của dự án.

  project(MyProject)

Bạn có thể tùy chọn chỉ định ngôn ngữ lập trình của dự án.

  project(MyProject CXX)

Ví dụ trên khai báo dự án MyProject sử dụng ngôn ngữ C++.

add_executable()

Command này khai báo một file thực thi (executable) sẽ được build.

  add_executable(my_program src/main.cpp)

Ví dụ trên tạo ra một file thực thi tên là my_program từ source file src/main.cpp.

add_library()

Command này khai báo một thư viện (library) sẽ được build. Có hai loại thư viện chính: static và shared.

  add_library(mylibrary STATIC src/mylibrary.cpp)

Ví dụ trên tạo ra một thư viện static tên là mylibrary từ source file src/mylibrary.cpp.

  add_library(mylibrary SHARED src/mylibrary.cpp)

Ví dụ trên tạo ra một thư viện shared tên là mylibrary từ source file src/mylibrary.cpp.

target_link_libraries()

Command này liên kết các thư viện với một target (executable hoặc library).

  add_executable(my_program src/main.cpp)
  add_library(mylibrary STATIC src/mylibrary.cpp)
  target_link_libraries(my_program mylibrary)

Ví dụ trên liên kết thư viện mylibrary với file thực thi my_program.

include_directories()

Command này chỉ định các thư mục chứa các header files.

  include_directories(include)

Ví dụ trên thêm thư mục include vào danh sách các thư mục tìm kiếm header files.

find_package()

Command này tìm kiếm một package bên ngoài (ví dụ như Boost, OpenCV) và cung cấp thông tin về package đó.

  find_package(Boost REQUIRED COMPONENTS system filesystem)
  if(Boost_FOUND)
    include_directories(${Boost_INCLUDE_DIRS})
    target_link_libraries(my_program ${Boost_LIBRARIES})
  endif()

Ví dụ trên tìm kiếm package Boost, yêu cầu các components system và filesystem. Nếu Boost được tìm thấy, nó sẽ thêm các include directories và libraries của Boost vào target my_program.

set()

Command này dùng để định nghĩa biến.

  set(CMAKE_CXX_STANDARD 14)
  set(CMAKE_CXX_STANDARD_REQUIRED ON)

Ví dụ trên đặt chuẩn C++ là 14 và yêu cầu trình biên dịch phải hỗ trợ chuẩn này.

Ví dụ thực tế: Xây dựng một dự án đơn giản với CMake

Giả sử chúng ta có một dự án đơn giản với cấu trúc sau:

  my_project/
  ├── CMakeLists.txt
  ├── src/
  │   ├── main.cpp
  │   └── mylibrary.cpp
  └── include/
      └── mylibrary.h

Nội dung của các file như sau:

include/mylibrary.h

  #ifndef MYLIBRARY_H
  #define MYLIBRARY_H

  int add(int a, int b);

  #endif

src/mylibrary.cpp

  #include "mylibrary.h"

  int add(int a, int b) {
    return a + b;
  }

src/main.cpp

  #include 
  #include "mylibrary.h"

  int main() {
    int result = add(5, 3);
    std::cout << "The result is: " << result << std::endl;
    return 0;
  }

File CMakeLists.txt sẽ có nội dung như sau:

  cmake_minimum_required(VERSION 3.10)
  project(MyProject CXX)

  include_directories(include)

  add_library(mylibrary STATIC src/mylibrary.cpp)

  add_executable(my_program src/main.cpp)
  target_link_libraries(my_program mylibrary)

  set(CMAKE_CXX_STANDARD 14)
  set(CMAKE_CXX_STANDARD_REQUIRED ON)

Để build dự án này, bạn thực hiện các bước sau:

  1. Tạo một thư mục build trong thư mục gốc của dự án: mkdir build
  2. Di chuyển vào thư mục build: cd build
  3. Chạy CMake: cmake ..
  4. Build dự án: make

Sau khi build thành công, bạn sẽ có một file thực thi my_program trong thư mục build. Bạn có thể chạy nó bằng lệnh ./my_program.

So sánh CMake với các Build System khác

Để hiểu rõ hơn về vai trò của CMake, hãy so sánh nó với một số build system khác:

Build System Ưu điểm Nhược điểm Phù hợp với
Make Đơn giản, phổ biến trên Unix-like systems Khó quản lý các dự án lớn, cú pháp phức tạp Các dự án nhỏ và vừa, yêu cầu kiểm soát chi tiết
CMake Linh hoạt, hỗ trợ nhiều nền tảng, dễ quản lý dependencies Cần học cú pháp riêng Các dự án lớn, yêu cầu tính portable
Ninja Tốc độ build nhanh Khó đọc và debug Các dự án lớn, yêu cầu tốc độ build cao

FAQ về CMake Command

Câu hỏi 1: CMake có thể sử dụng với ngôn ngữ nào?

Trả lời: Mặc dù thường được sử dụng với C/C++, CMake cũng hỗ trợ các ngôn ngữ khác như Fortran, Java, và CUDA.

Câu hỏi 2: Làm thế nào để debug CMake scripts?

Trả lời: Bạn có thể sử dụng các lệnh message() để in thông tin ra console, hoặc sử dụng các IDE có hỗ trợ debug CMake scripts.

Câu hỏi 3: Làm thế nào để quản lý dependencies trong CMake?

Trả lời: Bạn có thể sử dụng find_package() để tìm kiếm các package bên ngoài, hoặc sử dụng các công cụ quản lý dependencies như CPM (CMake Package Manager).

Câu hỏi 4: Sự khác biệt giữa add_library(STATIC) và add_library(SHARED) là gì?

Trả lời: STATIC tạo ra một thư viện tĩnh, được liên kết trực tiếp vào file thực thi. SHARED tạo ra một thư viện động, được liên kết vào thời gian chạy.

Kết luận

CMake là một công cụ mạnh mẽ giúp đơn giản hóa quá trình build dự án C/C++ trên Linux và nhiều nền tảng khác. Bằng cách nắm vững các CMake command cơ bản và cách chúng hoạt động, bạn có thể quản lý dự án của mình một cách hiệu quả và tăng tính portable. Hy vọng bài viết này đã cung cấp cho bạn một cái nhìn tổng quan về CMake và giúp bạn bắt đầu sử dụng nó trong dự án của mình.

Last Updated : 22/08/2025