Master DevOps

Durch Zufall bin ich auf ein deutsches Video gestoßen, dass erklärt, wie die Funktionsweise von CMake unter Linux ist (CMake -> Make -> kompiliertes Projekt).

Ein weiterer Punkt, warum es sich lohnt CMake zu verwenden und der im Video aber nicht ganz dargestellt wird ist der, dass man aus einer CMakeLists.txt nicht nur ein Makefile generieren kann, sondern z.B. auch eine Solutionsdatei für Visual Studio und andere Buildsysteme.

In diesem Post möchte ich ein kleines Beispiel zeigen, wie man ein C++-Projekt mit harfbuzz kompiliert. Das alles zeige ich in einem CentOS docker Container. Aber das sollte eigentlich keinen Unterschied machen, d.h. das gezeigte Beispiel sollte auch auf einem normalen Linuxsystem funktionieren.

Für dieses Beispiel habe ich ein einfaches “Hello World”-Beispiel genommen, dass man üblicherweise in jedem C++-Anfängerbuch findet. Diese Datei habe ich main.cpp benannt:

#include <iostream>

int main(int argc, char **argv) {
        std::cout << "Hello World!" << std::endl;
        return 0;
}

Obwohl es hier keinen Code gibt der auf die Bibliothek harfbuzz verweist, kann man diesen Code problemlos gegen diese Bibliothek kompilieren / linken. Ich gehe davon aus, dass normalerweise auch der entsprechende Code in den Quelltextdateien zu finden ist, aber für diesen Post ist das nicht vonnöten. Jetzt muss ich nur noch die CMakeLists.txt entsprechend anpassen:

cmake_minimum_required(VERSION 3.0)
# Projektname setzen
project(harfbuzz_ex1)

# Alle Quelltextdateien in eine Variable packen
set(SOURCES main.cpp)

# Eine ausführbare Datei soll generiert werden ...
add_executable(${PROJECT_NAME} ${SOURCES})

# ... mit harfbuzz als abhängige Bibliothek
target_link_libraries(${PROJECT_NAME} harfbuzz)

Ist die CMakeLists.txt fertig, kann man mit dem Kompilieren / Linken anfangen:

cmake -G "Unix Makefiles" .
make

Beim ersten Versuch das Projekt zu übersetzen, bekam ich diese Fehlermeldung:

sh-4.2# make
[ 50%] Linking CXX executable harfbuzz_ex1
/usr/bin/ld: cannot find -lharfbuzz
collect2: error: ld returned 1 exit status
make[2]: *** [harfbuzz_ex1] Error 1
make[1]: *** [CMakeFiles/harfbuzz_ex1.dir/all] Error 2
make: *** [all] Error 2

Ich hatte die Bibliothek harfbuzz noch gar nicht auf meinem System installiert. Das musste ich natürlich schnell nachholen:

yum install -y harfbuzz-devel

Danach reichte es aus nochmal make aufrufen und schon konnte ich mein Projekt problemlos bauen und ausführen:

sh-4.2# make
[ 50%] Linking CXX executable harfbuzz_ex1
[100%] Built target harfbuzz_ex1
sh-4.2# ./harfbuzz_ex1
Hello World!

In diesem Post möchte ich ein kleines Beispiel zeigen, wie man eine statische C++ Bibliothek unter Linux mit Hilfe von CMake baut. Dazu habe ich eine sehr einfache C++-Datei namens funcs.cpp erstellt. Die in der Datei enthaltene Funktion add soll zu Beispielzwecken dann in der statischen Bibliothek enthalten sein.

int add(int a, int b)
{
  return (a+b);
}

Die schon erwähnte Funktion add soll zu Beispielzwecken einfach zwei ganze Zahlen addieren. Um die Datei nun in eine statische Bibliothek zu packen, wird eine weitere Datei namens CMakeLists.txt benötigt, die in etwa so aussieht:

cmake_minimum_required(VERSION 3.6)

# Projektname definieren
project(static_test)

# Liste aller Quelldateien in einer Variablen speichern.
# Aus diesen Dateien entsteht dann die statische Bibliothek
set(ST_SOURCES funcs.cpp)

# CMake sagen, dass eine statische Bibliothek erstellt werden soll.
add_library(static_test STATIC ${ST_SOURCES})

Mit dem Kommando project definiert man den Projektnamen. Mit dem Kommando set wird eine neue Variable namens ST_SOURCES erstellt und gleich definiert. Dabei soll ST_SOURCES aus einer Liste aller Quelltextdateien bestehen, die für die statische Bibliothek nötig sind. Da wir in diesem Beispiel nur eine Datei haben, enthält die Liste ST_SOURCES nur einen Eintrag namens funcs.cpp. Man kann hier aber auch mehrere Dateinamen oder -pfade hintereinander setzen, getrennt durch ein Leerzeichen. Der Variablenname ist frei wählbar, muss aber gültig sein.

Das Kommando add_library sagt CMake nun, dass wir eine Bibliothek bauen wollen. Erst das STATIC in dem Kommando macht CMake klar, dass es sich um eine statische Bibliothek handeln muss. Will man jedoch eine dynamische Bibliothek, ersetzt man das STATIC einfach durch SHARED.

Wenn man nun die CMakeLists.txt erstellt hat, muss man anschließend in die Kommandozeile diese zwei Befehle eingeben:

cmake -G "Unix Makefiles" .
make

Der erste Befehl (cmake …) erstellt nun das entsprechende Makefile. Ist das erstellt, kann man make starten und die statische Bibliothek wird erstellt.

Ist alles erfolgreich verlaufen, müsste man nun im Ordner eine Datei namens libstatic_test.a finden.