linux-arm: Build fails with 'EGL/egl.h' file not found when using -tags wayland

[SebastianAurica]

Checklist

• I have searched the issue tracker for open issues that relate to the same problem, before opening a new one.
• This issue only relates to a single bug. I will open new issues for any other problems.

Describe the bug

I am trying to cross-compile a Fyne application for linux/arm (32-bit armv7l) targeting an environment without X11 (Wayland/GLES || Buildroot with weston).
The standard build fails because the cross-compiler cannot find the EGL headers.

How to reproduce

fyne-cross linux -arch=arm
Result: The executable resulted returns missing libGL, because the device has libGLESv2 and not libGL
fyne-cross linux -arch=arm -tags gles,wayland --no-cache
The build fails immediately because it cannot find the EGL headers:
# github.com/go-gl/glfw/v3.3/glfw In file included from /go/pkg/mod/github.com/go-gl/glfw/v3.3/glfw@v0.0.0-20240506104042-037f3cc74f2a/native_linbsd_wayland.go:11: ./glfw/include/GLFW/glfw3native.h:144:12: fatal error: 'EGL/egl.h' file not found 144 | #include <EGL/egl.h> | ^~~~~~~~~~~ 1 error generated.

Screenshots

Example code

go: downloading fyne.io/fyne/v2 v2.7.1
go: downloading github.com/godbus/dbus/v5 v5.1.0
go: downloading github.com/rymdport/portal v0.4.2
go: downloading github.com/fsnotify/fsnotify v1.9.0
go: downloading github.com/BurntSushi/toml v1.5.0
go: downloading github.com/nfnt/resize v0.0.0-20180221191011-83c6a9932646
go: downloading github.com/fredbi/uri v1.1.1
go: downloading github.com/fyne-io/image v0.1.1
go: downloading fyne.io/systray v1.11.1-0.20250603113521-ca66a66d8b58
go: downloading github.com/go-gl/glfw/v3.3/glfw v0.0.0-20240506104042-037f3cc74f2a
go: downloading github.com/go-text/typesetting v0.2.1
go: downloading github.com/yuin/goldmark v1.7.8
go: downloading golang.org/x/image v0.24.0
go: downloading github.com/go-text/render v0.2.0
go: downloading github.com/srwiley/rasterx v0.0.0-20220730225603-2ab79fcdd4ef
go: downloading github.com/go-gl/gl v0.0.0-20231021071112-07e5d0ea2e71
go: downloading github.com/jeandeaual/go-locale v0.0.0-20250612000132-0ef82f21eade
go: downloading github.com/fyne-io/oksvg v0.2.0
go: downloading github.com/nicksnyder/go-i18n/v2 v2.5.1
go: downloading golang.org/x/text v0.22.0
go: downloading github.com/jsummers/gobmp v0.0.0-20230614200233-a9de23ed2e25
go: downloading golang.org/x/sys v0.30.0
go: downloading golang.org/x/net v0.35.0
go: downloading github.com/srwiley/oksvg v0.0.0-20221011165216-be6e8873101c

github.com/go-gl/glfw/v3.3/glfw

In file included from /go/pkg/mod/github.com/go-gl/glfw/v3.3/glfw@v0.0.0-20240506104042-037f3cc74f2a/native_linbsd_wayland.go:11:
./glfw/include/GLFW/glfw3native.h:144:12: fatal error: 'EGL/egl.h' file not found
144 | #include <EGL/egl.h>
| ^~~~~~~~~~~
1 error generated.

error building application: exit status 1
[✗] could not package the Fyne app: could not package the Fyne app: exit status 1

Fyne version

fyne cli version: v2.7.1

Go compiler version

go version go1.24.9 linux/amd64

Operating system and version

Linux 6.16.8+kali-amd64 #1 SMP PREEMPT_DYNAMIC Kali 6.16.8-1kali1 (2025-09-24) x86_64 GNU/Linux

Additional Information

No response

[andydotxyz]

Can you attempt using the fyne tool instead of fyne-cross?
It may be that the images don't include all the headers for 32-bit/GLES linux compilation.

[SebastianAurica]

Running fyne build -os linux/arm --tags gles,wayland -o armbuild returns go: unsupported GOOS/GOARCH pair linux/arm/amd64
And by running fyne build -os linux --tags gles,wayland -o armbuild i still get libGL as dependency
readelf -d ./armbuild | grep NEEDED
0x0000000000000001 (NEEDED) Shared library: [libGL.so.1]
0x0000000000000001 (NEEDED) Shared library: [libwayland-client.so.0]
0x0000000000000001 (NEEDED) Shared library: [libm.so.6]
0x0000000000000001 (NEEDED) Shared library: [libc.so.6]

[andydotxyz]

It would be GOARCH=arm fyne build -os linux --tags gles,wayland -o armbuild (as the fyne -os parameter is only the OS).

And by running fyne build -os linux --tags gles,wayland -o armbuild i still get libGL as dependency

This may be a red-herring as we might only allow GLES for linux on arm, so try fixing the above command. If not then there may be two issues here - one in Fyne and one in fyne-cross.

[SebastianAurica]

Running GOARCH=arm fyne build -os linux --tags gles,wayland -o armbuild first returned
NOTE: This tool is deprecated and has migrated to fyne.io/tools/cmd/fyne. The new tool can be installed by running the following command: go install fyne.io/tools/cmd/fyne@latest
...
/usr/lib/go-1.24/pkg/tool/linux_amd64/link: running arm-linux-gnueabihf-gcc failed: exit status 1
.../ld: cannot find -lwayland-client: No such file or directory
.../ld: cannot find -lwayland-cursor: No such file or directory
.../ld: cannot find -lwayland-egl: No such file or directory
.../ld: cannot find -lxkbcommon: No such file or directory
...

Then ran
sudo dpkg --add-architecture armhf
sudo apt install -y \ gcc-arm-linux-gnueabihf g++-arm-linux-gnueabihf \ pkg-config \ libwayland-dev:armhf \ libwayland-egl1:armhf \ libwayland-egl-backend-dev:armhf \ libxkbcommon-dev:armhf \ libegl1-mesa-dev:armhf \ libgles2-mesa-dev:armhf \ libgl1-mesa-dev:armhf

Rerunning GOARCH=arm fyne build -os linux --tags gles,wayland -o armbuild made the build succesfully, but
readelf -d ./armbuild | grep NEEDED
0x00000001 (NEEDED) Shared library: [libGL.so.1]
0x00000001 (NEEDED) Shared library: [libwayland-client.so.0]
0x00000001 (NEEDED) Shared library: [libm.so.6]
0x00000001 (NEEDED) Shared library: [libc.so.6]