Ce document fournit un guide étape par étape pour installer la bibliothèque SDL2 dans un projet Visual Studio, y compris le téléchargement, l'extraction, et la configuration des propriétés du projet. Il détaille également les modifications nécessaires pour résoudre les erreurs de compilation, telles que l'ajout de répertoires d'inclusion et de bibliothèques. Enfin, il explique comment exécuter le projet après avoir copié le fichier DLL nécessaire.

1. Installation de la bibliothèque SDL2
dans un projet Visual Studio
© 2019, Mustapha Tachouct

2. Pour commencer, allez sur cette page web
https://www.libsdl.org/download-2.0.php

3. Allez à la catégorie Development Librairies

4. Dans cette catégorie, vous trouverez des archives de
la bibliothèque de developpement SDL2 pour
plusieurs plateformes

5. Téléchargez le zip SDL2-devel-2.0.9-VC.zip

6. A la fin du téléchargement,
allez dans votre répertoire de Téléchargements

7. Faites un clic droit avec votre souris

8. Dans le menu déroulant,
cliquez sur « Extraire tout ... »

9. Vous tomberez sur l’ « Extracteur de dossiers
compréssés» (Extract Wizard)

10. Saisissez le répertoire de destination de votre choix
(C:DevLIBS par exemple)

11. Cliquez ensuite sur le bouton Extraire

12. Une fois l’opération de décompression terminée,
vous devez avoir ce répertoire

13. Ensuite, ouvrez votre Visual Studio

14. Cliquez sur l’onglet Fichier

15. Cliquez sur Nouveau

16. Choisissez Projet ...

17. Vous allez tomber sur la fenêtre de création de projet

18. Choisissez Projet vide

19. Modifiez les paramètres du projet

20. Puis, cliquez sur OK

21. Vous venez de créer un projet vide comme celui-ci

22. Dans l’explorateur de solutions,
faites un clic droit sur Fichiers sources

23. Un menu déroulant (pop-up) va apparaître

24. Cliquez sur Ajouter

25. Un autre menu va apparaître

26. Cliquez sur Nouvel élément

27. La fenêtre Ajouter un nouvel élément va s’ouvrir

28. Sélectionnez Fichier C++ (.cpp)

29. Modifier le nom de votre fichier cpp

30. Pour finir, cliquez sur le bouton Ajouter

31. Saisissez votre programme
dans le nouveau fichier cpp

32. Si vous compilez votre programme,
pleins d’erreurs vont s’afficher
=> C’est normal car Visual Studio ne sait pas
ou se trouve votre SDL. Nous allons corriger ce problème

33. Allez dans l’explorateur de solutions

34. Voici l’explorateur de solutions

35. Faites un clic droit sur votre projet utilisant la SDL

36. Un menu déroulant va apparaître

37. Cliquez sur Propriétés

38. Vous tomberez sur la Page de propriétés
de votre projet

39. Modifiez la Configuration de votre projet

40. Choisissez Toutes les configurations
(pour que vos modifications soient à fois pour la
Debug et la Release de votre projet)

41. Vérifier que Toutes les configurations
a bien été selectionné

42. Sélectionnez la catégorie Répertoire VC++

43. Ajoutez votre répertoire d’include SDL2 :
« C:DevLIBSSDL2-2.0.9Include » séparé par un « ; »

44. Ajoutez votre répertoire de bibliothèque SDL2
« C:DevLIBSSDL2-2.0.9libsx86 » séparé par un « ; »

45. Sélectionnez ensuite la catégorie Éditeur de liens
puis la sous-catégorie entrée

46. Ajoutez les bibliothèques SDL2.lib et SDL2main.lib
séparées par des « ; » dans dépendances
supplémentaires

47. Allez dans la sous-catégorie Système

48. Modifier le sous-système en choisissant Console
(ça permettra de voir les printfs)

49. Vous devez avoir Console comme sous-système

50. Pour terminer, cliquez sur OK

51. Cliquez sur Générer dans le File Menu

52. Puis, cliquez sur Générer la solution

53. Votre projet compile (sans erreur) normalement

54. Cliquez sur le Exécuter

55. Une message box avec une erreur apparaît
=> C’est normal car votre programme ne trouve pas
le fichier dll « SDL2.dll »

56. Le fichier dll « SDL2.dll » n’est pas présent dans
votre répertoire de votre projet

57. Allez dans le répertoire « c:DevLIBSSDL2-
2.0.9libx86 » pour copier votre fichier dll
« SDL2.dll » en faisant CTRL-C

58. Ensuite, coller votre fichier en faisant CTRL-V dans
le répertoire de votre projet

59. Cliquez maintenant sur Exécuter

60. Bravo ! Votre première fenêtre SDL apparaît

62. Références
● https://alexandre-laurent.developpez.com/tutoriels/sdl-2/installation-et-configuration/
● https://www.wikihow.com/Set-Up-SDL-with-Visual-Studio-2017