Install

インストール

安装

Caution: Ebitengine on FreeBSD is not tested well by the author.

注意: FreeBSD 上の Ebitengine は、作者によってあまりテストされていません。

注意: 开发者在FreeBSD上的测试并不尽如人意.

Desktop Environment

デスクトップ環境

桌面环境

Ebitengine requires X Window system and you need to install a window manager like GNOME3. See the official manual. Note that you also need to do pkg install xorg.

Ebitengine を動かすためには X Window system が必要です。 GNOME3 のようなウィンドウマネージャをインストールする必要があります。公式マニュアルを参照してください。 pkg install xorg を実行する必要があることに注意してください。

Ebitengine 需要 X Window system,因此,您需要安装一个桌面环境,如 GNOME3。请参照官方文档.注意,你可能还需要pkg install xorg.

Go

Install Go on your machine. Ebitengine requires Go 1.15 or later.

Go をインストールしてください。 Ebitengine を動かすためには Go 1.15 以降が必要です。

在您的计算机中安装Go。 Ebitengine需要Go 1.15或更高版本。

Note that you do NOT need a C compiler for Ebitengine on Windows.

Windows では、 C コンパイラは必要ありません。

注意:在Windows上, Ebitengine 不需要C编译器。

C compiler

C コンパイラ

C编译器

A C compiler is required as Ebitengine uses not only Go but also C.

Ebitengine は Go だけではなく C も使っているため、 C コンパイラが必要になります。

C编译器是必需的,因为Ebitengine不仅使用Go,还使用C语言。

On the latest macOS, just type clang on your terminal and a dialog would appear if you don't have clang compiler. Follow the instruction to install it.

最新の macOS ならば、ターミナル上で clang と入力すれば、 clang がまだインストールされていないのであれば、ダイアログが表示されます。指示に従ってインストールしてください。

You might find the following error when executing clang.

clang 実行中に次のようなエラーメッセージが表示されるかもしれません。

xcrun: error: invalid active developer path (/Library/Developer/CommandLineTools), missing xcrun at: /Library/Developer/CommandLineTools/usr/bin/xcrun

In this case, run xcode-select --install and install commandline tools.

その場合は xcode-select --install を実行して、コマンドラインツールをインストールしてください。

Use your distribution's package manager. For example, Ubuntu can use apt.

お使いのディストリビューションのパッケージマネージャを使ってください。例えば、 Ubuntu では apt が使えます。

使用Linux发行版的包管理器。例如,Ubuntu可以使用apt.

apt install gcc

Use pkg.

pkg を使ってください。

使用pkg

pkg install clang

Dependencies

依存ライブラリ

依赖

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
pkg install alsa-lib libxcursor libxi libxinerama libxrandr mesa-libs pkgconf

Ebitengine

Ebitengine can be used as a usual Go library. Go command automatically installs Ebitengine when your program uses Ebitengine.

Ebitengine は通常の Go ライブラリとして使用できます。プログラムが Ebitengine を使用していれば、 Go コマンドが自動的に Ebitengine をインストールします。

Ebitengine 可以作为一个普通的Go模块使用。当您的程序引用 Ebitengine 包时,Go会自动安装 Ebitengine。

First, create your local module.

最初に、ローカルモジュールを作ります。

首先,新建一个本地软件包。

# Create a directory for your game.
mkdir yourgame
cd yourgame

# Initialize go.mod by `go mod`.
go mod init github.com/yourname/yourgame
<<<<<<< HEAD

Use URL for your module name like github.com/yourname/yourgame. Actually, any module name like example.com/m is fine as long as you don't plan to share this publicly. You can change the module name anytime later.

github.com/yourname/yourgame のような URL をモジュール名に使用します。実際のところ、自分のプログラムを公開するつもりがないのであれば、 example.com/m などどんなモジュール名でも問題ありません。モジュール名は後でいつでも変えられます。

Use URL for your module name like github.com/yourname/yourgame. Actually, any module name like example.com/m is fine as long as you don't plan to share this publicly. You can change the module name anytime later.

Then, run the command to execute an Ebitengine example.

次に、 Ebitengine のサンプルを実行します。

然后, 通过命令行运行一个 Ebitengine 示例.

go get github.com/hajimehoshi/ebiten/v2
go run -tags=example github.com/hajimehoshi/ebiten/v2/examples/rotate

go get retrieves the code of Ebitengine. go run compiles Go files and runs it immediately after the compilation. As the first retrieving the code and compilation might take a little long time, please wait for a while. Note that you can see what is happening on the compilation process with -x option if you want.

go get は Ebitengine のコードを取得します。 go run は Go ファイルをコンパイルし、即座に実行します。最初のコード取得とコンパイルは少々時間がかかるかもしれないため、しばらくお待ち下さい。必要ならば -x をつけることで、コンパイル処理中に何が行われているのかを見ることができます。

使用 go get 可以获取 Ebitengine 库. 使用 go run 可以在编译Go文件后立刻运行。 第一次获取库和编译可能会花很长时间, 请稍加等待. 提示: 如果您想看看编译器正在干什么,可以加上 -x 参数.

Note that -tags=example is needed to execute the examples as the Ebitengine example packages require the build tag.

-tags=example は Ebitengine のサンプルを実行するために必要です。 Ebitengine サンプルのパッケージがビルドタグを必要とするためです。

注意: 如果您想要运行Ebitengine的示例游戏,你需要在运行时加上-tags=example参数。

If you see the window with a rotating Gophers picture, congratulations! You have succeeded to install Ebitengine.

回転する Gopher の絵がウィンドウ上に表示されたならば、おめでとうございます! Ebitengine のインストールに成功しました。

如果您在窗口上看到这张 Gopher 的图片,恭喜你!你已经成功安装Ebitengine。

Rotate example

=======

Use URL for your module name like github.com/yourname/yourgame. Actually, any module name like example.com/m is fine as long as you don't plan to share this publicly. You can change the module name anytime later.

github.com/yourname/yourgame のような URL をモジュール名に使用します。実際のところ、自分のプログラムを公開するつもりがないのであれば、 example.com/m などどんなモジュール名でも問題ありません。モジュール名は後でいつでも変えられます。

Then, run the command to execute an Ebitengine example.

次に、 Ebitengine のサンプルを実行します。

go get github.com/hajimehoshi/ebiten/v2
go run -tags=example github.com/hajimehoshi/ebiten/v2/examples/rotate

go get retrieves the code of Ebitengine. go run compiles Go files and runs it immediately after the compilation. As the first retrieving the code and compilation might take a little long time, please wait for a while. Note that you can see what is happening on the compilation process with -x option if you want.

go get は Ebitengine のコードを取得します。 go run は Go ファイルをコンパイルし、即座に実行します。最初のコード取得とコンパイルは少々時間がかかるかもしれないため、しばらくお待ち下さい。必要ならば -x をつけることで、コンパイル処理中に何が行われているのかを見ることができます。

Note that -tags=example is needed to execute the examples as the Ebitengine example packages require the build tag.

-tags=example は Ebitengine のサンプルを実行するために必要です。 Ebitengine サンプルのパッケージがビルドタグを必要とするためです。

If you see this window with a rotating Gophers image, congratulations!

You have sucessfully installed Ebitengine!

回転する Gopher の絵がウィンドウ上に表示されたならば、おめでとうございます! Ebitengine のインストールに成功しました。

Rotate example

>>>>>>> a88ba8e8aeb239a2a2a9121f75c24c2d7da302a7