本文实时更新原址: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