如何向QBS项目添加已编译的Qt.charts模块？

针对交叉编译Qt环境下QBS识别不了已编译好的Qt.charts模块（qmake可正常使用）的情况，按以下步骤排查解决：

• 确认Qt.charts模块的安装完整性
  检查交叉编译的Qt目录下是否存在charts相关文件：

  • 库文件：libQt5Charts.so（动态库）或libQt5Charts.a（静态库），一般位于${QT_DIR}/lib路径下
  • 头文件：${QT_DIR}/include/QtCharts目录及内部完整的头文件
  • 模块配置：${QT_DIR}/lib/cmake/Qt5Charts下的CMake配置文件，或${QT_DIR}/mkspecs/modules/qt_lib_charts.pri文件
    若上述文件缺失，需重新编译安装Qt.charts模块。

• 指定QBS使用的交叉编译Qt路径
  QBS可能未自动关联到交叉编译的Qt环境，需手动指定：

  1. 在QBS项目文件中添加Qt路径配置：

     Depends {
       name: "Qt";
       submodules: [
         "core", "gui", "network", "serialport", "widgets", "printsupport", "charts"
       ]
       // 替换为你的交叉编译Qt根目录
       Qt.core.qmakePrefixPath: "/opt/raspberrypi/qt"
     }
     

  2. 或者在构建时通过命令行传递环境变量：

     qbs build --set-env QT_DIR=/opt/raspberrypi/qt
     

• 手动补充charts模块的依赖配置
  如果QBS仍无法自动探测到模块，直接手动添加库和头文件路径：

  Depends { name: "Qt"; submodules: ["core", "gui", "network", "serialport", "widgets", "printsupport"] }
  // 添加charts的头文件路径
  cpp.includePaths: ["${Qt.core.qmakePrefixPath}/include/QtCharts"]
  // 添加charts的库路径
  cpp.libraryPaths: ["${Qt.core.qmakePrefixPath}/lib"]
  // 链接charts库（静态库必须添加，动态库可省略）
  cpp.staticLibraries: ["Qt5Charts"]
  

• 清理QBS缓存后重新构建
  旧缓存可能导致模块识别异常，执行以下命令后重新构建：

  qbs clean
  qbs build
  

• 检查QBS版本兼容性
  确保QBS版本与你的Qt版本兼容，比如Qt 5.15对应QBS 1.18及以上版本，若版本过低则升级QBS。

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