# SDL2: 安裝 ###### tags: `SDL` ## 前言 這篇文章獻給所有想靠著網站LazyFoo學習SDL，卻發現下載下來的檔案都打不開。和所有覺得安裝SDL2真的鳥到爆卻因為學分不得不想辦法安裝的人們。**~~<–本人目前在這~~** 因為對於每次都要重新建project和輸入一堆參數(大部分教學的方法)感到厭煩，所以決定直接system-wide安裝，一勞永逸。以下兩種方法都會提供。 注意，以下方法適用的系統是: **Windows(x64) + DevC++** 任何不是使用這種配置的用戶，你可能得另請高明教你安裝…… ## 下載 首先下載SDL和所有相關的資源包。 - 官網: [https://github.com/libsdl-org/SDL/releases/] 下載、解壓完成後，你會得到一堆資料夾們，這時候就是你決定安裝方式的時候了! ## Case 1: Global Compiler Settings ### 優缺點 - 優點: 不用一直建立project，每次建立都要重新輸入路徑等等。 - 缺點: 編譯其他不用SDL的程式碼時會浪費一些資源(幾乎無感)。 結論: 短時間內會大量使用SDL的話就用吧! ### Step 1: 將資源包找個地方放 不如就放在C:/吧! 最好找。請將所有資源包都放在同一個路徑底下，**不要拆開資料夾內的東西!!!**，完成後你的資料夾們應該長得像: ``` C:/ ├─ SDL2-2.24.2/ ├─ SDL2_image-2.6.2/ ⋮ ``` C:/可以換成任何你想要放的地方，暫且稱作<path>。那麼之後遇到C:/的地方都要用<path>取代掉。例如: ``` let <path> = C:\Program Files(x86) C:\SDL2-2.24.2\x86_64-w64-mingw32\lib -> C:\Program Files(x86)\SDL2-2.24.2\x86_64-w64-mingw32\lib ``` ### Step 2: 設定Compiler 我們有三個部分要設定，首先是函式庫路徑，請點擊Tools > Compiler Options，選單選到Directories -> Libraries **逐行**輸入以下路徑到視窗底部的輸入框，完成後**按Add**: ``` C:\SDL2-2.24.2\x86_64-w64-mingw32\lib C:\SDL_bgi-2.6.0\bin\Mingw64 C:\SDL2_image-2.6.2\x86_64-w64-mingw32\lib C:\SDL2_mixer-2.6.2\x86_64-w64-mingw32\lib C:\SDL2_ttf-2.20.1\x86_64-w64-mingw32\lib C:\SDL2_net-2.2.0\x86_64-w64-mingw32\lib ``` 全部完成後，一樣在上方選單，選到Directories -> C++ Includes **逐行**輸入以下路徑到視窗底部的輸入框，完成後**按Add**: ``` C:\SDL2-2.24.2\x86_64-w64-mingw32\include\SDL2 C:\SDL_bgi-2.6.0\src C:\SDL2_mixer-2.6.2\x86_64-w64-mingw32\include C:\SDL2_image-2.6.2\x86_64-w64-mingw32\include C:\SDL2_ttf-2.20.1\x86_64-w64-mingw32\include C:\SDL2_net-2.2.0\x86_64-w64-mingw32\include\SDL2 ``` 全部完成後，一樣在上方選單，選到General。將第一個方框(Add following command lines when calling the compiler)打勾，並輸入指令:(建議直接複製) ``` -lmingw32 -L/mingw64/bin -lSDL_net -lSDL_bgi -lSDL2_ttf -lSDL2_mixer -lSDL2_image -lSDL2main -lSDL2 ``` 以上三步驟，若您有部分函式庫並未用到，**請不要輸入該行**。例如: SDL2_net並未使用，則不需要輸入的部分是: ``` C:\SDL2_net-2.2.0\x86_64-w64-mingw32\lib C:\SDL2_net-2.2.0\x86_64-w64-mingw32\include\SDL2 -lSDL_net ``` ### Step 3: 測試 到 [https://lazyfoo.net/tutorials/SDL/index.php](https://lazyfoo.net/tutorials/SDL/index.php) 隨意找一篇教學下載下來，會得到該篇教學的.cpp檔和相關檔案。在您急著打開Dev-C++按下F11之前，**請記得將.dll檔案們，複製到與.cpp相同的路徑下!** 現在你可以按下F11編譯了! 檔案應該會如期執行，完成編譯。(若是有跳出執行視窗，但視窗中顯示有錯誤，那不是安裝錯誤，是程式內部邏輯的錯誤。) ### Step 4: 使用 使用時，就像是使用標準函式庫一般，直接使用: ```cpp #include <SDL.h> #include <SDL_image.h> ... ``` 完成!開啟你的絕望開發之旅吧! 若需要建立project，也不需要額外參數設定，建立完後直接使用即可。 ## Case 2: Work with Projects ### 優缺點 - 優點: 編譯其他不用SDL的程式碼時不會干涉到。 - 缺點: 每次建立新程式(有一個main出現)就需要建立一次，每次建立都要重新輸入路徑 ### Step 1: 將資源包找個地方放 不如就放在C:/吧! 最好找。請將所有資源包都放在同一個路徑底下，**不要拆開資料夾內的東西!!!**，完成後你的資料夾們應該長得像: ``` C:/ ├─ SDL2-2.24.2/ ├─ SDL2_image-2.6.2/ ⋮ ``` C:/可以換成任何你想要放的地方，暫且稱作。那麼之後遇到C:/的地方都要用路徑取代掉。 ### Step 2: 開 Project 點擊File -> New -> Project，選擇Empty Project。 輸入Project Name後按下OK即完成建立，選擇一個放project的地方，**建議放在某資料夾內**。 ### Step 3: 設定Project 按下Ctrl+H開啟設定視窗。 我們有三個部分要設定，首先是函式庫路徑，選單選到Directories -> Library Directories **逐行**輸入以下路徑到視窗底部的輸入框，完成後**按Add**: ``` C:\SDL2-2.24.2\x86_64-w64-mingw32\lib C:\SDL_bgi-2.6.0\bin\Mingw64 C:\SDL2_image-2.6.2\x86_64-w64-mingw32\lib C:\SDL2_mixer-2.6.2\x86_64-w64-mingw32\lib C:\SDL2_ttf-2.20.1\x86_64-w64-mingw32\lib C:\SDL2_net-2.2.0\x86_64-w64-mingw32\lib ``` 全部完成後，一樣在上方選單，選到Directories -> Include Directories **逐行**輸入以下路徑到視窗底部的輸入框，完成後**按Add**: ``` C:\SDL2-2.24.2\x86_64-w64-mingw32\include\SDL2 C:\SDL_bgi-2.6.0\src C:\SDL2_mixer-2.6.2\x86_64-w64-mingw32\include C:\SDL2_image-2.6.2\x86_64-w64-mingw32\include C:\SDL2_ttf-2.20.1\x86_64-w64-mingw32\include C:\SDL2_net-2.2.0\x86_64-w64-mingw32\include\SDL2 ``` 全部完成後，一樣在上方選單，選到Parameters。在最右邊的輸入框(Linkers)輸入指令:(建議直接複製) ``` -lmingw32 -L/mingw64/bin -lSDL_net -lSDL_bgi -lSDL2_ttf -lSDL2_mixer -lSDL2_image -lSDL2main -lSDL2 ``` 以上三步驟，若您有部分函式庫並未用到，**請不要輸入該行**。例如: SDL2_net並未使用，則不需要輸入的部分是: ``` C:\SDL2_net-2.2.0\x86_64-w64-mingw32\lib C:\SDL2_net-2.2.0\x86_64-w64-mingw32\include\SDL2 -lSDL_net ``` ### Step 3: 測試 到 [https://lazyfoo.net/tutorials/SDL/index.php](https://lazyfoo.net/tutorials/SDL/index.php) 隨意找一篇教學下載下來並解壓，會得到該篇教學的.cpp檔和相關檔案。現在請在Dev-C++最左欄，找到project的名字，右鍵點擊打開->點擊Add to Project，然後找到剛剛下載的.cpp檔並import到project內。 在您急著按下F11之前，**請記得將.dll檔案們，複製到與.cpp相同的路徑下!** 現在你可以按下F11編譯了!檔案應該會如期執行，完成編譯。(若是有跳出執行視窗，但視窗中顯示有錯誤，那不是安裝錯誤，是程式內部邏輯的錯誤。) ### Step 4: 使用 使用時，請使用雙引號取代尖括號: ```cpp #include "SDL.h" #include "SDL_image.h" ... ``` 完成! 開啟你的絕望開發之旅吧! ## 疑難排解 1. **Q: 安裝好了，但還是不能編譯LazyFoo的範例程式。** A: 請確定include的部分，寫入Directories -> Include Directories的路徑和include的路徑，合起來必須是該標頭檔(.h / header file)實際的位置。 例如SDL.h所在位置是C:\SDL2-2.24.2\x86_64-w64-mingw32\include\SDL2\SDL.h，若Include Directories中的路徑是C:\SDL2-2.24.2\x86_64-w64-mingw32\include\，則應該寫為 ```cpp #include <SDL2/SDL.h> ``` ## 其他版本的替代方案 ### 使用Windows電腦，但不是使用Dev-C++ 1. 自己找一下類似的設定，然後輸入該輸入的部分，大致上不會差太多。 2. 下載Dev-C++就好啦。 ### 使用Linux或MacOS 1. 買一台Windows電腦 2. 裝Windows 3. 用VirtualBox模擬Windows 4. 等其他使用者摸索完寫一篇文章給你。 對啦，我懶得研究其他系統。我也是來混3學分的好嗎。