flutter engine build with --enable-minimal-linux requires X11 for Vulkan #176684

Activity

1. ctkqiang commented on Oct 8, 2025

   

   ctkqiang

   on Oct 8, 2025

   Last edited by ctkqiang

   More actions

   Steps to reproduce

   1. Setup symlinks for the custom toolchain

      cd engine/src/flutter/buildtools/linux-x64/clang/bin
      ln -s llvm-ar armv7-unknown-linux-gnueabihf-ar
      ln -s llvm-readelf armv7-unknown-linux-gnueabihf-readelf
      ln -s llvm-nm armv7-unknown-linux-gnueabihf-nm
      ln -s llvm-strip armv7-unknown-linux-gnueabihf-strip
      

   2. From a Linux host, cross compile to a Linux target with --enable-minimal-linux

      ./engine/src/flutter/tools/gn \
          --target-os=linux \
          --linux-cpu=arm \
          --enable-minimal-linux \
          --arm-float-abi=hard \
          --disable-desktop-embeddings \
          --embedder-for-target \
          --target-triple=armv7-unknown-linux-gnueabihf \
          --target-sysroot= # some sysroot without X11 libraries \
          --target-toolchain=$(pwd)/engine/src/flutter/buildtools/linux-x64/clang
      ninja -C engine/src/out/linux_debug_unopt_arm flutter/shell/platform/embedder:flutter_engine
      

   Expected results

   The build completes successfully

   Actual results

   A build error occurs from the vulkan headers

   ../../flutter/third_party/vulkan-deps/vulkan-headers/src/include/vulkan/vulkan.h:52:10: fatal error: 'xcb/xcb.h' file not found
      52 | #include <xcb/xcb.h>
         |          ^~~~~~~~~~~
   1 error generated.
   

   First can you locateflutter/impeller/renderer/backend/vulkan/vulkan_surface.cc?

   If you just need it to compile, install the missing X11 headers so Vulkan can find xcb/xcb.h. Oh yes remember to install it and build it:

   sudo apt-get update
   sudo apt-get install libxcb1-dev libxcb-util-dev libx11-dev

   then

   ./pathto/tools/gn --enable-minimal-linux
   ninja -C out/linux_release
2. tirth-patel-nc

   added

   in triagePresently being triaged by the triage teamPresently being triaged by the triage team

   on Oct 8, 2025
3. tirth-patel-nc commented on Oct 8, 2025

   

   tirth-patel-nc

   on Oct 8, 2025

   Member

   More actions

   @planetmarshall thanks for the report. Keeping it open for team's tracking. Also Please confirm whether #140690 #164051 #144635 are related to your case

   👀React with 👀1Reacted by 哪吒网络安全的钟智强
4. tirth-patel-nc

   added

   platform-linuxBuilding on or for Linux specificallyBuilding on or for Linux specifically

   engineflutter/engine related. See also e: labels.flutter/engine related. See also e: labels.

   team-engineOwned by Engine teamOwned by Engine team

   and removed

   in triagePresently being triaged by the triage teamPresently being triaged by the triage team

   platform-linuxBuilding on or for Linux specificallyBuilding on or for Linux specifically

   on Oct 8, 2025
5. planetmarshall commented on Oct 8, 2025

   

   planetmarshall

   on Oct 8, 2025

   ContributorAuthor

   More actions

   @planetmarshall thanks for the report. Keeping it open for team's tracking. Also Please confirm whether #140690 #164051 #144635 are related to your case

   • Compiling flutter engine for embedded linux always requires Vulkan. #140690 - Related. Although the reporter wants to avoid the vulkan dependency altogether, the reasoning given is to avoid the X11 dependency which is addressed by Disable vulkan X11 support when building for minimal linux #176697
   • Flutter Engine will not compile on linux if IMPELLER_ENABLE_VULKAN=0 #164051 - Not related.
   • Flutter 3.19.x made wayland an unconditional requirement #144635 - Not related.

   👀React with 👀1Reacted by 哪吒网络安全的钟智强
6. chinmaygarde

   added

   waiting for PR to land (fixed)A fix is in flightA fix is in flight

   P2Important issues not at the top of the work listImportant issues not at the top of the work list

   triaged-engineTriaged by Engine teamTriaged by Engine team

   on Oct 13, 2025
7. github-merge-queue

   added a commit that references this issue on Oct 27, 2025

   Disable vulkan X11 support when building for minimal linux (#176697)

   ...

   This issue will close once commit b28c40c is merged into the 'master' branch.

   b28c40c
8. auto-submit

   closed this as completedin #176697on Oct 27, 2025
9. tirth-patel-nc

   added

   r: fixedIssue is closed as already fixed in a newer versionIssue is closed as already fixed in a newer version

   on Oct 28, 2025
10. flutter-zl

    added a commit that references this issue on Oct 31, 2025

    Disable vulkan X11 support when building for minimal linux (#176697)

    ...

    This issue will close once commit 6425def is merged into the 'master' branch.

    6425def
11. github-actions commented on Nov 11, 2025

    

    github-actionsbot

    on Nov 11, 2025 – with GitHub Actions

    More actions

    This thread has been automatically locked since there has not been any recent activity after it was closed. If you are still experiencing a similar issue, please open a new bug, including the output of flutter doctor -v and a minimal reproduction of the issue.
12. github-actions

    locked as resolved and limited conversation to collaborators on Nov 11, 2025
13. reidbaker

    added a commit that references this issue on Dec 10, 2025

    Disable vulkan X11 support when building for minimal linux (flutter#1…

    ...

    This issue will close once commit a7d46ef is merged into the 'master' branch.

    a7d46ef