### 在 Windows 上为树莓派 Pi5 (Bookworm 系统) 搭建 QT5.15 交叉编译环境的详细步骤 为了在 Windows 平台上为树莓派 Pi5 (基于 Debian Bookworm 的操作系统) 构建一个完整的 QT5.15 交叉编译环境，可以按照以下详细的步骤进行操作。这些步骤涵盖了从工具链准备到最终项目的构建全过程。 #### 一、准备工作 确保主机系统满足基本需求： - 安装最新版本的 Visual Studio 或 MinGW 工具集。 - 准备足够的磁盘空间来存储工具链和编译后的库文件。 #### 二、下载并安装交叉编译工具链 选择适合 ARM64 架构的 GCC 工具链作为基础编译器集合。 1. **获取 Linaro Toolchain** 前往[Linaro官网](https://www.linaro.org/)下载最新的 AArch64 Linux GNU 工具链压缩包。例如 `gcc-linaro-7.5.0-2019.12-i686_aarch64-linux-gnu.tar.xz`。 2. **解压工具链至本地目录** 创建一个新的文件夹用于存放工具链，并将下载好的压缩包提取到这里面去。比如放置于 `C:\tools\gcc-linaro-aarch64` 中。 3. **更新 PATH 变量** 把刚才提到的那个 bin 子目录加入全局可访问路径列表里边儿。具体做法是在命令提示符窗口输入如下语句： ```cmd set PATH=C:\tools\gcc-linaro-aarch64\bin;%PATH% ``` #### 三、收集目标板所需的 sysroot 文件 Sysroot 是指代目标平台上所有的共享库及相关头文件的一个副本集合体，它允许我们模拟真实的运行时环境来进行软件开发。 1. **复制树莓派内部数据** 利用 SD 卡读卡器或者其他方式挂载已经刷入 Bookworm 映像的 microSD 卡，在其中找到 rootfs 所对应的分区，然后把它整体拷贝出来形成所谓的 sysroot 结构。 2. **整理成统一格式存档** 推荐采用 tarball 形式打包整个体系结构以便后续引用方便快捷些。假设我们的工作区位于 D:\workspace\rpi-sysroot，则执行下列指令完成封装动作： ```bash tar cvf rpi-sysroot.tar.gz d:/workspace/rpi-sysroot/ ``` #### 四、获取并调整 Qt 源码 接下来就是针对特定硬件平台重新编译 Qt 库本身的过程啦！ 1. **克隆官方仓库或直接下载预编译包** 转向 [Qt Downloads Page](https://download.qt.io/official_releases/qt/) 寻找对应标签下的完整源代码归档链接地址，这里选用的是 qt-everywhere-src-5.15.10.zip。 2. **修改 configure 参数适应当前场景** 根据之前所描述的内容组合出恰当形式化的配置串列。注意替换掉原有的绝对路径表达式使之更加贴近实际情况一些哦！以下是修正过的实例演示[^1]: ```cmd configure.bat ^ -release ^ -opengl es2 ^ -eglfs ^ -device linux-rasp-pi5-v3d-g++ ^ -device-option CROSS_COMPILE=C:\tools\gcc-linaro-aarch64\bin\aarch64-linux-gnu- ^ -sysroot D:\workspace\rpi-sysroot ^ -prefix C:\Qt\5.15.10\raspberry_pi_bookworm ^ -extprefix C:\Qt\5.15.10\raspberry_pi_bookworm_build ^ -opensource ^ -confirm-license ^ -skip qtscript ^ -skip qtwayland ^ -skip qtwebengine ^ -nomake examples ^ -nomake tests ^ -make libs ^ -pkg-config ^ -no-use-gold-linker ^ -v ``` #### 五、正式开始编译流程 当所有前期条件都布置妥当以后，终于迎来了激动人心的一刻——那就是让机器自行运转起来吧！ 1. **激活 Makefile 生产机制** 对于 MSVC 用户来说应当这样发起请求： ```cmd nmake ``` 若果你是 MinGW 支持者的话那么就得改成这个样子咯： ```cmd mingw32-make -j%NUMBER_OF_PROCESSORS% ``` 2. **落实成果落地计划** 成功熬过漫长的等待期之后紧接着便是收获季节了呀～只需简单一句就能搞定全部事情呢： ```cmd nmake install ``` --- 通过遵循上述详尽指导方针，相信您一定能够在自己的电脑上面建立起专属于 Raspberry Pi 5 设备使用的定制化 Qt Framework 啦～ --- ### 示例代码片段展示如何验证新创建的 QMake 功能正常运作情况 下面提供了一个简单的测试案例用来确认刚刚建立起来的新版 qmake 能否顺利运转： ```cpp #include <QApplication> #include <QPushButton> int main(int argc, char *argv[]) { QApplication app(argc, argv); QPushButton button("Hello Qt on RPI5!"); button.resize(200, 100); button.show(); return app.exec(); } ``` 保存以上内容为 `main.cpp` ，接着利用刚产生的 qmake 生成相应的 Makefiles 再加以制造即可得知一切设定皆符合预期标准与否。 ---