Lära Organizing Sources in Subdirectories | Project Structure and Organization

As your project grows, placing all files in a single folder quickly becomes difficult to manage. Splitting code into subdirectories allows you to group related functionality together and keeps your project easy to navigate. CMake supports this by allowing each directory to have its own CMakeLists.txt file.

# MyProject/
# ├── CMakeLists.txt
# ├── src/
# │   ├── CMakeLists.txt
# │   └── main.c
# └── include/
#     ├── CMakeLists.txt
#     └── mylib.h

Each folder in this structure controls its own build configuration. The root project simply connects them.

cmake_minimum_required(VERSION 3.10)
project(MyProject)

add_subdirectory(include)
add_subdirectory(src)

When CMake runs, it enters the include directory first, processes its configuration, and then moves into src. This keeps your build logic modular and easier to update.

Note

add_subdirectory does not compile files by itself. It instructs CMake to process another folder and include it in the project build system.

For bigger projects, code is often grouped by purpose using nested directories. Libraries, utilities, and the main application are kept separate.

# NestedProject/
# ├── CMakeLists.txt
# ├── lib/
# │   ├── CMakeLists.txt
# │   ├── math/
# │   │   ├── CMakeLists.txt
# │   │   ├── math.c
# │   │   └── math.h
# │   └── utils/
# │       ├── CMakeLists.txt
# │       ├── utils.c
# │       └── utils.h
# └── app/
#     ├── CMakeLists.txt
#     └── main.c

Each folder defines its own rules and dependencies. CMake brings everything together into a single build system while letting each part remain independent. This structure makes testing, reusing code, and scaling your project much easier.

cmake_minimum_required(VERSION 3.10)
project(NestedProject)

add_subdirectory(lib)
add_subdirectory(app)

Var allt tydligt?

Tack för dina kommentarer!

Avsnitt 3. Kapitel 3

Fråga AI

Fråga vad du vill eller prova någon av de föreslagna frågorna för att starta vårt samtal

Suggested prompts:

Can you explain how dependencies between subdirectories are managed in CMake?

How do I structure the CMakeLists.txt files inside each subdirectory?

What are some best practices for organizing large CMake projects?

Svep för att visa menyn

# MyProject/
# ├── CMakeLists.txt
# ├── src/
# │   ├── CMakeLists.txt
# │   └── main.c
# └── include/
#     ├── CMakeLists.txt
#     └── mylib.h