Rozumienie CMakeLists

Poznanie tego jak działają pliki CMakeLists.txt

CMake

In our introductory tutorial, we used CMake as the build system for our application, but we only really paid close attention to one of our CMakeLists.txt files. Here, we're going to go over how it works in a bit more detail.

CMake jest użyteczny, bo umożliwia zautomatyzowanie większości rzeczy, które muszą się wydarzyć przez zbudowaniem programu.

CMakeLists.txt

You might remember this CMakeLists.txt file from the first tutorial:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
cmake_minimum_required(VERSION 3.16)
project(helloworld)

find_package(ECM REQUIRED NO_MODULE)
set(CMAKE_MODULE_PATH ${ECM_MODULE_PATH})

include(KDEInstallDirs)
include(KDECMakeSettings)
include(KDECompilerSettings NO_POLICY_SCOPE)

find_package(Qt${QT_MAJOR_VERSION} REQUIRED NO_MODULE COMPONENTS
    Core
    Quick
    Test
    Gui
    QuickControls2
    Widgets
)

find_package(KF${QT_MAJOR_VERSION} REQUIRED COMPONENTS
    Kirigami2
    I18n
    CoreAddons
)

add_subdirectory(src)

feature_summary(WHAT ALL INCLUDE_QUIET_PACKAGES FATAL_ON_MISSING_REQUIRED_PACKAGES)

The first line, cmake_minimum_required(VERSION 3.16) sets the version of CMake we will be calling.

After that, project(helloworld) defines the name of the project.

Then we get to a section where we include a number of necessary CMake and KDE settings by using extra-cmake-modules. You shouldn't worry too much about these lines for now and we won't need to change them in this tutorial.

The following section is important, because it specifies which dependencies we'll be bringing in at compile time. Let's look at the first:

11
12
13
14
15
16
17
18
find_package(Qt${QT_MAJOR_VERSION} REQUIRED NO_MODULE COMPONENTS
    Core
    Quick
    Test
    Gui
    QuickControls2
    Widgets
)

find_package() finds and loads the external component.
The first word is the framework, Qt. ${QT_MAJOR_VERSION} is a convenience variable provided by extra-cmake-modules that lets us choose the Qt version to be used, 5 or 6, depending on whether we use the CMake flag -DBUILD_WITH_QT6=ON.
REQUIRED tells CMake that these dependencies are indeed required and that it shall exit with an error if the package can not be found.
NO_MODULE switches CMake into the Config mode. We don't need to worry about that at the moment.
COMPONENTS jest parametrem, który poprzedza dany składnik szkieletu, który dołączymy.
Każde słowo po COMPONENTS odnosi się do danego składnika.

Uwaga

If you are looking to add any components listed in the KDE API documentation to your application, you may check the right sidebar for how to add the component with CMake. For instance, for Kirigami2 , you will find something like find_package(KF5Kirigami2), which with the addition of extra-cmake-modules becomes something like find_package(KF5 COMPONENTS Kirigami2).

Pay close attention to your included components, as omitting ones used in our code will stop our application from compiling.

The final line lets CMake print out which packages it has found. And above that, add_subdirectory(src) points CMake into the src/ directory, where it finds another CMakeLists.txt file:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
add_executable(helloworld)

target_sources(helloworld PRIVATE
    main.cpp
    resources.qrc
)

target_link_libraries(helloworld
    Qt${QT_MAJOR_VERSION}::Quick
    Qt${QT_MAJOR_VERSION}::Qml
    Qt${QT_MAJOR_VERSION}::Gui
    Qt${QT_MAJOR_VERSION}::QuickControls2
    Qt${QT_MAJOR_VERSION}::Widgets
    KF${QT_MAJOR_VERSION}::I18n
)

install(TARGETS helloworld ${KDE_INSTALL_TARGETS_DEFAULT_ARGS})

Ponieważ najwięcej robi pierwszy wiersz, to ten może być krótszy.

add_executable() takes care of generating our executable.
target_sources() lets us add files that will be used by our new executable.
target_link_libraries() dynamically links the libraries used in our code to our executable. Kirigami is not included here because we are using only its QML module.
install() puts our executable in its right place by using ${KDE_INSTALL_TARGETS_DEFAULT_ARGS}, a convenience variable provided by KDEInstallDirs in extra-cmake-modules that installs executables and libraries in their right place for you without needing to specify the absolute path, similarly to GNUInstallDirs.

Uwaga

Note that these libraries should match the components that we included in our previous CMakeLists.txt file - otherwise these components will not be included and our application won't compile.

To ustawienie będzie użyteczne podczas rozwijania większości aplikacji Kirigami.

Widoki listy

Rozumienie main.cpp