La configuration de SFML dans Visual Studio 2019 est similaire à la configuration de SDL, freeGLUT et GLEW, avec deux particularités: il y a 29 fichiers.lib et 11 fichiers.dll.
On suppose que votre plate-forme est Windows et votre IDE Visual Studio 2019. Ce didacticiel s'adresse au débutant.
Pas
Partie 1 sur 7: Configuration et téléchargement
Étape 1. Mettez en surbrillance ce que vous comptez faire
Par exemple voir l'image ci-dessus.
Étape 2. Téléchargez la communauté Visual Studio 2019
Si vous ne l'avez pas encore fait, vous pouvez le télécharger sur
Étape 3. Cochez la case Développement de bureau avec charge de travail C++ lors du téléchargement
Si nécessaire, faites défiler la page vers le bas.
Étape 4. Créez le dossier GL
Ouvrez l'explorateur de fichiers de Windows > Accédez au disque (répertoire) C.
- Si le dossier GL existe déjà, ce n'est pas grave.
- Si ce n'est pas le cas, faites un clic droit dans une zone vide > sélectionnez Nouveau > Dossier > tapez GL > appuyez sur ↵ Entrée.
Étape 5. Téléchargez la dernière version stable de SFML
Faites un clic droit sur l'adresse suivante et sélectionnez Ouvrir le lien dans une nouvelle fenêtre https://www.sfml-dev.org/download/sfml/2.5.1/. Cliquez sur le premier bouton, aujourd'hui Télécharger 16,3 Mo, à côté de "Visual C++ 15 (2017) - 32 bits".
- Dans la fenêtre de téléchargement, cliquez sur le dossier SFML-2.5.1 (ou la dernière version) > clic droit > Copier.
- Accédez à C:> GL> clic droit> sélectionnez Coller.
- (Vous pouvez également cliquer sur le dossier SFML-2.5.1 (ou la dernière version) et faire glisser dans l'explorateur de fichiers > C: > GL).
- Une fois la copie et la décompression terminées, cliquez sur le nom SFML-2.5.1 (ou la dernière version) et renommez-le en SFML.
Partie 2 sur 7: Création d'un projet vide
Étape 1. Créez un dossier BPL
Accédez au disque (répertoire) C.
- Si le dossier BPL existe déjà, ce n'est pas grave.
- Si ce n'est pas le cas, faites un clic droit dans une zone vide > sélectionnez Nouveau > Dossier > tapez BPL > appuyez sur ↵ Entrée.
Étape 2. Créez un projet vide
-
Si Visual Studio n'est pas ouvert. Ouvrez-le > Cliquez sur Créer un nouveau projet > Projet vide > Suivant.
- Dans Configurez votre nouveau projet assistant, dans le champ de texte "Nom du projet": SFML-0.
- Dans le champ de texte "Emplacement", supprimez tout, copiez C:\BPL\ et coller.
- Cochez "Placer la solution et le projet dans le même répertoire" > cliquez sur Créer.
- Attendez que l'instance Visual Studio apparaisse.
- Si Visual Studio est ouvert. Cliquez sur Fichier > Nouveau > Projet… > Projet vide > Suivant. Le reste comme ci-dessus.
Étape 3. Ajoutez un fichier source à Project
Dans Visual Studio > Explorateur de solutions > cliquez avec le bouton droit sur Fichiers sources > cliquez sur Ajouter > Nouvel élément….
- Dans Ajouter un nouvel élément - SFML-0 assistant, cliquez sur Fichier C++ (.cpp). Dans Nom type de champ de texte Main.cpp. Emplacement devrait être C:\GLP\SFML-0. > cliquez sur Ajouter.
- Le fichier source Main.cpp se trouve maintenant dans la zone principale de Visual Studio et est vide. C'est bon.
Partie 3 sur 7: Configuration de SFML dans le projet
Étape 1. Ouvrez la fenêtre des pages de propriétés SFML-0
Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le nom du projet (SFML-0) > cliquez sur Propriétés.
Dans l'assistant des pages de propriétés SFML-0, laissez les paramètres par défaut: Configuration: Active(Debug), Platform: Active(Win32) ou Win32
Étape 2. Configurez des répertoires d'inclusion supplémentaires
Dans la fenêtre Pages de propriétés SFML-0, double-cliquez sur C/C++ > cliquez sur Général > Répertoires d'inclusion supplémentaires > flèche vers le bas à la fin du champ > cliquez sur.
- Copie C:\GL\SFML\include et collez-le dans le champ de texte supérieur de l'assistant d'inclusion de répertoires supplémentaires.
- Dans l'assistant d'inclusion de répertoires supplémentaires, cliquez sur OK.
Étape 3. Configurez les répertoires de bibliothèque supplémentaires de l'éditeur de liens
Dans l'assistant "SFML-0 Property Pages", double-cliquez sur Linker > cliquez sur General > Additional Library Directories > flèche vers le bas à la fin du champ > cliquez sur.
- Copie C:\GL\SFML\lib et collez-le dans le champ de texte supérieur de l'assistant Répertoires de bibliothèque supplémentaires.
- Cliquez sur OK dans l'assistant Répertoires de bibliothèque supplémentaires.
Étape 4. Configurez les dépendances supplémentaires de l'éditeur de liens
Dans le menu déroulant "Lien", cliquez sur Entrée > Dépendances supplémentaires > flèche vers le bas à la fin du champ > cliquez sur.
- Copiez les noms de fichiers.lib suivants et collez-les dans la zone de texte supérieure de l'assistant « Dépendances supplémentaires »: opengl32.lib; flac.lib; freetype.lib; ogg.lib; openal32.lib; sfml-audio.lib; sfml-graphics.lib; sfml-window.lib; sfml-system.lib; sfml-main.lib; sfml-network.lib; vorbis.lib; vorbisenc.lib; vorbisfile.lib
- Dans l'assistant "Dépendances supplémentaires", cliquez sur OK.
Étape 5. Configurez le sous-système de l'éditeur de liens
Dans le menu déroulant Linker, cliquez sur Système > Sous-système > flèche vers le bas à la fin du champ > sélectionnez Console (/SOUS-SYSTÈME:CONSOLE) > cliquez sur Appliquer, puis sur OK.
Étape 6. Copiez les fichiers.dll de SFML et collez-les dans le dossier du projet
Dans l'explorateur de fichiers de Windows, cliquez sur Fichier dans le coin supérieur gauche > Nouvelle fenêtre.
- Dans le deuxième (le nouveau) assistant de l'explorateur de fichiers, accédez à C:> GL> SFML> bin> cliquez sur openal32.dll> clic droit> Copier.
- Dans le premier assistant de l'explorateur de fichiers, accédez à C: > GLP > SFML-0. À l'intérieur, faites un clic droit et sélectionnez Coller.
- Répétez ce processus pour les fichiers sans -d, qui sont sfml-audio-2.dll, sfml-graphics-2.dll, sfml-network-2.dll, sfml-system-2.dll, sfml-window-2.dll. Maintenant, dans le dossier du projet SFML-0, vous avez 6 fichiers dll.
Étape 7. Testez votre projet
Faites un clic droit sur l'adresse suivante et sélectionnez Ouvrir le lien dans une nouvelle fenêtre https://www.sfml-dev.org/tutorials/2.5/start-vc.php faites défiler la page et copiez le code.
Accédez à Visual Studio et collez dans la zone de code Main.cpp. Appuyez sur Ctrl + F5. Deux fenêtres devraient apparaître: une noire (la console) et une petite avec un cercle vert sur fond noir. Bon travail
Étape 8. Corrigez toutes les erreurs
Dans "Liste d'erreurs" si vous voyez une erreur sur
- avec l'extension.h allez à la partie 3, étape 2, Configurer des répertoires d'inclusion supplémentaires et suivez les instructions.
- fichier avec l'extension.lib aller à la partie 3, étape 3, Configurer les répertoires de bibliothèque supplémentaires de l'éditeur de liens, et suivez les instructions. Également à l'étape 4, Configurer les dépendances supplémentaires de l'éditeur de liens.
- "le point d'entrée doit être défini" passez à l'étape 5, Configurer le sous-système de l'éditeur de liens et suivez les instructions.
- fichier.dll passez à l'étape 6 et suivez les instructions.
- Pour les autres erreurs, si vous ne pouvez pas les corriger, fermez Visual Studio > supprimez le dossier de projet SFML-0 qui réside dans C:\GLP > ouvrez Visual Studio > répétez la configuration à partir de la partie 2 Créer un projet vide. Bon travail.
Partie 4 sur 7: Créer un projet avec un modèle
Étape 1. Créez un modèle
Accédez au menu principal de Visual Studio. Pendant que SFML-0 est ouvert, cliquez sur Projet > Exporter le modèle….
- Dans Choisissez le type de modèle menu, laissez le modèle de projet coché. Cliquez sur Suivant….
- Dans Sélectionnez les options de modèle, dans Nom du modèle: champ de texte, supprimez tout et tapez SFML > cliquez sur Terminer. Le modèle est créé.
Étape 2. Créer un projet
Cliquez sur Fichier > Nouveau > Projet….
- Dans Créer un nouveau projet assistant sélectionnez SFML (si nécessaire faites défiler la liste des modèles) > cliquez sur Suivant.
- Dans Configurez votre nouveau projet assistant, dans le champ de texte Nom du projet, tapez SFML-1.
- L'emplacement doit être C:\GLP\. Si ce n'est pas le cas, supprimez le chemin, copiez C:\BPL et coller.
- Assurez-vous que Placer la solution et le projet dans le même répertoire est coché. Cliquez sur Créer.
Étape 3. Copiez les fichiers.dll du dossier bin comme ci-dessus, étape 6 de la partie 3, et collez-les dans le dossier du projet SFML-1
Étape 4. Tester le projet
Dans l'explorateur de solutions de Visual Studio, double-cliquez sur Fichiers sources > double-cliquez sur Main.cpp. (Si le code n'apparaît pas, supprimez ce fichier et créez-en un autre avec le même nom, copiez le code depuis https://www.sfml-dev.org/tutorials/2.5/start-vc.php et collez-le dans la zone de code). Dans le code Main.cpp, allez à la ligne 7 et remplacez Color:: Green par Color:: Blue. Cliquez sur Ctrl+F5. Maintenant, le cercle dans la petite fenêtre est bleu. Essayez de corriger les erreurs. Si vous échouez, répétez les étapes ci-dessus.
Partie 5 sur 7: Création d'un projet pour cibler la plate-forme x64
Étape 1. Téléchargez la dernière version stable de SFML 64 bits
Faites un clic droit sur l'adresse suivante et sélectionnez Ouvrir le lien dans une nouvelle fenêtre https://www.sfml-dev.org/download/sfml/2.5.1/. Cliquez sur le premier bouton de la liste de droite, téléchargez aujourd'hui 18,0 Mo à côté de "Visual C++ 15 (2017) - 64 bits".
- Dans la fenêtre de téléchargement, cliquez sur le dossier SFML-2.5.1 (ou le dernier) > clic droit > Copier.
- Accédez à C:> GL> clic droit> sélectionnez Coller (il est supposé que vous avez créé un dossier GL).
- Une fois la copie et la décompression terminées, cliquez sur le nom SFML-2.5.1 et renommez-le en SFML64.
Étape 2. Créez un projet
Cliquez sur Fichier > Nouveau > Projet… > Projet vide > Suivant.
- Dans Configurez votre nouveau projet assistant, dans le champ de texte "Nom du projet", tapez: SFML64-0.
- Dans le champ de texte "Emplacement", supprimez tout, copiez C:\BPL\ et collez (il est supposé que vous avez créé le dossier BPL).
- Cochez "Placer la solution et le projet dans le même répertoire" > cliquez sur Créer.
- Attendez que l'instance Visual Studio apparaisse.
Étape 3. Ajoutez un fichier source à Project
Dans Visual Studio > Explorateur de solutions > cliquez avec le bouton droit sur Fichiers sources > cliquez sur Ajouter > Nouvel élément….
- Dans l'assistant Ajouter un nouvel élément - SFML64-0, cliquez sur Fichier C++ (.cpp). Dans le champ de texte Nom, saisissez Main.cpp. L'emplacement doit être C:\GLP\SFML64-0. > cliquez sur Ajouter.
- Le fichier source Main.cpp se trouve maintenant dans la zone principale de Visual Studio et est vide. C'est bon.
Étape 4. Paramètres de propriété du projet
Allez dans "Solution Explorer" > clic droit sur le nom de votre projet SFML64-0 > sélectionnez "Propriétés".
- Dans l'assistant de pages de propriétés SFML64-0 dans l'entrée de configuration, sélectionnez Active(Debug) > dans Platform: entry, choisissez x64 > Click Configuration manager…
- Dans l'assistant Configuration Manager, dans la plate-forme de solution active: sélectionnez x64
- Dans l'entrée Platform, x64 est sélectionné automatiquement.
- Cliquez sur Fermer
Étape 5. Le reste comme ci-dessus, partie 3 étapes 2-8, mais remplacez SFML par SFML64 et SFML-0 par SFML64-0
Astuce: même si dans les paramètres principaux des pages de propriétés, il s'agit de Plate-forme: x64, cliquez sur Gestionnaire de configuration… et dans Plate-forme de solution active: sélectionnez x64
Étape 6. Créez un modèle
Comme ci-dessus. Pour le type de nom du modèle SFML64 et pour le nom du projet SFML64-0. Dans chaque projet que vous créez avec, sélectionnez x64 (à côté de Debug) dans l'interface graphique de Visual Studio.
Partie 6 sur 7: Compilation du code source avec CMake et Visual Studio
Étape 1. La compilation d'une bibliothèque à partir du code source présente un double avantage
Garantit que la bibliothèque résultante est parfaitement adaptée à votre CPU/OS, un luxe que les binaires précompilés ne fournissent pas toujours, et que les binaires que vous obtenez ciblent la plate-forme x64.
Étape 2. Mettez en surbrillance ce que vous comptez faire
Par exemple voir l'image ci-dessus.
Étape 3. Téléchargez CMake
Faites un clic droit sur l'adresse suivante et sélectionnez Ouvrir le lien dans une nouvelle fenêtre https://cmake.org/download/. Faites défiler la page vers le bas et recherchez "Version précédente (3.19.8)". Dans la deuxième liste "Plateforme", recherchez "Windows win64-x64 ZIP" et cliquez sur l'entrée à côté cmake-3.19.8-win64-x64.zip > dans l'assistant d'ouverture, sélectionnez Enregistrer le fichier.
Étape 4. Copiez et décompressez le dossier zip
- Dans la fenêtre de téléchargement, cliquez sur dossier > clic droit > dans le menu déroulant, sélectionnez Copier.
- Accédez au répertoire C:\ > GL > clic droit > sélectionnez Coller.
- Lorsque la copie et la décompression (extraction de fichiers) sont terminées, double-cliquez sur le dossier de décompression cmake-3.19.8-win64-x64 (ou la dernière version)> bin> à l'intérieur, vous devriez voir le logo de CMake à côté du nom de fichier cmake-gui> double-cliquez sur ce fichier. Si l'assistant "Windows protégez votre PC" apparaît, cliquez sur Plus d'informations > Exécuter quand même. Maintenant sur votre écran vous avez Cfaire IHM graphique.
- Chaque fois que vous avez besoin de CMake, accédez à C:\ > GL > cmake-3.19.8-win64-x64 > bin > double-cliquez sur le fichier cmake-gui (celui avec le logo de CMake).
Étape 5. Téléchargez le code source
Faites un clic droit sur l'adresse suivante et sélectionnez Ouvrir le lien dans une nouvelle fenêtre https://www.sfml-dev.org/download/sfml/2.5.1/. Faites défiler vers le bas, dans Tous sélectionner Code source et cliquez sur Télécharger 22,2 Mo.
Étape 6. Copiez et décompressez le dossier
- Dans la fenêtre de téléchargement, cliquez sur le dossier zip SFML-2.5.1-sources.zip (ou dernière version) > clic droit > sélectionnez Copier.
- Accédez à C:\ > GL > clic droit > sélectionnez Coller.
- Maintenant dans le répertoire C:\GL, vous avez le dossier de décompression SFML-2.5.1. Cliquez deux fois sur son nom > supprimer le nom > tapez SFMLsrc > appuyez sur ↵ Entrée.
Étape 7. Accédez à l'interface graphique CMake
- Dans le champ de texte à côté de Où est le code source (premier champ de texte), tapez C:/GL/SFMLsrc.
- Dans le champ de texte à côté de Où construire les binaires (deuxième champ de texte), tapez C:/GL/SFMLsrc/build.
Étape 8. Configurez et générez
Dans CMake GUI, cliquez sur Configurer > dans l'assistant Créer un répertoire, cliquez sur Oui > cliquez sur Terminer.
Lorsque, dans l'interface graphique de CMake, vous lisez: "Configuration terminée", cliquez sur Générer. Vous devriez lire: « Génération terminée »
Étape 9. Créez votre solution
- Accédez à C: > GL > SFMLsrc > build. Double-cliquez sur "SFML.sln", ou "SFML", ou "ALL_BUILD.vcxproj". Une instance de Visual Studio apparaît. Dans le menu principal, cliquez sur "Build" > "Build Solution".
-
Attendez de lire la dernière ligne dans la fenêtre "Sortie": ========== Build: 8 réussi, 0 échoué, 0 à jour, 1 ignoré ===========
ASTUCE: Nombre de modifications « réussies » dans les versions de SFML. Aujourd'hui (28-1-2020) est 8
Étape 10. Créez un projet vide
Dans le menu principal de Visual Studio, cliquez sur Fichier > Nouveau > Projet… > Créer un nouveau projet > Projet vide > Suivant.
- Dans la zone de texte Nom du projet, tapez: SFMLsrc-0.
- À côté de la zone de texte Emplacement, cliquez sur ….
- Accédez à C:\ > BPL (il est supposé que vous avez créé un dossier BPL) > Cliquez sur Sélectionner un dossier. L'emplacement est C:\GLP.
- Case à cocher Placer la solution et le projet dans le même répertoire.
- Cliquez sur Créer.
Étape 11. Ajoutez votre fichier source au projet
Dans l'assistant de l'Explorateur de solutions, faites un clic droit sur le dossier Fichiers source (le dernier) > cliquez sur Ajouter > Nouvel élément…
- Dans la fenêtre Ajouter un nouvel élément - SFMLsrc-0, cliquez sur Fichier C++ (.cpp) (le premier) au milieu de la fenêtre. Dans la zone de texte Nom, tapez Main.cpp.
- L'emplacement est C:\GLP\SFMLsrc-0.
- Cliquez sur le bouton Ajouter. Le fichier s'ouvrira dans l'éditeur de texte principal, mais laissez-le vide pour le moment.
Étape 12. Configurez les propriétés du projet
Dans l'assistant de l'Explorateur de solutions, cliquez avec le bouton droit sur le nom du projet qui est SFMLsrc-0 > sélectionnez Propriétés.
-
(1) Menu principal des pages de propriétés SFMLsrc-0.
Dans l'entrée Platform, sélectionnez x64 > cliquez sur Configuration Manager….
- Dans la plate-forme de solution active: sélectionnez x64.
- Dans l'entrée Platform, x64 est automatiquement sélectionné.
- Cliquez sur Fermer.
-
(2) Répertoires d'inclusion supplémentaires. Cliquez sur C/C++ > Général > Dans le menu à côté, sélectionnez le premier, Répertoires d'inclusion supplémentaires > cliquez sur la flèche vers le bas à la fin du champ > cliquez sur.
Copie C:\GL\SFMLsrc\include > dans l'assistant "Additional Include Directories", cliquez sur la première icône > coller.
-
(3) Répertoires de bibliothèque supplémentaires. Double-cliquez sur Linker > cliquez sur Général > Répertoires de bibliothèque supplémentaires > cliquez sur la flèche vers le bas à la fin du champ > cliquez sur
Copie C:\GL\SFMLsrc\build\lib\Debug > dans l'assistant "Répertoires de bibliothèque supplémentaires", cliquez sur la première icône > coller.
- (4) Dépendances supplémentaires. Dans le menu déroulant Linker, sélectionnez Input > dans le menu à côté, sélectionnez le premier, Additional Dependencies > cliquez sur la flèche vers le bas à la fin du champ > Edit… > copy opengl32.lib; sfml-audio-d.lib; sfml-graphics-d.lib; sfml-main-d.lib; sfml-network-d.lib; sfml-system-d.lib; sfml-window-d.lib et collez dans la zone de texte supérieure de l'assistant Dépendances supplémentaires> cliquez sur OK.
-
(5) Définissez le système sur CONSOLE de sous-système.
Dans le menu déroulant Linker, sélectionnez System > dans le menu à côté, sélectionnez le premier, SubSystem > cliquez sur la flèche vers le bas à la fin du champ > sélectionnez Console (/SUBSYSTEM:CONSOLE). Cliquez sur Appliquer et OK.
Étape 13. Copiez les fichiers dll et collez-les dans le dossier du projet SFMLsrc-0
Sous Windows Explorateur de fichiers cliquez sur Fichier > Ouvrir une nouvelle fenêtre. Dans la nouvelle (deuxième) fenêtre, accédez à C:> GL> SFML> build> lib> Debug, et copiez (par clic droit> Copy), un par un, les 5 (cinq) fichiers dll et collez dans la première fenêtre C: > BPL > SFMLsrc-0. Maintenant, dans le dossier du projet SFMLsrc-0, vous avez 5 fichiers dll parmi lesquels Main.cpp et 4 autres fichiers créés par Visual Studio.
Étape 14. Testez votre projet et corrigez les erreurs éventuelles
Comme ci-dessus, voir la partie 3 Configuration de SFML dans le projet.
Étape 15. Créez un modèle avec le projet SFMLsrc-0
Comme ci-dessus, partie 4 Créer un projet avec le modèle. Pour le type de nom du modèle SFMLsrc. Pour le type de nom de projet SFMLsrc-1. Rappelez-vous dans chaque projet que vous créez avec ce modèle
- sélectionnez x64 dans l'interface graphique de Visual Studio.
- copiez les fichiers dll du projet précédent et collez-les dans le nouveau.
Partie 7 sur 7: Choisir la configuration
Étape 1. Dans ce didacticiel, vous apprenez que 3 consistait à configurer SFML dans Project avec Visual Studio
-
Configurer les binaires x86 (32 bits).
C'est le plus simple. Vous devriez commencer à apprendre la configuration à partir d'ici.
-
Configurer les binaires x64 (64 bits).
Il cible la plate-forme x64. Choisissez-le uniquement lorsque vous avez une raison précise de le faire.
-
Compilez le source SFML et configurez-le dans le projet.
Cible x64 aussi. Le plus difficile. Le meilleur quand même.
