Skip to content

[Qt 6.10] Wayland platform plugins missing in AppImage builds due to library renaming #13855

@TomZanna

Description

@TomZanna

Summary

In recent builds using Qt 6.10, the generated AppImage is missing the required Wayland platform plugins. As a result, QGroundControl cannot run natively on Wayland sessions, often falling back to XWayland or failing to start entirely when X11 compatibility is unavailable.

Root Cause

This issue appears to be caused by a change in the Qt 6.10 library naming convention.
The current configuration in appimagecraft.yml does not account for these new filenames, causing the deployment tool linuxdeploy to skip the Wayland platform plugins during the bundling process.

More specifically, the platform plugin filenames have changed, so the file-matching patterns currently defined in the build configuration no longer match the files provided by the Qt 6.10 SDK.

Attempted Fix

I tried updating appimagecraft.yml with EXTRA_PLATFORM_PLUGINS: "libqwayland.so" but unfortunately this did not resolve the issue. The Wayland platform plugins are still not included in the generated AppImage.

Due to time constraints, I’m unable to investigate this further at the moment or prepare a proper pull request.
I’m opening this issue to document the problem and my findings so it can be tracked and hopefully addressed by someone more familiar with the deployment tooling or Qt 6.10 changes.

Reference

A related discussion about Qt 6 compatibility and required changes in deployment tools can be found here:
linuxdeploy/linuxdeploy-plugin-qt#157 (comment)

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions