Cách thêm chính xác bao gồm các thư mục với CMake

Khoảng một năm trước tôi đã hỏi về sự phụ thuộc tiêu đề trong CMake .

Gần đây tôi nhận ra rằng vấn đề dường như là CMake coi những tệp tiêu đề đó là bên ngoài dự án. Ít nhất, khi tạo dự án Code :: Blocks, các tệp tiêu đề không xuất hiện trong dự án (các tệp nguồn thực hiện). Do đó, dường như CMake coi những tiêu đề đó là bên ngoài của dự án và không theo dõi chúng trong phần phụ thuộc.

Một tìm kiếm nhanh trong hướng dẫn CMake chỉ chỉ ra include_directoriesdường như không làm được điều tôi muốn ...

Cách thích hợp để báo hiệu cho CMake rằng một thư mục cụ thể có chứa các tiêu đề được bao gồm và những tiêu đề đó cần được theo dõi bởi Makefile được tạo?

Hai điều phải được thực hiện.

Đầu tiên thêm thư mục để được bao gồm:

target_include_directories(test PRIVATE ${YOUR_DIRECTORY})

Trong trường hợp bạn bị mắc kẹt với phiên bản CMake rất cũ (2.8.10 trở lên) mà không có hỗ trợ target_include_directories, bạn cũng có thể sử dụng di sản include_directoriesthay thế:

include_directories(${YOUR_DIRECTORY})

Sau đó, bạn cũng phải thêm các tệp tiêu đề vào danh sách các tệp nguồn của mình cho mục tiêu hiện tại, ví dụ:

set(SOURCES file.cpp file2.cpp ${YOUR_DIRECTORY}/file1.h ${YOUR_DIRECTORY}/file2.h)
add_executable(test ${SOURCES})

Bằng cách này, các tệp tiêu đề sẽ xuất hiện dưới dạng các phụ thuộc trong Makefile và ví dụ như trong dự án Visual Studio được tạo, nếu bạn tạo một tệp.

Cách sử dụng các tệp tiêu đề đó cho một số mục tiêu:

set(HEADER_FILES ${YOUR_DIRECTORY}/file1.h ${YOUR_DIRECTORY}/file2.h)

add_library(mylib libsrc.cpp ${HEADER_FILES})
target_include_directories(mylib PRIVATE ${YOUR_DIRECTORY})
add_executable(myexec execfile.cpp ${HEADER_FILES})
target_include_directories(myexec PRIVATE ${YOUR_DIRECTORY})

Đầu tiên, bạn sử dụng include_directories()để nói với CMake để thêm thư -Imục vào dòng lệnh biên dịch. Thứ hai, bạn liệt kê các tiêu đề trong add_executable()hoặc add_library()cuộc gọi của bạn .

Ví dụ: nếu nguồn của dự án của bạn nằm trong srcvà bạn cần các tiêu đề từ đó include, bạn có thể làm như thế này:

include_directories(include)

add_executable(MyExec
  src/main.c
  src/other_source.c
  include/header1.h
  include/header2.h
)

CMake giống ngôn ngữ kịch bản hơn nếu so sánh nó với các cách khác để tạo Makefile (ví dụ: make hoặc qmake). Nó không tuyệt lắm như Python, nhưng vẫn vậy.

Không có thứ gọi là " cách thích hợp " nếu tìm kiếm trong các dự án mã nguồn mở khác nhau về cách mọi người bao gồm các thư mục. Nhưng có hai cách để làm điều đó.

1. Crude include_directories sẽ nối thêm một thư mục vào dự án hiện tại và tất cả các dự án hậu duệ khác mà bạn sẽ nối thông qua một loạt các lệnh add_subdirectory . Đôi khi mọi người nói rằng cách tiếp cận như vậy là di sản.

2. Một cách thanh lịch hơn là với target_include_directories . Nó cho phép nối thêm một thư mục cho một dự án / mục tiêu cụ thể mà không (có thể) kế thừa không cần thiết hoặc xung đột các thư mục bao gồm khác nhau. Cũng cho phép thực hiện ngay cả một cấu hình tinh tế và nối thêm một trong các dấu hiệu sau cho lệnh này.

RIÊNG TƯ - chỉ sử dụng cho mục tiêu xây dựng được chỉ định này

PUBLIC - sử dụng nó cho mục tiêu được chỉ định và cho các mục tiêu liên kết với dự án này

INTERFACE - chỉ sử dụng nó cho các mục tiêu liên kết với dự án hiện tại

Tái bút

1. Cả hai lệnh đều cho phép đánh dấu một thư mục là HỆ THỐNG để đưa ra gợi ý rằng đó không phải là doanh nghiệp của bạn mà các thư mục được chỉ định sẽ chứa các cảnh báo.

2. Một câu trả lời tương tự là với các cặp lệnh khác target_compile_def địnhs / add_def địnhs , target_compile_options / CMAKE_C_FLAGS

Thêm include_directories("/your/path/here").

Điều này sẽ tương tự như gọi gccvới -I/your/path/here/tùy chọn.

Hãy chắc chắn rằng bạn đặt dấu ngoặc kép xung quanh đường dẫn. Những người khác đã không đề cập đến điều đó và nó khiến tôi bế tắc trong 2 ngày. Vì vậy, câu trả lời này dành cho những người rất mới với CMake và rất bối rối.

Tôi đã từng gặp vấn đề tương tự.

Thư mục dự án của tôi là như thế này:

    --project
    ---Classes
    ----Application
    -----.h and .c files
    ----OtherFolders
    --main.cpp

Và những gì tôi đã sử dụng để bao gồm các tệp trong tất cả các thư mục đó:

    file(GLOB source_files
            "*.h"
            "*.cpp"
            "Classes/*/*.cpp"
            "Classes/*/*.h"
    )

    add_executable(Server ${source_files})

Và nó hoàn toàn làm việc.