如何在Mac上为通用Linux设备套件添加Linux Qt版本以实现Qt5交叉编译

Great question—let’s break down your approach and explore better alternatives tailored to your setup.

你的初始方案是否可行？ #

Short answer: Yes, but with caveats that you’ll need to address to avoid headaches:

• Adding a Mac Qt version + manual CMake linking to Linux Qt
  • Qt’s core headers are mostly cross-platform consistent, but platform-specific headers (like qplatformdefs.h or low-level system integration headers) do differ between macOS and Linux. Using the Mac Qt’s headers directly could lead to subtle compilation errors that only show up when targeting Linux.
  • Qt Creator’s Designer relies on the local Qt library (the Mac one in this case). While most .ui files created with it will work on Linux, you’ll need to avoid macOS-exclusive widgets or properties (like NSView-specific tweaks) to prevent runtime issues on Linux.
• Manual CMake linking to sysroot Linux Qt
  • This part is solid, as long as you configure CMake correctly to point to your sysroot’s Qt installation. You’ll need to set CMAKE_SYSROOT to your case-sensitive volume path, and CMAKE_PREFIX_PATH to the Linux Qt’s module directory (e.g., /path/to/sysroot/home/crefrod/Qt5.10.0/5.10.0/gcc_64). This lets CMake auto-detect Qt modules and handle linking without manual target_link_libraries boilerplate.

更优方案：直接配置交叉编译Qt套件到Qt Creator #

You don’t need to rely on a Mac Qt installation at all—since you already have a complete Linux Qt in your sysroot, you can make Qt Creator recognize it as a cross-compiled Qt version. This leverages Qt Creator’s native Qt tooling support and eliminates the need for manual workarounds:

1. Add the cross-compiled Qt version to Qt Creator

   • Open Tools > Options > Kits > Qt Versions
   • Click Add, then browse to the qmake binary inside your sysroot: /path/to/sysroot/home/crefrod/Qt5.10.0/5.10.0/gcc_64/bin/qmake
   • Qt Creator will parse the Linux Qt’s configuration files (even on macOS) and add it as a valid Qt version.

2. Update your Generic Linux Device kit

   • Go back to the Kits tab and edit your existing Linux kit
   • Set the Qt Version dropdown to the cross-compiled Linux Qt you just added
   • Verify that Sysroot and cross-compiler paths are already correctly pointed to your setup (you mentioned this works for non-Qt projects, so this should be good)

3. Leverage native Qt tooling

   • With this setup, Qt Creator will automatically use the Linux Qt’s Qt5Config.cmake for CMake projects, so you won’t need to manually write library paths
   • Designer will still use Qt Creator’s local macOS Qt for previews, but as long as you stick to cross-platform Qt widgets, your .ui files will compile and run correctly on Linux. If you need exact Linux previews, you can run Designer on your Linux machine and use Qt Creator’s remote editing features to work with it.

关键注意事项 #

• Ensure your sysroot’s Linux Qt library version matches your cross-compiler’s GCC version (mismatched versions can cause linking errors or runtime crashes)
• For Linux deployment, set CMAKE_INSTALL_RPATH (or QMAKE_RPATH if using qmake) to point to the Qt library directory relative to your executable, or bundle the Qt .so files with your app using linuxdeployqt
• Double-check that all Qt modules you need (e.g., QtWidgets, QtNetwork) are present in your sysroot’s Qt installation

内容的提问来源于stack exchange，提问作者CreFroD