本文實時更新原址:https://ebitencookbook.vercel.app/docs/CookBook_Start/class1
第一課 安裝 Ebiten
歡迎大家來到 Ebiten 中文教程.
今天我們正式開始學習Ebiten的開發.
安裝開發環境
也可以參照官方教程(中文文件): https://ebiten-zh.vercel.app/documents/install.html
1. 安裝作業系統
沒有的話建議remake.
2. 安裝依賴
使用Windows系統的朋友請直接跳到下一步.
FreeBSD 比較特殊,需要先安裝桌面環境,詳情見官方教程.
C編譯器
macOS,Linux,FreeBSD需要先安裝C編譯器(基本上使用gcc)
macOS
據說在最新的MacOS上,在命令列輸入clang後,如果沒有C編譯器,系統會引導您安裝.
其他版本的MacOS還可以通過brew install gcc安裝.
:::important
如果在安裝時報出以下錯誤:
xcrun: error: invalid active developer path (/Library/Developer/CommandLineTools), missing xcrun at: /Library/Developer/CommandLineTools/usr/bin/xcrun
可以通過執行 xcode-select --install 來安裝.
:::
Linux
以Linux發行版Ubuntu為例,執行:
sudo apt install gcc
其他發行版請使用各自的包管理器或原始碼安裝gcc.
FreeBSD
如果使用pkg作為包管理器,就執行:
pkg install clang
當然也可以原始碼安裝.
安裝其他依賴
Linux 發行版
Debian/Ubuntu
sudo apt install libc6-dev libglu1-mesa-dev libgl1-mesa-dev libxcursor-dev libxi-dev libxinerama-dev libxrandr-dev libxxf86vm-dev libasound2-dev pkg-config
Fedora
sudo dnf install mesa-libGLU-devel mesa-libGLES-devel libXrandr-devel libXcursor-devel libXinerama-devel libXi-devel libXxf86vm-devel alsa-lib-devel pkg-config
Solus
sudo eopkg install libglu-devel libx11-devel libxrandr-devel libxinerama-devel libxcursor-devel libxi-devel libxxf86vm-devel alsa-lib-devel pkg-config
Arch
sudo pacman -S mesa libxrandr libxcursor libxinerama libxi pkg-config
Alpine
sudo apk add alsa-lib-dev libx11-dev libxrandr-dev libxcursor-dev libxinerama-dev libxi-dev mesa-dev pkgconf
FreeBSD
pkg install alsa-lib libxcursor libxi libxinerama libxrandr mesa-libs pkgconf
3. 安裝Golang
沒有的話還是建議remake.
如果還沒安裝的話,可以到golang.google.cn/dl(國內映象)或go.dev/dl(全球)下載.
建議直接裝最新版本,因為 Ebiten 向上相容.
:::important
Ebiten v2.2.5 要求最低Go版本: 1.15.
:::
如果您在控制檯(CMD或bash等)輸入 go version 後,命令列輸出類似以下的內容,證明Golang安裝成功.
$ go version
go version go1.17.5 windows/amd64
4. 下載Ebiten庫
:::important
如果您在中國大陸地區,可以使用goproxy.cn提供的國內代理加速.
go env -w GO111MODULE=on
go env -w GOPROXY=https://goproxy.cn,direct
:::
執行以下指令:
go get github.com/hajimehoshi/ebiten/v2
:::note
這裡一定不要漏掉最後的v2,否則會安裝Ebiten v1.12.
:::
5. 測試安裝
執行以下指令,測試安裝是否成功.
go run -tags=example github.com/hajimehoshi/ebiten/v2/examples/rotate
當你的螢幕上出現了一個視窗,並顯示下面這幅圖片,證明Ebiten安裝成功並可以成功編譯執行example/rotate.
!end time: 2022-04-03 23:50