23 CMake, CONAN, remote

 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