Table of Contents

This commit

commit 4089b6f8c7cda3a2f86f770a15b15c1af9c643d8
Author: Elias Naur <mail@eliasnaur.com>
Date:   2019-08-14T08:57:09+00:00

install.md: add note about -H windowsgui for avoiding the Windows console

Signed-off-by: Elias Naur <mail@eliasnaur.com>
Clone this wiki
https://git.sr.ht/~eliasnaur/gio (read-only) git@git.sr.ht:~eliasnaur/gio (read/write)


For Linux you need Wayland and the wayland, xkbcommon, GLES, EGL development packages.

On Fedora 28 and newer, install the dependencies with the command

$ sudo dnf install wayland-devel libxkbcommon-devel mesa-libGLES-devel mesa-libEGL-devel

On Ubuntu 18.04 and newer, use

$ sudo apt install libwayland-dev libxkbcommon-dev libgles2-mesa-dev libegl1-mesa-dev

Note that Gio does not run with the NVIDIA proprietary driver.

macOS, iOS, tvOS

Xcode is required for Apple platforms.

Building for tvOS requires Go 1.13.


For Windows you need the ANGLE drivers for emulating OpenGL ES.

You can build ANGLE yourself or use a prebuilt version. Leave the DLLs in the same directory as the Gio program.

To avoid the console appearing when running Gio programs, use the -H windowsgui linker flag:

$ go build -ldflags="-H windowsgui" gioui.org/apps/hello


For Android you need the Android SDK with the NDK bundle installed.

Point the ANDROID_HOME to the SDK root directory. To install the NDK bundle use the sdkmanager command that comes with the SDK:

$ sdkmanager 'ndk-bundle'


To run Gio in a browser you need support for WebAssembly and WebGL.

Building for webassembly requires Go 1.13.