CMake
CMakeLists.txt podstawowy
cmake_minimum_required(VERSION 3.0)
set(CMAKE_BUILD_TYPE Debug)
project(zad3)
add_executable(
zad3
zad3.c
)
zad3 - nazwa pliku uruchamialnego
zad3.c - plik z programem
dodaj kolejne plik *.c i *.h
ale może być tak, że mamy w głównym katalogu CMake, który dodaje podkatalogi.
tylko w podkatalogach sa pliki cpp i hpp oraz osobne CMake
wtedy główny CMakeLists.txt dodaje tylko katalogi
cmake_minimum_required (VERSION 3.8)
project ("CMakeProject22")
# Include sub-projects.
add_subdirectory ("CMakeProject22")a w folderze CMakeProject22, poza plikami CMakeProject22.cpp i h mamy CMakeList.txt
o zawartosci
cmake_minimum_required (VERSION 3.8)
# Add source to this project's executable.
add_executable (CMakeProject22 "CMakeProject22.cpp" "CMakeProject22.h")
CMake ZDALNE na Visual Studio do Linuxa na VMvare
- stworz nowy projekt CMake
standardowo stworzy konfiguracje x64-Debug, daj Manage Configuration (rozwin x64-Debug)
- wybierz Linux-GCC-Debug dla linuxa - powstanie plik CMakeSettings.json (Mingw64-Debug lub Release konfiguracje(dla windows)
-po dodaniu konfiguracji zmien generator CMake z ninja na Unix Makefile (json CMAKe settings under advance settings)
- dodaj znalna maszyne Tool->Options->Cross Platform
-skopiuje pliki na twoja virtualna maszyne
To speed up compilation time we can define parallel compilation flag -j or –jobs followed by an integer that represent number of recipes to execute at once in Cmake Settings view under Build command arguments
Troubleshooting:
• Is good practice to Deleting CMake Cache and run fresh Cache generation, when we do some changes to CMakeLists.txt files or CMakeSettings.json.
• Do not copy Cmake configuration in Visual Studio. Visual Studio do not copy environments variables better option is to copy by hand or create and modify new configuration.
• If CMake can’t find C/C++ compilator make sure that you have added directory that was mentioned in MSYS2 installation chapter.
Notes:
• Most of the option of building our application on remote machine are defined in CMakeSettings.json like output build and installation folder on remote machine excluded files from copy, etc.
• Currently only console application is supported to show an output of the application open a Linux Console. (Debug→Linux Console).
• In case of problem whit IntelliSense for Linux specific headers you can update remote headers by going to Tool→Options→Croos Platform→Connection Manager→Remote Headers IntelliSense Manager (Visual Studio should automatically update headers files)
na VMware linux w katalogu .vs/NazwaProjektu/numer/
stworzy
OUT - gdzie w /build/Linux-GCC-Debug/CMakeNazwaProj tworzy PLIK WYNIKOWY
(Clean Build czyści go!!!) (delete cache czyści cały out (usuwa katalog Linux-GCC-Debug )
SRC - kopia plików źródłowych na których Linux uruchamia budowanie
w folderze projektu pliki CPP i H te same co w projekcie VS
to co tworzy generate cache (w out/build/Linux-GCC-Debug/) to robocze pliki CMake uzywane do zbudowania pliku wynikowego
więcej
*********************************************************************************
RECZNE uruchomienie CMake w stworzonych katalogach na VMware OUT i SRC
Jeśli mamy w OUT stworzony przez VS cache (w build stworzony jest Linux-GCC-Debug i zawiera plik:
CMakeCache.txt
i folder:
CMakeFiles
to z folderu out/build/Linux-GCC-Debug dajemy komende
cmake .
Jesli brak CMakeCache.txt i CMakeFiles, to musimy cmake pokazac gdzie znajduje sie CMakeList.txt projektu
ten jest w SRC, więc z katalogu out/build/Linux-GCC-Debug/ (zeby tu stworzyl pliki MAKE) dajemy komende:
cmake ../../../src/
da wynik (pokaze kompilator)
-- The C compiler identification is GNU 9.3.0
-- The CXX compiler identification is GNU 9.3.0
-- Check for working C compiler: /usr/bin/cc
-- Check for working C compiler: /usr/bin/cc -- works
-- Detecting C compiler ABI info
-- Detecting C compiler ABI info - done
-- Detecting C compile features
-- Detecting C compile features - done
-- Check for working CXX compiler: /usr/bin/c++
-- Check for working CXX compiler: /usr/bin/c++ -- works
-- Detecting CXX compiler ABI info
-- Detecting CXX compiler ABI info - done
-- Detecting CXX compile features
-- Detecting CXX compile features - done
-- Configuring done
-- Generating done
-- Build files have been written to: /home/marcin/.vs/CMakeProject23/83a0f6bd-aa75-488e-8070-ca4c3923cd43/out/build/Linux-GCC-Debug
CXX znaczy C++
teraz żeby zbudować ręcznie plik wynikowy dajemy
cmake --build . (uruchomi MAKE)
mamy stworzony plik wykonywalny w out/build/Linux-GCC-Debug/CMakeProject2
CMAKE Library:
jeśli dodamy pliki z funkcjami ktore inkludujemy, np Hello
to żeby potrafił to zbudować trzeba albo dodać Hello.cpp w lokalnym CMLists.txt
cmake_minimum_required (VERSION 3.8)
# Add source to this project's executable.
add_executable (CMakeProject2 "CMakeProject2.cpp" "CMakeProject2.h" "Hello.cpp")
jeśli nie dodasz:
błąd:
CMakeProject2/CMakeProject2.cpp:11: undefined reference to `Hello()'
ale można dodać to jako nową bibliotekę:
i wtedy przejdzie linkowanie
(po cmake ../../../src/ nie bedzie błędu undefined reference to `Hello()'
ale przy próbie cmake --build .
pokaze ze linkuje dodana bibliotekę, ale dalej nie może sie do niej odnieść
trzeba pokazac w CMakeLists do czego podlaczyc dodana bibliotekę poleceniem (tam gdzie jest add_executable)
targer_link_libraries(nazwa_executables PRIVATE dodana_biblioteka)
PRIVATE to link interface mode - tutaj mode = private
polecenie dodajemy w CMakeLists.txt tam gdzie jest okreslone executable
(w naszym przypadku nie w głównym gdzie dodajemy tylko subdirectories ale w kat. Projektu)
polecenie
add_library moze określać rownież jakiego typu jest biblioteka, standardowo jest statyczna (STATIC)
ale mozna dac SHARED
i wtedy gdy uruchomimy plik wynikowy przez LDD
ldd prints the shared libraries required by each program or shared library specified on the command line.
to widać bibliotekę hello
trzeci typ to MODULE (cmake zwróci z nim jednak błąd)
można zmienić domyślny tryb budowania bibliotek
cmake -D BUILD_SHARED_LIBS=TRUE .
teraz domyslnie shared
Podkatalogi
Jesli biblioteki w osobnym folderze i uruchamialne(main) też w osobnym to wazne by w głównym CMakeLists.txt tam gdzie są tylko dodane subdirectory, by biblioteki były dodane wczesniej przed hello-exe (nazwa executable)
i wtedy CMakeList z SRC wygląda tak
a CMakeLists z uruchamialnej czesci projektu tak

CMakeLists z SRC ma dodaną linię
target_include_directories(say-hello PUBLIC "${CMAKE_CURRENT_SOURCE_DIR}/src")
jak to działa....
target_link_libraries (z executable, trzeci z powyższych) linkuje say-hello do projektu(executable)
dodanie do biblioteki say-hello "target_include_directories" w SRC z podaną flagą PUBLIC i scieżką
sprawi, że projekt dodając tą bibliotekę odziedziczy rowniez informacje o katalogu SRC
i wtedy gdy w naszym pliku CPP chcemy includować tą bibliotekę nie musimy dawać "" z pełną scieżką
#include "../src/say-hello/Hello.h"
tylko <> ze scieżką względną
#include <say-hello/Hello.h>
target_compile_definitions
tworzenie predefiniowanych zmiennych w plikach CMakeLists
jesli dodamy w naszym pliku CMake linie
to możemy się w kodzie posługiwać stworzoną predefiniowaną zmienna kompilatora tu równa 4
jeśli jest PRIVATE wtedy mozemy dodać tylko do Hello (jako ze ten CMake dotyczy tych bibliotek)
ale nie mozemy użyć tej zmiennej np w main.
jeśli jest INTERFACE to możemy w main ALE nie możemy w Hello.
SCRIPTING
dwie podstawowe komendy to minimalne wymagania wersji CMake i project (name)
wszytsko w nawiasach jest stringiem, odzielone spacjami, nie kropkami
jak chcesz wyświetlic wiadomosc podczas uruchomienia CMake
message(STATUS "tresc wiadomosci")
co ważne, tresc musi być w " "
jak chcesz stworzyć zmienna w CMake
set(NAZWA "Wartosc zmiennej")
jak chcesz wykorzystać zmienna umieśc w ${ }
podanie jako zmiennej PROJECT_NAME
wyswietli wartosc z project, tutaj "MyProject"
podanie jako zmiennej PROJECT_VERSION
wyswietlo wartosc z project, tutaj 1.1.2
Control Flow and Auto-dereferencing
if("TRUE") - string traktuje jako spełniony warunek,
mozna uzyc elseif ( ) koniecznie z argumentem
jeśli używamy zmiennej, podajemy ja jako argument do if
albo podajemy ją w "${ }"
mozna zanegować zmienna poprzez NOT
można porównać dwa stringi STREQUAL
można stosować logikę i porównywać z liczbami, STREQUAL porównuje stringi, EQUAL liczby
można rownież uzywac while, tu przyklad z wyrazeniem matematycznym
mozna rowniez foreach
tutaj item - stworzona zmienna ktorej mozemy uzyc
IN - szukaj w
ITEMS foo bar baz quz - stworz liste w tymi elementami
czyli przeiteruje nam te elementy
dla foreach mozna zastosowac rowniez RANGE
jesli RANGE 0 99 to w zakresie
jesli RANGE 0 99 5 to w zakresie co 5
2c od poczatku
.
Youtube:
https://www.youtube.com/watch?v=rKBdoMzY3cA&list=PLK6MXr8gasrGmIiSuVQXpfFuE1uPT615s&index=9