Att konfigurera SFML i Visual Studio 2019 liknar att konfigurera SDL, freeGLUT och GLEW, med två särdrag: det finns 29.lib -filer och 11.dll -filer.
Det antas att din plattform är Windows och din IDE Visual Studio 2019. Denna handledning vänder sig till nybörjaren.
Steg
Del 1 av 7: Konfigurera och ladda ner
Steg 1. Markera vad du förväntar dig att göra
Se till exempel bilden ovan.
Steg 2. Ladda ner Visual Studio 2019 Community
Om du inte har gjort det kan du ladda ner det från
Steg 3. Kontrollera skrivbordsutvecklingen med C ++ - arbetsmängden när du laddar ner
Om det behövs rullar du ner på sidan.
Steg 4. Skapa mapp GL
Öppna Windows File Explorer> Navigera till disk (katalog) C.
- Om mapp GL redan finns är det okej.
- Om det inte gör det, högerklicka i det tomma området> välj Ny> Mapp> typ GL > tryck ↵ Enter.
Steg 5. Ladda ner den senaste stabila versionen av SFML
Högerklicka på följande adress och välj Öppna länk i nytt fönster https://www.sfml-dev.org/download/sfml/2.5.1/. Klicka på den första knappen, idag Ladda ner 16,3 MB, bredvid "Visual C ++ 15 (2017) - 32 -bitars".
- I nedladdningsfönstret klickar du på mappen SFML-2.5.1 (eller senaste versionen)> högerklickar> Kopiera.
- Navigera till C:> GL> högerklicka> välj Klistra in.
- (Alternativt kan du klicka på mappen SFML-2.5.1 (eller senaste versionen) och dra till File Explorer> C:> GL).
- När kopieringen och uppackningen är klar klickar du på namnet SFML-2.5.1 (eller senaste versionen) och byter namn till SFML.
Del 2 av 7: Skapa tomma projekt
Steg 1. Skapa mapp GLP
Navigera till disk (katalog) C.
- Om mappen GLP redan finns är det okej.
- Om det inte gör det, högerklicka i det tomma området> välj Ny> Mapp> typ GLP > tryck ↵ Enter.
Steg 2. Skapa ett tomt projekt
-
Om Visual Studio inte är öppet. Öppna det> Klicka på Skapa ett nytt projekt> Tomt projekt> Nästa.
- I Konfigurera ditt nya projekt guiden, i textfältet "Projektnamn": SFML-0.
- Ta bort allt i textfältet "Plats", kopiera C: / GLP \ och klistra in.
- Markera "Placera lösning och projekt i samma katalog"> klicka på Skapa.
- Vänta tills Visual Studio -instansen visas.
- Om Visual Studio är öppet. Klicka på Arkiv> Nytt> Projekt …> Tomt projekt> Nästa. Resten enligt ovan.
Steg 3. Lägg till en källfil till Project
I Visual Studio> Solution Explorer> högerklicka på källfiler> klicka på Lägg till> Nytt objekt ….
- I Lägg till nytt objekt - SFML -0 guiden, klicka C ++ - fil (.cpp). I namn textfältstyp Main.cpp. Plats ska vara C: / GLP / SFML-0. > klicka på Lägg till.
- Källfilen Main.cpp finns nu i Visual Studios huvudområde och är tom. Det är okej.
Del 3 av 7: Konfigurera SFML i projektet
Steg 1. Öppna fönstret Egendomsidor SFML-0
I Solution Explorer högerklickar du på projektets namn (SFML-0)> klicka på Egenskaper.
I guiden SFML-0 Property Pages lämnar du standardinställningarna: Konfiguration: Active (Debug), Platform: Active (Win32) eller Win32
Steg 2. Konfigurera ytterligare inkludera kataloger
I fönstret SFML-0-egenskapssidor dubbelklickar du på C/C ++> klickar du på Allmänt> Ytterligare kataloger> nedåtpilen i slutet av fältet> klickar.
- Kopiera C: / GL / SFML / inkluderar och klistra in i guiden Ytterligare inkludera kataloger längst upp i textfältet.
- Klicka på OK i guiden Ytterligare inkludera kataloger.
Steg 3. Konfigurera linker Extra Library Directory
I guiden "Egenskaper för SFML-0" dubbelklickar du på Linker> klickar på Allmänt> Ytterligare bibliotekskataloger> nedåtpilen i slutet av fältet> klickar.
- Kopiera C: / GL / SFML / lib och klistra in i guiden Extra bibliotekskataloger längst upp i textfältet.
- Klicka på OK i guiden Extra bibliotekskataloger.
Steg 4. Konfigurera länkar Ytterligare beroende
I rullgardinsmenyn "Linker" klickar du på Inmatning> Ytterligare beroenden> nedåtpilen i slutet av fältet> klickar.
- Kopiera följande.lib-filnamn och klistra in i "Ytterligare beroenden" -guidans översta textruta: 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
- Klicka på OK i guiden "Ytterligare beroenden".
Steg 5. Konfigurera länksubsystem
I Linker -rullgardinsmenyn klickar du på System> Delsystem> nedåtpilen i slutet av fältet> välj Konsol (/DELSYSTEM: KONSOL)> klicka på Verkställ och sedan OK.
Steg 6. Kopiera.dll-filer från SFML och klistra in i projektmappen
I Windows Utforskare klickar du på Arkiv i övre vänstra hörnet> Nytt fönster.
- I den andra (den nya) guiden File Explorer navigerar du till C:> GL> SFML> bin> klicka på openal32.dll> högerklick> Kopiera.
- I den första File Explorer-guiden navigerar du till C:> GLP> SFML-0. Inuti, högerklicka och välj Klistra in.
- Upprepa denna process för filer utan -d, vilket är sfml-audio-2.dll, sfml-graphics-2.dll, sfml-network-2.dll, sfml-system-2.dll, sfml-window-2.dll. Nu i projektmappen SFML-0 har du 6 dll-filer.
Steg 7. Testa ditt projekt
Högerklicka på följande adress och välj Öppna länk i nytt fönster https://www.sfml-dev.org/tutorials/2.5/start-vc.php rulla ner på sidan och kopiera koden.
Gå till Visual Studio och klistra in i kodområdet Main.cpp. Tryck Ctrl + F5. Två fönster ska visas: ett svart (konsolen) och ett litet med grön cirkel i svart bakgrund. Bra jobbat
Steg 8. Korrigera eventuella fel
I "Fellista" om du ser fel om
- fil med tillägget.h gå till del 3, steg 2, Konfigurera Ytterligare inkludera kataloger och följ instruktionerna.
- fil med tillägget.lib gå till del 3, steg 3, Konfigurera länkaren Ytterligare bibliotekskataloger och följ instruktionerna. Även till steg 4, Konfigurera länkar Ytterligare beroenden.
- "ingångspunkt måste definieras" gå till steg 5, Konfigurera länksubsystem och följ instruktionerna.
- file.dll gå till steg 6 och följ instruktionerna.
- För andra fel, om du inte kan korrigera dem, stäng Visual Studio> ta bort projektmapp SFML-0 som finns i C: / GLP> öppna Visual Studio> upprepa konfigurationen från del 2 Skapar ett tomt projekt. Bra jobbat.
Del 4 av 7: Skapa projekt med mall
Steg 1. Skapa mall
Gå till Visual Studio huvudmeny. Medan SFML-0 är öppen, klicka på Projekt> Exportera mall….
- I Välj malltyp menyn, låt projektmallen vara markerad. Klicka på Nästa….
- I Välj mallalternativ, i mallnamn: textfält, ta bort allt och skriv SFML> klicka på Slutför. Mallen skapas.
Steg 2. Skapa projekt
Klicka på Arkiv> Nytt> Projekt….
- I Skapa ett nytt projekt guiden välj SFML (bläddra vid behov nedåt i listan över mallar)> klicka på Nästa.
- I Konfigurera ditt nya projekt guiden, i textfältet Projektnamn skriver du SFML-1.
- Platsen ska vara C: / GLP \. Om det inte är det, ta bort sökvägen, kopiera C: / GLP och klistra in.
- Se till att platslösningen och projektet i samma katalog är markerat. Klicka på Skapa.
Steg 3. Kopiera.dll-filerna från bin-mappen enligt ovan Del 3 steg 6 och klistra in i projektmappen SFML-1
Steg 4. Testprojekt
I Visual Studios lösningsutforskare dubbelklickar du på källfiler> dubbelklickar på Main.cpp. (Om koden inte visas, ta bort den här filen och skapa en annan med samma namn, kopiera koden från https://www.sfml-dev.org/tutorials/2.5/start-vc.php och klistra in i kodområdet). I Main.cpp -koden går du till rad 7 och ändrar Färg:: Grön till Färg:: Blå. Klicka på Ctrl+F5. Nu är cirkeln i det lilla fönstret blå. Försök att rätta till eventuella fel. Om du misslyckas, upprepa ovanstående steg.
Del 5 av 7: Skapa projekt som riktar sig till x64 -plattformen
Steg 1. Ladda ner den senaste stabila versionen av SFML 64 -bitars
Högerklicka på följande adress och välj Öppna länk i nytt fönster https://www.sfml-dev.org/download/sfml/2.5.1/. Klicka på den första knappen i den högra listan, idag Ladda ner 18,0 MB bredvid "Visual C ++ 15 (2017) - 64 -bitars".
- I nedladdningsfönstret klickar du på mappen SFML-2.5.1 (eller den senaste)> högerklickar> Kopiera.
- Navigera till C:> GL> högerklicka> välj Klistra in (det antas att du har skapat mapp GL).
- När kopieringen och uppackningen är klar klickar du på namnet SFML-2.5.1 och byter namn till SFML64.
Steg 2. Skapa projekt
Klicka på Arkiv> Nytt> Projekt …> Tomt projekt> Nästa.
- I Konfigurera ditt nya projekt guiden, i textfältet "Projektnamn" skriver du: SFML64-0.
- Ta bort allt i textfältet "Plats", kopiera C: / GLP \ och klistra in (det antas att du har skapat mappen GLP).
- Markera "Placera lösning och projekt i samma katalog"> klicka på Skapa.
- Vänta tills Visual Studio -instansen visas.
Steg 3. Lägg till en källfil till Project
I Visual Studio> Solution Explorer> högerklicka på källfiler> klicka på Lägg till> Nytt objekt ….
- I guiden Lägg till nytt objekt - SFML64-0 klickar du på filen C ++ (.cpp). I textfältet Namn skriver du Main.cpp. Platsen ska vara C: / GLP / SFML64-0. > klicka på Lägg till.
- Källfilen Main.cpp finns nu i Visual Studios huvudområde och är tom. Det är okej.
Steg 4. Projektets fastighetsinställningar
Gå till "Solution Explorer"> högerklicka på namnet på ditt projekt SFML64-0 > välj "Egenskaper".
- I guiden SFML64-0 Fastighetssidor i konfigurationsposten väljer du Aktiv (felsökning)> i plattform: post väljer du x64> Klicka på Konfigurationshanterare …
- I guiden Configuration Manager, i plattformen för aktiv lösning: välj x64
- I plattformspost väljs x64 automatiskt.
- Klicka på Stäng
Steg 5. Resten enligt ovan, del 3 steg 2-8, men ersätt SFML med SFML64 och SFML-0 med SFML64-0
Tips: Även om det i egenskapssidans huvudinställningar är Plattform: x64 klickar du på Konfigurationshanteraren … och i plattformen för aktiv lösning: välj x64
Steg 6. Skapa mall
Som ovan. För mallens namntyp SFML64 och för projektets namn SFML64-0. I varje projekt du skapar med det väljer du x64 (bredvid Debug) i Visual Studios GUI.
Del 6 av 7: Kompilering av källkod med CMake och Visual Studio
Steg 1. Att kompilera ett bibliotek från källkoden har två fördelar
Garanterar att det resulterande biblioteket är perfekt skräddarsytt för din CPU/OS, en lyxig förkompilerad binär inte alltid ger, och att binärer du får mål x64 plattform.
Steg 2. Markera vad du förväntar dig att göra
Se till exempel bilden ovan.
Steg 3. Ladda ner CMake
Högerklicka på följande adress och välj Öppna länk i nytt fönster https://cmake.org/download/. Rulla ner på sidan och hitta "Tidigare version (3.19.8)". I den andra plattformslistan hittar du "Windows win64-x64 ZIP" och klickar på posten bredvid cmake-3.19.8-win64-x64.zip > i öppningsguiden väljer du Spara fil.
Steg 4. Kopiera och packa upp zip -mappen
- I nedladdningsfönstret klickar du på mapp> högerklick> välj Kopiera i rullgardinsmenyn.
- Navigera till katalog C: \> GL> högerklicka> välj Klistra in.
- När kopieringen och uppackningen (extrahering av filer) är klar dubbelklickar du på att packa upp mappen cmake-3.19.8-win64-x64 (eller senaste versionen)> bin> inuti ska du se CMakes logotyp bredvid filnamnet cmake-gui> dubbelklicka på den här filen. Om guiden "Windows skyddar din dator" visas klickar du på Mer information> Kör ändå. Nu på din skärm har du CMake GUI.
- Varje gång du behöver CMake navigerar du till C: \> GL> cmake-3.19.8-win64-x64> bin> dubbelklickar på filen cmake-gui (den med CMakes logotyp).
Steg 5. Ladda ner källkoden
Högerklicka på följande adress och välj Öppna länk i nytt fönster https://www.sfml-dev.org/download/sfml/2.5.1/. Rulla ner till botten, in Allt Välj Källkod och klicka på Ladda ner 22,2 MB.
Steg 6. Kopiera och packa upp mappen
- Klicka på zip -mappen i nedladdningsfönstret SFML-2.5.1-sources.zip (eller senaste versionen)> högerklicka> välj Kopiera.
- Navigera till C: \> GL> högerklicka> välj Klistra in.
- Nu i katalogen C: / GL, har du packa upp mappen SFML-2.5.1. Klicka två gånger på dess namn> radera namn> typ SFMLsrc > tryck ↵ Enter.
Steg 7. Gå till CMake GUI
- I textfältet bredvid Var är källkoden (första textfältet), skriv C:/GL/SFMLsrc.
- I textfältet bredvid Var man ska bygga binärfilerna (andra textfältet), skriv C:/GL/SFMLsrc/build.
Steg 8. Konfigurera och generera
I CMake GUI klickar du på Konfigurera> i guiden Skapa katalog, klicka på Ja> klicka på Slutför.
När du i CMake GUI läser: "Konfigurera klart" klickar du på Generera. Du bör läsa: "Generering klar"
Steg 9. Bygg din lösning
- Navigera till C:> GL> SFMLsrc> build. Dubbelklicka på "SFML.sln" eller "SFML" eller "ALL_BUILD.vcxproj". En instans av Visual Studio visas. Klicka på "Bygg"> "Bygg lösning" i huvudmenyn.
-
Vänta tills du läser den sista raden i "Utdata" -fönstret: ========== Bygg: 8 lyckades, 0 misslyckades, 0 uppdaterade, 1 hoppade över ===========
TIPS: Antal "lyckade" ändringar i SFML -versioner. Idag (28-1-2020) är det 8
Steg 10. Skapa ett tomt projekt
Klicka på Arkiv> Nytt> Projekt …> Skapa ett nytt projekt> Tömt projekt> Nästa i huvudmenyn i Visual Studio.
- Skriv textrutan Projektnamn: SFMLsrc-0.
- Klicka på… bredvid textrutan Plats.
- Navigera till C: \> GLP (det antas att du har skapat mapp GLP)> Klicka på Välj en mapp. Platsen är C: / GLP.
- Kryssrutan Placera lösning och projekt i samma katalog.
- Klicka på Skapa.
Steg 11. Lägg till källfilen i projektet
I guiden Solution Explorer högerklickar du på mappen Källfiler (den sista)> klickar på Lägg till> Nytt objekt …
- I fönstret Lägg till nytt objekt - SFMLsrc -0 klickar du på C ++ - fil (.cpp) (den första) från mitten av fönstret. I textrutan Namn skriver du Main.cpp.
- Platsen är C: / GLP / SFMLsrc-0.
- Klicka på knappen Lägg till. Filen öppnas i huvudtextredigeraren men lämnar den tom för tillfället.
Steg 12. Konfigurera projektets egenskaper
I guiden Solution Explorer högerklickar du på Projektets namn som är SFMLsrc-0> välj Egenskaper.
-
(1) SFMLsrc-0 Egenskapsidors huvudmeny.
I plattformsposten välj x64> klicka på Configuration Manager….
- I plattformen för aktiv lösning: välj x64.
- I plattformsposten väljs x64 automatiskt.
- Klicka på Stäng.
-
(2) Ytterligare inkluderar kataloger. Klicka på C/C ++> Allmänt> Välj den första bredvid menyn, Extra Inkludera kataloger> klicka på nedåtpilen i slutet av fältet> klicka.
Kopiera C: / GL / SFMLsrc / include > i guiden "Inkludera kataloger" klickar du på den första ikonen> klistrar in.
- (3) Ytterligare bibliotekskataloger. Dubbelklicka på Linker> klicka på Allmänt> Ytterligare bibliotekskataloger> klicka på nedåtpilen i slutet av fältet> klicka
Kopiera C: / GL / SFMLsrc / build / lib / Debug > i guiden "Ytterligare bibliotekskataloger" klickar du på den första ikonen> klistrar in.
- (4) Ytterligare beroenden. I Linker-rullgardinsmenyn väljer du Inmatning> i bredvid menyn väljer du den första, Ytterligare beroenden> klicka på nedåtpilen i slutet av fältet> Redigera …> kopiera 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 och klistra in i guiden Extra beroenden längst upp i textrutan> klicka på OK.
-
(5) Ställ in System på delsystemKONSOL.
I Linker-rullgardinsmenyn väljer du System> i bredvid menyn väljer du den första, delsystem> klickar du på nedåtpilen i slutet av fältet> väljer konsol (/DELSYSTEM: KONSOL). Klicka på Apply och OK.
Steg 13. Kopiera dll-filer och klistra in i projektmappen SFMLsrc-0
I Windows Utforskaren klicka på Arkiv> Öppna nytt fönster. I det nya (andra) fönstret navigerar du till C:> GL> SFML> build> lib> Debug och kopierar (genom att högerklicka> Kopiera) en efter en alla 5 (fem) dll -filer och klistrar in i det första fönstret C: > GLP> SFMLsrc-0. Nu i projektmappen SFMLsrc-0 har du 5 dll-filer bland Main.cpp och andra 4 filer skapade av Visual Studio.
Steg 14. Testa ditt projekt och korrigera eventuella fel
Som ovan, se del 3 Konfigurera SFML i projektet.
Steg 15. Skapa mall med SFMLsrc-0-projekt
Som ovan, del 4 Skapa ett projekt med mallen. För mallens namntyp SFMLsrc. För projektets namntyp SFMLsrc-1. Kom ihåg i varje projekt du skapar med den här mallen
- välj x64 i Visual Studios GUI.
- kopiera dll -filer från tidigare projekt och klistra in nya.
Del 7 av 7: Välja inställning
Steg 1. I den här självstudien lär du dig 3 var att konfigurera SFML i Project med Visual Studio
-
Konfigurera binärer x86 (32 bitar).
Det är det enklaste. Du bör börja lära dig att konfigurera härifrån.
-
Konfigurera binärer x64 (64 bitar).
Den riktar sig till x64 -plattformen. Välj det bara om du har en särskild anledning till det.
-
Kompilera SFML -källa och konfigurera i projekt.
Mål x64 också. Det svåraste. Bäst dock.
