EbitenCookBook中文教程 第一课:安装 Ebiten

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

test print

!end time: 2022-04-03 23:50