Rozumienie CMakeLists
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:
|
|
Pierwszy wiersz, project(helloworld)
określa nazwę projektu.
After that, we set the versions of our needed tools. cmake_minimum_required(VERSION 3.16)
sets the version of CMake we will be calling. We then use set()
to define variables (KF5_MIN_VERSION
and QT_MIN_VERSION
) containing the versions of KDE Frameworks and Qt.
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.
Następujący obszar jest ważny, bo określa, które zależności wciągniemy podczas budowania programu. Spójrzmy na pierwszy wiersz:
find_package(KF5 ${KF5_MIN_VERSION} COMPONENTS Kirigami2 I18n CoreAddons WidgetsAddons)
- find_package() finds and loads the external component.
- Pierwszym słowem jest słowo szkieletu (
KF5
). - Następnie wywołujemy zmienną z wersjami, które ustawiliśmy w drugim wierszu.
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, add_subdirectory(src)
, points CMake into the src/
directory.
|
|
Ponieważ najwięcej robi pierwszy wiersz, to ten może być krótszy.
- set() is used to set
helloworld_SRCS
tomain.cpp
andresources.qrc
(if we decide to create additional C++ files we'll need to add them here too) - add_executable() takes care of naming our executable and grabbing the files needed to create it
- target_link_libraries dynamically links the libraries used in our code to our executable.
Uwaga
Note that these libraries should match the components that we included in our previousCMakeLists.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.