Tutorial SDL2 Installation - Versionsgeschichte

Glawesome: Code::Blocks (C++) auf Linux

2014-05-14T07:06:16Z

Code::Blocks (C++) auf Linux

Hobbyfrickler: Anleitung für Delphi / Lazarus unter Windows hinzugefügt

2014-04-11T19:11:06Z

Anleitung für Delphi / Lazarus unter Windows hinzugefügt

Glawesome: /* Die richtigen Dateien am richtigen Ort */ überflüssiges Wort entfernt

2014-04-06T15:42:18Z

‎Die richtigen Dateien am richtigen Ort: überflüssiges Wort entfernt

Glawesome: /* DLL-Fehlermeldung */ Kategorie hinzugefügt

2014-04-04T20:42:40Z

‎DLL-Fehlermeldung: Kategorie hinzugefügt

Glawesome am 4. April 2014 um 20:07 Uhr

2014-04-04T20:07:37Z

Glawesome: Die Seite wurde neu angelegt: „In diesem Tutorial wird dir gezeigt, wie du deine Entwicklungsumgebung so einrichtest, dass du SDL2-Programme entwickeln kannst. Dies ist Voraussetzung für …“

2014-04-04T20:00:46Z

Die Seite wurde neu angelegt: „In diesem Tutorial wird dir gezeigt, wie du deine Entwicklungsumgebung so einrichtest, dass du SDL2-Programme entwickeln kannst. Dies ist Voraussetzung für …“

Neue Seite

In diesem Tutorial wird dir gezeigt, wie du deine Entwicklungsumgebung so einrichtest, dass du SDL2-Programme entwickeln kannst. Dies ist Voraussetzung für [[Tutorial OpenGL3 Lektion 1]]. Auch wenn das Prinzip überall gleich ist, hängen die Details von der jeweils verwendeten Programmiersprache, von der Entwicklungsumgebung und vom Betriebssystem ab. Daher ist der Rest des Artikels nach Programmiersprache und IDE aufgeteilt.

==Code::Blocks (C++) unter Windows==
===SDL2 herunterladen===
Das erste, was wir benötigen, ist die Library SDL2 selbst. Diese lädst du dir [https://www.libsdl.org/download-2.0.php hier] herunter. Da wir Entwickler sind, brauchen wir nur, was im Abschnitt "Development Libraries" angeboten wird. Wer [http://www.codeblocks.org/ Code::Blocks] einsetzt, verwendet in der Regel den MinGW-Compiler. Dies ist dann der Fall, wenn man den Compiler gleichzeitig mit Code::Blocks installiert hat. Ist dies der Fall, speichert man als die Datei "SDL2-devel-2.0.3-mingw.tar.gz" auf dem Computer. Die Versionsnummer kann sich natürlich schon geändert haben, wenn du dieses Tutorial liest. Solange sie mit 2.0 beginnt, sollte alles so funktionieren, wie hier beschrieben.
===Archiv entpacken===
Die heruntergeladene Datei ist ein Archiv, also eine Datei in der weitere Dateien und Ordner komprimiert gespeichert sind. Schließlich wäre es mühsam, 100 Dateien einzeln herunterzuladen, nicht wahr? ;) Um das Archiv zu entpacken, benötigst du ein Archivprogramm auf deinem Computer. Auf den meisten Computern ist das ohnehin installiert. Falls dies bei dir nicht der Fall ist, kann ich [http://www.7-zip.org/ 7-zip] empfehlen, welches kostenlos (sogar open-source) ist und sehr viele Formate lesen und schreiben kann - insbesondere auch das Format tar.gz. Wenn du das heruntergeladene Archiv entpackt hast, befindet sich auf deiner Festplatte ein Ordner "SDL2-2.0.3" (oder eine andere Versionsnummer).
===Die richtigen Dateien am richtigen Ort===
Damit der Compiler die heruntergeladenen Code-Dateien auch findet, müssen wir ihm entweder sagen, wo sich diese befinden. Ich rate davon ab, das lokale Downloadverzeichnis (wo sich die Dateien bei dir vermutlich jetzt befinden) als Include-Pfad zu verwenden. Suche dir ein Verzeichnis auf der Festplatte aus, der deinem Ordnungssystem entspricht - auf deinem Computer herrscht doch Ordnung, oder?! ;) 
Der Einfachheit halber werde ich im Folgenden einfach annehmen, dass das Verzeichnis ''C:\include'' heißt. Darin erstellst du nun einen Ordner namens "SDL2". Nun wechselst du in das von dir entpackte Verzeichnis nach ''SDL2-2.0.3\include'' und kopierst alle darin enthaltenen Dateien nach ''C:\include''. 
Außerdem brauchen wir noch ein zweites Verzeichnis für Linker-Dateien. Dieses nenne ich hier einfach mal ''C:\lib''. Dorthin werden alle .a-Dateien kopiert, die sich im Ordner ''SDL2-2.0.3\i686-w64-mingw32\lib'' (wenn dein Programm 32bit ist) bzw. ''SDL2-2.0.3\x86_64-w64-mingw32\lib'' (falls du ein 64bit-Programm schreibst) befinden. Falls du unsicher bist, brauchst du wahrschenlich die 32bit-Version - auch wenn dein Betriebssystem 64bittig ist!
===Projekteinstellungen===
Falls noch nicht geschehen, startest du nun Code::Blocks und erstellst ein neues Projekt (Konsolenanwendung, "Hello World"-Beispiel). Um sicherzugehen, dass alles andere funktioniert, kompilierst du deine Anwendung erstmal und führst sie aus. 
Ist dies erfolgreich, klickst du im Menü auf "Project" -> "Build options..." und wählst in dem sich öffnenden Fenster den Reiter "Search directories". Dieser enthält wiederum zwei Unterreiter "Compiler" und "Linker". Beim Unterreiter "Compiler" klickst du auf "Add" und wählst ''C:\include'' aus. Auf die gleiche Weise wählst du beim Unterreiter "Linker" das Verzeichnis ''C:\lib'' aus.
Danach wechselst du noch zum Reiter "Linker settings" (neben "Search directories") und fügst folgende Zeile in die Box "other linker options" ein:
-lmingw32 -lSDL2main -lSDL2 -lopengl32
Anschließend natürlich noch mit einem Klick auf OK bestätigen. 

Folgender Code sollte nun erfolgreich gebaut (kompiliert & gelinkt) werden können:
<source lang=cpp>#include <iostream>
#include <SDL2/SDL.h>

int main(int argc, char* args[])
{
if(SDL_Init(SDL_INIT_EVERYTHING) != 0)
std::cout << "SDL_Init failed!\n";
else
std::cout << "SDL_Init was successful!\n";

SDL_Quit();
return 0;
}</source>

===DLL-Fehlermeldung===
Bevor du jetzt "Fehlermeldung!" schreist: Ich sagte bauen, nicht ausführen ;) Die Ausführung funktioniert in der Tat noch nicht, da Windows bei der Ausführung des Programms vergeblich nach der Datei "SDL2.dll" sucht. Diese musst du erst noch in das Verzeichnis kopieren, in dem sich die exe-Datei deines Programms befindet. Du findest sie im Ordner ''SDL2-2.0.3\lib\x86'' (32bit) bzw. in ''SDL2-2.0.3\lib\x64'' (64bit).

@@ Zeile 37: / Zeile 37: @@
 ===DLL-Fehlermeldung===
 Bevor du jetzt laut "Fehlermeldung!" stöhnst: Ich sagte bauen, nicht ausführen ;) Die Ausführung funktioniert in der Tat noch nicht, da Windows bei der Ausführung des Programms vergeblich nach der Datei "SDL2.dll" sucht. Diese musst du erst noch in das Verzeichnis kopieren, in dem sich die exe-Datei deines Programms befindet. Du findest sie im Ordner ''SDL2-2.0.3\lib\x86'' (32bit) bzw. in ''SDL2-2.0.3\lib\x64'' (64bit).
 [[Kategorie:Tutorial|SDL2 Installation]]

@@ Zeile 9: / Zeile 9: @@
 Die heruntergeladene Datei ist ein Archiv, also eine Datei in der weitere Dateien und Ordner komprimiert gespeichert sind. Schließlich wäre es mühsam, 100 Dateien einzeln herunterzuladen, nicht wahr? ;)  Um das Archiv zu entpacken, benötigst du ein Archivprogramm auf deinem Computer. Auf den meisten Computern ist das ohnehin installiert. Falls dies bei dir nicht der Fall ist, kann ich [http://www.7-zip.org/ 7-zip] empfehlen, welches kostenlos (sogar open-source) ist und sehr viele Formate lesen und schreiben kann - insbesondere auch das Format tar.gz. Wenn du das heruntergeladene Archiv entpackt hast, befindet sich auf deiner Festplatte ein Ordner "SDL2-2.0.3" (oder eine andere Versionsnummer).
 ===Die richtigen Dateien am richtigen Ort===
-Damit der Compiler die heruntergeladenen Code-Dateien auch findet, müssen wir ihm entweder sagen, wo sich diese befinden. Ich rate davon ab, das lokale Downloadverzeichnis (wo sich die Dateien bei dir vermutlich jetzt befinden) als Include-Pfad zu verwenden. Suche dir ein Verzeichnis auf der Festplatte aus, der deinem Ordnungssystem entspricht - auf deinem Computer herrscht doch Ordnung, oder?! ;)<br>
+Damit der Compiler die heruntergeladenen Code-Dateien auch findet, müssen wir ihm sagen, wo sich diese befinden. Ich rate davon ab, das lokale Downloadverzeichnis (wo sich die Dateien bei dir vermutlich jetzt befinden) als Include-Pfad zu verwenden. Suche dir ein Verzeichnis auf der Festplatte aus, der deinem Ordnungssystem entspricht - auf deinem Computer herrscht doch Ordnung, oder?! ;)<br>
 Der Einfachheit halber werde ich im Folgenden einfach annehmen, dass das Verzeichnis ''C:\include'' heißt. Darin erstellst du nun einen Ordner namens "SDL2". Nun wechselst du in das von dir entpackte Verzeichnis nach ''SDL2-2.0.3\include'' und kopierst alle darin enthaltenen Dateien nach ''C:\include''.<br>
 Außerdem brauchen wir noch ein zweites Verzeichnis für Linker-Dateien. Dieses nenne ich hier einfach mal ''C:\lib''. Dorthin werden alle .a-Dateien kopiert, die sich im Ordner ''SDL2-2.0.3\i686-w64-mingw32\lib'' (wenn dein Programm 32bit ist) bzw. ''SDL2-2.0.3\x86_64-w64-mingw32\lib'' (falls du ein 64bit-Programm schreibst) befinden. Falls du unsicher bist, brauchst du wahrschenlich die 32bit-Version - auch wenn dein Betriebssystem 64bittig ist!
 ===Projekteinstellungen===
 Falls noch nicht geschehen, startest du nun Code::Blocks und erstellst ein neues Projekt (Konsolenanwendung, "Hello World"-Beispiel). Um sicherzugehen, dass alles andere funktioniert, kompilierst du deine Anwendung erstmal und führst sie aus.<br>

← Nächstältere Version		Version vom 4. April 2014, 20:42 Uhr
Zeile 36:		Zeile 36:
	===DLL-Fehlermeldung===		===DLL-Fehlermeldung===
	Bevor du jetzt laut "Fehlermeldung!" stöhnst: Ich sagte bauen, nicht ausführen ;) Die Ausführung funktioniert in der Tat noch nicht, da Windows bei der Ausführung des Programms vergeblich nach der Datei "SDL2.dll" sucht. Diese musst du erst noch in das Verzeichnis kopieren, in dem sich die exe-Datei deines Programms befindet. Du findest sie im Ordner ''SDL2-2.0.3\lib\x86'' (32bit) bzw. in ''SDL2-2.0.3\lib\x64'' (64bit).		Bevor du jetzt laut "Fehlermeldung!" stöhnst: Ich sagte bauen, nicht ausführen ;) Die Ausführung funktioniert in der Tat noch nicht, da Windows bei der Ausführung des Programms vergeblich nach der Datei "SDL2.dll" sucht. Diese musst du erst noch in das Verzeichnis kopieren, in dem sich die exe-Datei deines Programms befindet. Du findest sie im Ordner ''SDL2-2.0.3\lib\x86'' (32bit) bzw. in ''SDL2-2.0.3\lib\x64'' (64bit).
		+
		+	[[Kategorie:Tutorial\|SDL2 Installation]]

← Nächstältere Version		Version vom 14. Mai 2014, 07:06 Uhr
Zeile 38:		Zeile 38:
	Bevor du jetzt laut "Fehlermeldung!" stöhnst: Ich sagte bauen, nicht ausführen ;) Die Ausführung funktioniert in der Tat noch nicht, da Windows bei der Ausführung des Programms vergeblich nach der Datei "SDL2.dll" sucht. Diese musst du erst noch in das Verzeichnis kopieren, in dem sich die exe-Datei deines Programms befindet. Du findest sie im Ordner ''SDL2-2.0.3\lib\x86'' (32bit) bzw. in ''SDL2-2.0.3\lib\x64'' (64bit).		Bevor du jetzt laut "Fehlermeldung!" stöhnst: Ich sagte bauen, nicht ausführen ;) Die Ausführung funktioniert in der Tat noch nicht, da Windows bei der Ausführung des Programms vergeblich nach der Datei "SDL2.dll" sucht. Diese musst du erst noch in das Verzeichnis kopieren, in dem sich die exe-Datei deines Programms befindet. Du findest sie im Ordner ''SDL2-2.0.3\lib\x86'' (32bit) bzw. in ''SDL2-2.0.3\lib\x64'' (64bit).

		+
		+
		+	==Code::Blocks (C++) auf Linux==
		+	===SDL2 herunterladen===
		+	Die meisten Linux-Distributionen bieten die benötigte SDL2-Library bereits im Standard-Repository an. Unter [https://www.opensuse.org/ openSuSE] z.B. startet man einfach YaST und klickt auf "Software installieren oder löschen". Im sich nun öffnenden Fenster suchst du nach "SDL2". Die Pakete "libSDL2-2_0-0" und "libSDL2-devel" sind für uns interessant. Für spätere Tutorials könnten auch "libSDL2_image-2_0-0" und "libSDL2_image-devel" nützlich sein. Nach einem Klick auf "Akzeptieren" werden die ausgewählten Paket installiert. Auf anderen Linux-Distributionen sind die Schritte ähnlich und die Pakete sollten alle "SDL2" im Namen enthalten.
		+
		+	===Projekteinstellungen===
		+	Nach der Installation landen die SDL2-Headerdateien üblicherweise in ''/usr/include/SDL2/''. Dieser Pfad muss in Code::Blocks nicht extra angegeben werden, sondern wird normalerweise automatisch gefunden. Jedoch muss noch eine Linker-Einstellung gemacht werden. Dazu wählst du im Menü "Project" den Eintrag "Build options..." und wählst im sich öffnenden Fenster den Reiter "Linker settings". Im Feld "other linker options" tippst du folgende Zeile ein:
		+	-ldl -lGL -lSDL2main -lSDL2
		+	Nun solltest du folgenden Code problemlos kompilieren und ausführen können:
		+	<source lang=cpp>#include <iostream>
		+	#include <SDL2/SDL.h>
		+
		+	int main(int argc, char* args[])
		+	{
		+	if(SDL_Init(SDL_INIT_EVERYTHING) != 0)
		+	std::cout << "SDL_Init failed!\n";
		+	else
		+	std::cout << "SDL_Init was successful!\n";
		+
		+	SDL_Quit();
		+	return 0;
		+	}</source>

@@ Zeile 1: / Zeile 1: @@
 In diesem Tutorial wird dir gezeigt, wie du deine Entwicklungsumgebung so einrichtest, dass du SDL2-Programme entwickeln kannst. Dies ist Voraussetzung für [[Tutorial OpenGL3 Lektion 1]]. Auch wenn das Prinzip überall gleich ist, hängen die Details von der jeweils verwendeten Programmiersprache, von der Entwicklungsumgebung und vom Betriebssystem ab. Daher ist der Rest des Artikels nach Programmiersprache und IDE aufgeteilt.
@@ Zeile 17: / Zeile 19: @@
 Anschließend natürlich noch mit einem Klick auf OK bestätigen.<br><br>
-Folgender Code sollte nun erfolgreich gebaut (kompiliert & gelinkt) werden können:
+Folgender Code sollte nun erfolgreich gebaut (kompiliert und gelinkt) werden können:
 <source lang=cpp>#include <iostream>
 #include <SDL2/SDL.h>
@@ Zeile 33: / Zeile 35: @@
 ===DLL-Fehlermeldung===
-Bevor du jetzt "Fehlermeldung!" schreist: Ich sagte bauen, nicht ausführen ;) Die Ausführung funktioniert in der Tat noch nicht, da Windows bei der Ausführung des Programms vergeblich nach der Datei "SDL2.dll" sucht. Diese musst du erst noch in das Verzeichnis kopieren, in dem sich die exe-Datei deines Programms befindet. Du findest sie im Ordner ''SDL2-2.0.3\lib\x86'' (32bit) bzw. in ''SDL2-2.0.3\lib\x64'' (64bit).
+Bevor du jetzt laut "Fehlermeldung!" stöhnst: Ich sagte bauen, nicht ausführen ;) Die Ausführung funktioniert in der Tat noch nicht, da Windows bei der Ausführung des Programms vergeblich nach der Datei "SDL2.dll" sucht. Diese musst du erst noch in das Verzeichnis kopieren, in dem sich die exe-Datei deines Programms befindet. Du findest sie im Ordner ''SDL2-2.0.3\lib\x86'' (32bit) bzw. in ''SDL2-2.0.3\lib\x64'' (64bit).