Konfigurowanie SFML w programie Visual Studio 2019 jest podobne do konfigurowania SDL, freeGLUT i GLEW, z dwiema osobliwościami: istnieje 29 plików.lib i 11 plików.dll.
Zakłada się, że Twoja platforma to Windows, a IDE Visual Studio 2019. Ten samouczek jest skierowany do początkujących.
Kroki
Część 1 z 7: Konfiguracja i pobieranie
Krok 1. Zaznacz, czego oczekujesz
Na przykład patrz zdjęcie powyżej.
Krok 2. Pobierz społeczność programu Visual Studio 2019
Jeśli tego nie zrobiłeś, możesz go pobrać z
Krok 3. Zaznacz pole Programowanie pulpitu z obciążeniem C++ podczas pobierania
W razie potrzeby przewiń stronę w dół.
Krok 4. Utwórz folder GL
Otwórz Eksplorator plików systemu Windows > Przejdź do dysku (katalogu) C.
- Jeśli folder GL już istnieje, to w porządku.
- Jeśli nie, kliknij prawym przyciskiem myszy w pustym obszarze > wybierz Nowy > Folder > wpisz GL > naciśnij ↵ Enter.
Krok 5. Pobierz najnowszą stabilną wersję SFML
Kliknij prawym przyciskiem myszy następujący adres i wybierz Otwórz łącze w nowym oknie https://www.sfml-dev.org/download/sfml/2.5.1/. Kliknij pierwszy przycisk, dzisiaj Pobierz 16,3 MB, obok „Visual C++ 15 (2017) - 32-bitowy”.
- W oknie pobierania kliknij folder SFML-2.5.1 (lub najnowsza wersja) > kliknij prawym przyciskiem myszy > Kopiuj.
- Przejdź do C: > GL > kliknij prawym przyciskiem myszy > wybierz Wklej.
- (Alternatywnie kliknij folder SFML-2.5.1 (lub najnowszą wersję) i przeciągnij do Eksploratora plików > C: > GL).
- Po zakończeniu kopiowania i rozpakowywania kliknij nazwę SFML-2.5.1 (lub najnowszą wersję) i zmień nazwę na SFML.
Część 2 z 7: Tworzenie pustego projektu
Krok 1. Utwórz folder GLP
Przejdź do dysku (katalogu) C.
- Jeśli folder GLP już istnieje, to jest w porządku.
- Jeśli nie, kliknij prawym przyciskiem myszy w pustym obszarze > wybierz Nowy > Folder > wpisz DPL > naciśnij ↵ Enter.
Krok 2. Utwórz pusty projekt
-
Jeśli program Visual Studio nie jest otwarty. Otwórz go > kliknij Utwórz nowy projekt > Pusty projekt > Dalej.
- w Skonfiguruj swój nowy projekt kreator, w polu tekstowym „Nazwa projektu” wpisz: SFML-0.
- W polu tekstowym „Lokalizacja” usuń wszystko, skopiuj C:\GLP\ i wklej.
- Zaznacz „Umieść rozwiązanie i projekt w tym samym katalogu” > kliknij Utwórz.
- Poczekaj, aż pojawi się wystąpienie programu Visual Studio.
- Jeśli program Visual Studio jest otwarty. Kliknij pozycję Plik > Nowy > Projekt… > Pusty projekt > Dalej. Reszta jak wyżej.
Krok 3. Dodaj plik źródłowy do projektu
W programie Visual Studio > Eksplorator rozwiązań > kliknij prawym przyciskiem myszy Pliki źródłowe > kliknij Dodaj > Nowy element….
- w Dodaj nowy przedmiot - SFML-0 kreator, kliknij plik C++ (.cpp). w Nazwa typ pola tekstowego Główny.cpp. Lokalizacja powinno być C:\GLP\SFML-0. > kliknij Dodaj.
- Plik źródłowy Main.cpp znajduje się teraz w głównym obszarze programu Visual Studio i jest pusty. W porządku.
Część 3 z 7: Konfigurowanie SFML w projekcie
Krok 1. Otwórz okno Strony właściwości SFML-0
W Eksploratorze rozwiązań kliknij prawym przyciskiem myszy nazwę projektu (SFML-0) > kliknij Właściwości.
W kreatorze stron właściwości SFML-0 pozostaw ustawienia domyślne: Konfiguracja: Aktywna(Debug), Platforma: Aktywna(Win32) lub Win32
Krok 2. Skonfiguruj dodatkowe katalogi dołączania
W oknie Strony właściwości SFML-0 kliknij dwukrotnie C/C++ > kliknij Ogólne > Dodatkowe katalogi dołączania > strzałkę w dół na końcu pola > kliknij.
- Kopiuj C:\GL\SFML\include i wklej w górnym polu tekstowym kreatora Dodatkowe katalogi dołączania.
- W kreatorze Dodatkowe katalogi dołączania kliknij OK.
Krok 3. Skonfiguruj linker Dodatkowe katalogi biblioteczne
W kreatorze „Strony właściwości SFML-0” kliknij dwukrotnie Konsolidator > kliknij Ogólne > Dodatkowe katalogi bibliotek > strzałkę w dół na końcu pola > kliknij.
- Kopiuj C:\GL\SFML\lib i wklej w górnym polu tekstowym kreatora dodatkowych katalogów bibliotecznych.
- Kliknij OK w kreatorze Dodatkowe katalogi biblioteczne.
Krok 4. Skonfiguruj konsolidator Dodatkowe zależności
W menu rozwijanym „Łącznik” kliknij Dane wejściowe > Dodatkowe zależności > strzałkę w dół na końcu pola > kliknij.
- Skopiuj następujące nazwy plików.lib i wklej w górnym polu tekstowym kreatora „Dodatkowe zależności”: opengl32.lib; flac.lib; freetype.lib; ogg.lib; openal32.lib; sfml-audio.lib; sfml-grafika.lib; sfml-okno.lib; sfml-system.lib; sfml-main.lib; sfml-network.lib; vorbis.lib; vorbisenc.lib; vorbisfile.lib
- W kreatorze „Dodatkowe zależności” kliknij OK.
Krok 5. Skonfiguruj podsystem konsolidatora
W menu rozwijanym Linker kliknij System > Podsystem > strzałkę w dół na końcu pola > wybierz Konsola (/SUBSYSTEM:CONSOLE) > kliknij Zastosuj, a następnie OK.
Krok 6. Skopiuj pliki.dll z SFML i wklej do folderu projektu
W Eksploratorze plików Windows kliknij Plik w lewym górnym rogu > Nowe okno.
- W drugim (nowym) kreatorze Eksploratora plików przejdź do C:> GL> SFML> bin> kliknij openal32.dll> kliknij prawym przyciskiem myszy> Kopiuj.
- W pierwszym kreatorze Eksploratora plików przejdź do C: > GLP > SFML-0. Wewnątrz kliknij prawym przyciskiem myszy i wybierz Wklej.
- Powtórz ten proces dla plików bez -d, które są sfml-audio-2.dll, sfml-graphics-2.dll, sfml-network-2.dll, sfml-system-2.dll, sfml-window-2.dll. Teraz w folderze projektu SFML-0 masz 6 plików dll.
Krok 7. Przetestuj swój projekt
Kliknij prawym przyciskiem myszy następujący adres i wybierz Otwórz link w nowym oknie https://www.sfml-dev.org/tutorials/2.5/start-vc.php przewiń stronę i skopiuj kod.
Przejdź do programu Visual Studio i wklej w obszarze kodu Main.cpp. Naciśnij Ctrl + F5. Powinny pojawić się dwa okna: jedno czarne (konsola) i jedno małe z zielonym kółkiem na czarnym tle. Dobra robota
Krok 8. Popraw wszelkie błędy
W „Liście błędów”, jeśli widzisz błąd dotyczący
- plik z rozszerzeniem.h przejdź do części 3, krok 2, Skonfiguruj dodatkowe katalogi dołączania i postępuj zgodnie z instrukcjami.
- plik z rozszerzeniem.lib przejdź do części 3, krok 3, Konfiguruj linker Dodatkowe katalogi biblioteczne i postępuj zgodnie z instrukcjami. Również do kroku 4, Skonfiguruj konsolidator Dodatkowe zależności.
- „należy zdefiniować punkt wejścia” przejdź do kroku 5, Skonfiguruj konsolidator podsystemu i postępuj zgodnie z instrukcjami.
- plik.dll przejdź do kroku 6 i postępuj zgodnie z instrukcjami.
- W przypadku innych błędów, jeśli nie możesz ich poprawić, zamknij program Visual Studio> usuń folder projektu SFML-0, który znajduje się w C:\GLP> otwórz program Visual Studio> powtórz konfigurację z części 2 Tworzę pusty projekt. Dobra robota.
Część 4 z 7: Tworzenie projektu za pomocą szablonu
Krok 1. Utwórz szablon
Przejdź do menu głównego programu Visual Studio. Gdy SFML-0 jest otwarty, kliknij Projekt > Eksportuj szablon….
- w Wybierz typ szablonu menu, pozostaw Szablon projektu zaznaczony. Kliknij Następny….
- w Wybierz opcje szablonu, w polu Nazwa szablonu: pole tekstowe usuń wszystko i wpisz SFML > kliknij Zakończ. Szablon został utworzony.
Krok 2. Utwórz projekt
Kliknij Plik > Nowy > Projekt….
- w Utwórz nowy projekt kreator wybierz SFML (w razie potrzeby przewiń w dół listę szablonów) > kliknij Dalej.
- w Skonfiguruj swój nowy projekt kreatora, w polu tekstowym Nazwa projektu wpisz SFML-1.
- Lokalizacja powinna być C:\GLP\. Jeśli nie, usuń ścieżkę, skopiuj C:\GLP i wklej.
- Upewnij się, że opcja Umieść rozwiązanie i projekt w tym samym katalogu jest zaznaczona. Kliknij Utwórz.
Krok 3. Skopiuj pliki.dll z folderu bin jak powyżej w części 3 krok 6 i wklej do folderu projektu SFML-1
Krok 4. Projekt testowy
W Eksploratorze rozwiązań programu Visual Studio kliknij dwukrotnie Pliki źródłowe > kliknij dwukrotnie Main.cpp. (Jeśli kod się nie pojawi, usuń ten plik i utwórz inny o tej samej nazwie, skopiuj kod z https://www.sfml-dev.org/tutorials/2.5/start-vc.php i wklej w obszarze kodu). W kodzie Main.cpp przejdź do linii 7 i zmień Color::Green na Color::Blue. Kliknij Ctrl+F5. Teraz kółko w małym okienku jest niebieskie. Spróbuj poprawić wszelkie błędy. Jeśli ci się nie uda, powtórz powyższe kroki.
Część 5 z 7: Tworzenie projektu na platformę x64
Krok 1. Pobierz najnowszą stabilną wersję 64-bitowego SFML
Kliknij prawym przyciskiem myszy następujący adres i wybierz Otwórz łącze w nowym oknie https://www.sfml-dev.org/download/sfml/2.5.1/. Kliknij pierwszy przycisk na prawej liście, już dziś Pobierz 18,0 MB obok „Visual C++ 15 (2017) - 64-bitowy”.
- W oknie pobierania kliknij folder SFML-2.5.1 (lub najnowszy) > kliknij prawym przyciskiem myszy > Kopiuj.
- Przejdź do C: > GL > kliknij prawym przyciskiem myszy > wybierz Wklej (przypuszcza się, że utworzyłeś folder GL).
- Po zakończeniu kopiowania i rozpakowywania kliknij nazwę SFML-2.5.1 i zmień nazwę na SFML64.
Krok 2. Utwórz projekt
Kliknij pozycję Plik > Nowy > Projekt… > Pusty projekt > Dalej.
- w Skonfiguruj swój nowy projekt kreatora, w polu tekstowym „Nazwa projektu” wpisz: SFML64-0.
- W polu tekstowym „Lokalizacja” usuń wszystko, skopiuj C:\GLP\ i wklej (przypuszcza się, że utworzyłeś folder GLP).
- Zaznacz „Umieść rozwiązanie i projekt w tym samym katalogu” > kliknij Utwórz.
- Poczekaj, aż pojawi się wystąpienie programu Visual Studio.
Krok 3. Dodaj plik źródłowy do projektu
W programie Visual Studio > Eksplorator rozwiązań > kliknij prawym przyciskiem myszy Pliki źródłowe > kliknij Dodaj > Nowy element….
- W kreatorze Dodaj nowy element - SFML64-0 kliknij plik C++ (.cpp). W polu tekstowym Nazwa wpisz Main.cpp. Lokalizacja powinna być: C:\GLP\SFML64-0. > kliknij Dodaj.
- Plik źródłowy Main.cpp znajduje się teraz w głównym obszarze programu Visual Studio i jest pusty. W porządku.
Krok 4. Ustawienia właściwości projektu
Przejdź do „Eksploratora rozwiązań” > kliknij prawym przyciskiem myszy nazwę swojego projektu SFML64-0 > wybierz "Właściwości".
- W kreatorze stron właściwości SFML64-0 we wpisie konfiguracji wybierz Aktywny (debugowanie) > w pozycji Platforma: wybierz x64 > Kliknij Menedżer konfiguracji…
- W kreatorze Configuration Manager na platformie Active Solution: wybierz x64
- W pozycji Platforma x64 jest wybierana automatycznie.
- Kliknij Zamknij
Krok 5. Reszta jak powyżej, część 3, kroki 2-8, ale zamień SFML na SFML64 i SFML-0 na SFML64-0
Wskazówka: Nawet jeśli w ustawieniach głównych stron właściwości jest to Platforma: x64, kliknij Menedżer konfiguracji… i w Aktywnej platformie rozwiązania: wybierz x64
Krok 6. Utwórz szablon
Jak wyżej. Dla typu nazwy szablonu SFML64 i dla nazwy projektu SFML64-0. W każdym projekcie, który tworzysz za jego pomocą, wybierz x64 (obok Debug) w graficznym interfejsie użytkownika programu Visual Studio.
Część 6 z 7: Kompilowanie kodu źródłowego za pomocą CMake i Visual Studio
Krok 1. Kompilacja biblioteki z kodu źródłowego przynosi dwojakie korzyści
Gwarantuje, że wynikowa biblioteka jest idealnie dostosowana do twojego procesora/systemu operacyjnego, luksusowe, wstępnie skompilowane pliki binarne nie zawsze zapewniają, i że pliki binarne otrzymujesz docelową platformę x64.
Krok 2. Zaznacz, czego oczekujesz
Na przykład patrz zdjęcie powyżej.
Krok 3. Pobierz CMake
Kliknij prawym przyciskiem myszy następujący adres i wybierz Otwórz link w nowym oknie https://cmake.org/download/. Przewiń stronę i znajdź „Poprzednia wersja (3.19.8)”. Na drugiej liście „Platforma” znajdź „Windows win64-x64 ZIP” i kliknij obok wpis cmake-3.19.8-win64-x64.zip > w kreatorze otwierania wybierz Zapisz plik.
Krok 4. Skopiuj i rozpakuj folder zip
- W oknie pobierania kliknij folder > kliknij prawym przyciskiem myszy > w menu rozwijanym wybierz Kopiuj.
- Przejdź do katalogu C:\ > GL > kliknij prawym przyciskiem myszy > wybierz Wklej.
- Po zakończeniu kopiowania i rozpakowywania (wyodrębniania plików) kliknij dwukrotnie rozpakuj folder cmake-3.19.8-win64-x64 (lub najnowsza wersja) > bin > w środku powinieneś zobaczyć logo CMake obok nazwy pliku cmake-gui > kliknij dwukrotnie ten plik. Jeśli pojawi się kreator „Windows chroń komputer”, kliknij Więcej informacji > Uruchom mimo to. Teraz na ekranie masz CMake GUI.
- Za każdym razem, gdy potrzebujesz CMake, przejdź do C:\ > GL > cmake-3.19.8-win64-x64 > bin > kliknij dwukrotnie plik cmake-gui (ten z logo CMake).
Krok 5. Pobierz kod źródłowy
Kliknij prawym przyciskiem myszy następujący adres i wybierz Otwórz łącze w nowym oknie https://www.sfml-dev.org/download/sfml/2.5.1/. Przewiń w dół, w Wszystko Wybierz Kod źródłowy i kliknij Pobierz 22,2 MB.
Krok 6. Skopiuj i rozpakuj folder
- W oknie pobierania kliknij folder zip SFML-2.5.1-sources.zip (lub najnowsza wersja) > kliknij prawym przyciskiem myszy > wybierz Kopiuj.
- Przejdź do C:\ > GL > kliknij prawym przyciskiem myszy > wybierz Wklej.
- Teraz w katalogu C:\GL masz folder rozpakowany SFML-2.5.1. Kliknij dwukrotnie jego nazwę > usuń nazwę > wpisz SFMLsrc > naciśnij ↵ Enter.
Krok 7. Przejdź do CMake GUI
- W polu tekstowym obok Gdzie jest kod źródłowy (pierwsze pole tekstowe), wpisz C:/GL/SFMLsrc.
- W polu tekstowym obok Gdzie budować pliki binarne (drugie pole tekstowe), wpisz C:/GL/SFMLsrc/kompilacja.
Krok 8. Skonfiguruj i wygeneruj
W CMake GUI kliknij Konfiguruj > w kreatorze Utwórz katalog kliknij Tak > kliknij Zakończ.
Gdy w CMake GUI przeczytasz: „Konfiguracja zakończona”, kliknij Generuj. Powinieneś przeczytać: "Generowanie gotowe"
Krok 9. Zbuduj swoje rozwiązanie
- Przejdź do C: > GL > SFMLsrc > build. Kliknij dwukrotnie „SFML.sln”, „SFML” lub „ALL_BUILD.vcxproj”. Pojawi się wystąpienie programu Visual Studio. W menu głównym kliknij „Buduj” > „Zbuduj rozwiązanie”.
-
Poczekaj, aż przeczytasz ostatni wiersz w oknie „Wyjście”: ========== Kompilacja: 8 powiodła się, 0 nie powiodło się, 0 jest aktualne, 1 pominięto ==========
WSKAZÓWKA: Liczba „pomyślnych” zmian w wersjach SFML. Dzisiaj (28-1-2020) jest 8
Krok 10. Utwórz pusty projekt
W menu głównym programu Visual Studio kliknij pozycję Plik > Nowy > Projekt… > Utwórz nowy projekt > Pusty projekt > Dalej.
- W polu tekstowym Nazwa projektu wpisz: SFMLsrc-0.
- Obok pola tekstowego Lokalizacja kliknij ….
- Przejdź do C:\ > GLP (przypuszcza się, że utworzyłeś folder GLP) > Kliknij Wybierz folder. Lokalizacja to C:\GLP.
- Pole wyboru Umieść rozwiązanie i projekt w tym samym katalogu.
- Kliknij Utwórz.
Krok 11. Dodaj plik źródłowy do projektu
W kreatorze Eksplorator rozwiązań kliknij prawym przyciskiem myszy folder Pliki źródłowe (ostatni) > kliknij Dodaj > Nowy element…
- W oknie Dodaj nowy element - SFMLsrc-0 kliknij Plik C++ (.cpp) (pierwszy) ze środka okna. W polu tekstowym Nazwa wpisz Main.cpp.
- Lokalizacja to C:\GLP\SFMLsrc-0.
- Kliknij przycisk Dodaj. Plik otworzy się w głównym edytorze tekstu, ale na razie pozostaw go pusty.
Krok 12. Skonfiguruj Właściwości projektu
W kreatorze Eksplorator rozwiązań kliknij prawym przyciskiem myszy nazwę projektu, która jest SFMLsrc-0 > wybierz Właściwości.
-
(1) Główne menu stron właściwości SFMLsrc-0.
W pozycji Platforma wybierz x64> kliknij Configuration Manager….
- W platformie Active Solution: wybierz x64.
- W pozycji Platforma x64 jest wybierana automatycznie.
- Kliknij Zamknij.
-
(2) Dodatkowe katalogi dołączania. Kliknij C/C++ > Ogólne > W menu obok wybierz pierwszy, Dodatkowe katalogi dołączania > kliknij strzałkę w dół na końcu pola > kliknij.
Kopiuj C:\GL\SFMLsrc\include > w kreatorze „Dodatkowe katalogi dołączane” kliknij pierwszą ikonę > wklej.
-
(3) Dodatkowe katalogi biblioteczne. Kliknij dwukrotnie Linker > kliknij Ogólne > Dodatkowe katalogi biblioteczne > kliknij strzałkę w dół na końcu pola > kliknij
Kopiuj C:\GL\SFMLsrc\build\lib\Debug > w kreatorze „Dodatkowe katalogi biblioteczne” kliknij pierwszą ikonę > wklej.
- (4) Dodatkowe zależności. W menu rozwijanym Linker wybierz Input > w menu obok wybierz pierwszy, Dodatkowe zależności > kliknij strzałkę w dół na końcu pola > Edytuj… > kopiuj opengl32.lib; sfml-audio-d.lib; sfml-grafika-d.lib; sfml-main-d.lib; sfml-sieć-d.lib; sfml-system-d.lib; sfml-window-d.lib i wklej w górnym polu tekstowym kreatora Dodatkowe zależności > kliknij OK.
-
(5) Ustaw System na Konsola podsystemu.
W menu rozwijanym Linker wybierz System > w menu obok wybierz pierwszy, Podsystem > kliknij strzałkę w dół na końcu pola > wybierz Konsola (/SUBSYSTEM:CONSOLE). Kliknij Zastosuj i OK.
Krok 13. Skopiuj pliki dll i wklej je do folderu projektu SFMLsrc-0
W systemie Windows Przeglądarka plików kliknąć Plik > Otwórz nowe okno. W nowym (drugim) oknie przejdź do C: > GL > SFML > build > lib > Debug i skopiuj (klikając prawym przyciskiem myszy > Kopiuj), jeden po drugim, wszystkie 5 (pięć) plików dll i wklej w pierwszym oknie C: > GLP > SFMLsrc-0. Teraz w folderze projektu SFMLsrc-0 masz 5 plików dll wśród Main.cpp i innych 4 plików utworzonych przez Visual Studio.
Krok 14. Przetestuj swój projekt i popraw ewentualne błędy
Jak wyżej, patrz część 3 Konfigurowanie SFML w projekcie.
Krok 15. Utwórz szablon za pomocą projektu SFMLsrc-0
Jak wyżej, część 4 Utwórz projekt za pomocą szablonu. Dla typu nazwy szablonu SFMLsrc. Dla typu nazwy projektu SFMLsrc-1. Pamiętaj w każdym projekcie, który tworzysz za pomocą tego szablonu
- wybierz x64 w graficznym interfejsie użytkownika programu Visual Studio.
- skopiuj pliki dll z poprzedniego projektu i wklej w nowym.
Część 7 z 7: Wybór konfiguracji
Krok 1. W tym samouczku dowiesz się, jak 3 polegało na skonfigurowaniu SFML w programie Project z Visual Studio
-
Skonfiguruj pliki binarne x86 (32 bity).
To najłatwiejsze. Powinieneś rozpocząć naukę konfiguracji od tego miejsca.
-
Skonfiguruj pliki binarne x64 (64 bity).
Jest skierowany do platformy x64. Wybierz ją tylko wtedy, gdy masz ku temu konkretny powód.
-
Skompiluj źródło SFML i skonfiguruj w projekcie.
Cele również x64. Najtrudniejszy. Jednak najlepsze.