Qt ARM 交叉編譯環境配置指南：qmake 與 Qt Creator 關鍵設置

環境準備

• 主機：Linux x86_64（Ubuntu 推薦）。
• 工具鏈：arm-linux-gnueabihf-gcc（或對應版本）。
• 目標 Qt：qt-4.8.3-linux-arm 或 qt-5.x 交叉編譯版。

關鍵配置步驟

1. 設置環境變量（~/.bashrc 或構建腳本）：

   export PATH=$PATH:/opt/toolchain/bin
   export PATH=$PATH:/usr/local/qt-arm/bin
   export QMAKESPEC=/usr/local/qt-arm/mkspecs/qws/linux-arm-g++
   

2. 命令行驗證：

   qmake -project && qmake && make
   # 應調用 arm-linux-g++ 生成 ARM 可執行文件
   

3. Qt Creator 配置：
   • Qt Versions：添加 /usr/local/qt-arm/bin/qmake，版本名稱如 Qt-4.8.3-ARM。
   • Compilers：添加 GCC -> /opt/toolchain/bin/arm-linux-gnueabihf-g++。
   • Debuggers：添加 arm-linux-gnueabihf-gdb。
   • Kits：新建 Kit，關聯上述 Qt Version、Compiler、Debugger、Device（可選）。關鍵：Qt mkspec 必須指向交叉編譯規格（如 qws/linux-arm-g++），不可留空或指向宿主規格。

常見錯誤排查

• Cannot read qmake.conf：Kit 中 Qt Version 的 mkspec 路徑錯誤，檢查 QMAKESPEC 或 Kit 設置。
• 鏈接錯誤 libQtCore.so not found：目標板缺少 Qt 庫，需部署 sysroot 或配置 -rpath。
• 頭文件找不到：確認 INCLUDEPATH 包含交叉編譯 Qt 的 include 目錄。