Hiểu và vận dụng CMAKE_SYSTEM_NAME trong xây dựng dự án đa nền tảng

Phát triển phần mềm đa nền tảng luôn là mục tiêu hấp dẫn: viết mã một lần, chạy được trên nhiều hệ thống. Tuy nhiên, thực tế lại phức tạp hơn rất nhiều do sự khác biệt giữa các hệ điều hành như Windows, macOS và Linux — đặc biệt khi nói đến quá trình biên dịch và cấu hình. Việc sử dụng hệ thống build như CMake giúp đơn giản hóa quy trình này, nhưng chỉ khi bạn biết cách tận dụng đúng các biến môi trường của nó.

Nhiều lập trình viên mới thường dùng các biến điều kiện như WIN32, UNIX, hay APPLE để phân nhánh cấu hình. Cách làm này hoạt động trong những trường hợp đơn giản, nhưng nhanh chóng bộc lộ hạn chế khi dự án mở rộng sang các nền tảng chuyên biệt như Android, iOS, hoặc các thiết bị nhúng không có hệ điều hành truyền thống.

Lúc này, CMAKE_SYSTEM_NAME trở thành công cụ then chốt — một chuỗi ký tự mô tả chính xác tên hệ điều hành đích mà CMake đang xây dựng cho, thay vì chỉ là một cờ logic mơ hồ.

1. Vượt ra khỏi các biến điều kiện cổ điển

Dưới đây là ví dụ minh họa cách kiểm tra nền tảng bằng biến cổ điển:

if(WIN32)
    message(STATUS "Đang biên dịch trên Windows")
    add_definitions(-DWIN_PLATFORM)
elseif(APPLE)
    message(STATUS "Đang biên dịch trên Apple (macOS/iOS)")
    find_library(COREFOUNDATION_LIBRARY CoreFoundation)
elseif(UNIX)
    message(STATUS "Đang biên dịch trên hệ thống kiểu Unix")
    add_definitions(-DUSE_POSIX)
endif()

Vấn đề nằm ở chỗ: UNIX đúng với cả Linux, BSD, Android... Dù cùng thỏa điều kiện, nhưng mỗi nền tảng lại yêu cầu xử lý riêng biệt về thư viện, tùy chọn biên dịch hay đường dẫn hệ thống. Biến APPLE cũng không phân biệt được giữa macOS và iOS.

Thay vào đó, hãy dùng CMAKE_SYSTEM_NAME để so sánh trực tiếp tên hệ thống:

if(CMAKE_SYSTEM_NAME STREQUAL "Windows")
    message(STATUS "Mục tiêu: Windows")
    set(COMPILER_FLAGS ${COMPILER_FLAGS} /W4)
elseif(CMAKE_SYSTEM_NAME STREQUAL "Linux")
    message(STATUS "Mục tiêu: Hệ điều hành Linux")
    set(COMPILER_FLAGS ${COMPILER_FLAGS} -Wall -Wextra)
elseif(CMAKE_SYSTEM_NAME STREQUAL "Darwin")
    message(STATUS "Mục tiêu: macOS hoặc iOS (XNU kernel)")
    set(COMPILER_FLAGS ${COMPILER_FLAGS} -Weverything)
elseif(CMAKE_SYSTEM_NAME STREQUAL "Android")
    message(STATUS "Mục tiêu: Android")
    set(TARGET_ABI "armeabi-v7a")
endif()

Việc so sánh chuỗi rõ ràng giúp loại bỏ sự mơ hồ, đồng thời dễ bảo trì và mở rộng khi thêm nền tảng mới.

2. Hành vi của CMAKE_SYSTEM_NAME trong các ngữ cảnh khác nhau

2.1 Giá trị mặc định và chế độ script

Trong một dự án CMake thông thường, CMAKE_SYSTEM_NAME sẽ tự động nhận giá trị tương ứng với hệ điều hành máy chủ nếu không thực hiện cross-compilation. Tuy nhiên, khi chạy CMake ở chế độ script (cmake -P script.cmake), biến này không được thiết lập sẵn.

# script.cmake
if(NOT DEFINED CMAKE_SYSTEM_NAME)
    set(CMAKE_SYSTEM_NAME "Unknown")
endif()
message(STATUS "Hệ thống hiện tại: ${CMAKE_SYSTEM_NAME}")

Do đó, các script CMake cần được thiết kế để xử lý trường hợp thiếu thông tin hệ thống.

2.2 Vai trò trung tâm trong cross-compilation

Khi biên dịch chéo, CMAKE_SYSTEM_NAME phải được khai báo rõ ràng trong tệp toolchain. Đây là yếu tố bắt buộc để CMake kích hoạt cơ chế cross-compilation.

# toolchain-arm-linux.cmake
set(CMAKE_SYSTEM_NAME Linux)
set(CMAKE_SYSTEM_PROCESSOR arm)

set(CMAKE_C_COMPILER arm-linux-gnueabihf-gcc)
set(CMAKE_CXX_COMPILER arm-linux-gnueabihf-g++)

set(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM NEVER)
set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY ONLY)
set(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE ONLY)

Bằng cách đặt CMAKE_SYSTEM_NAME thành Linux, CMake sẽ biết rằng tất cả các lệnh tìm kiếm thư viện (find_library, find_path) nên hướng đến hệ thống đích, không phải máy chủ phát triển.

3. Danh sách một số giá trị phổ biến của CMAKE_SYSTEM_NAME

• Windows: Windows desktop (Visual Studio, MinGW)
• Linux: Các bản phân phối Linux (Ubuntu, Fedora, v.v.)
• Darwin: macOS, iOS, tvOS
• Android: Khi dùng NDK với CMake (từ phiên bản 3.7+)
• iOS: Khi target riêng iOS (CMake 3.14+)
• FreeBSD, OpenBSD: Các hệ điều hành BSD
• Generic: Môi trường nhúng, bare-metal (không OS)

Việc kiểm tra giá trị cụ thể giúp bạn viết các đoạn mã điều kiện chính xác, giảm thiểu lỗi do hiểu nhầm nền tảng.

4. Lời khuyên khi sử dụng

• Luôn dùng STREQUAL thay vì == để so sánh chuỗi trong CMake.
• Không phụ thuộc vào CMAKE_SYSTEM_NAME trong script nếu không chắc chắn nó đã được khởi tạo.
• Ưu tiên CMAKE_SYSTEM_NAME thay vì các biến kiểu boolean khi cần phân biệt chi tiết giữa các nền tảng.
• Kết hợp với CMAKE_SYSTEM_PROCESSOR để xác định đầy đủ kiến trúc mục tiêu (x86_64, ARM, RISC-V, ...).