支持的目标设备和开发主机 教程：使用 Boot to Qt 部署您的第一个项目

C

树莓派 4 快速开始指南

Qt 提供了设计、开发、构建和在目标设备上部署您应用程序所必需的所有工具。

本指南描述了如何使用 Qt 工具的图形界面在树莓派 4 设备上开发 Linux 应用程序。它描述了整个过程，并提供了以下任务的逐步说明

  • 使用 Qt 设计工作室 设计一个简单的 UI。
  • 在 Qt Creator 中创建一个项目，并利用为树莓派 4 设备预制的 Boot to Qt 镜像。
  • 在目标硬件上构建和调试项目。

注意：Qt for Device Creation 需要许可证。如果您没有，可以请求一个 免费试用。

概述

以下示意图说明了使用 Qt 工具和 Boot to Qt 软件栈进行软件开发的基本概念。

  • 开发主机 是运行于 Windows、Linux 或 macOS 上的开发计算机，上面安装了 Qt 工具。
  • Qt 工具 包括 Qt Creator 和 Qt 设计工作室等开发工具，以及 Squish 等质量保证 (QA) 工具。
  • QBSP SDK 包含一个集成到 Qt Creator 中的交叉编译工具链，以及可以用于使用 Boot to Qt 软件栈启动您的设备的设备镜像。
  • 目标设备 是运行嵌入式 Linux 应用程序的开发目标。
  • 上传和调试应用程序（通过以太网、Wi-Fi 或 USB）。使用 Qt Creator 在目标设备上上传和调试您的应用程序。
  • 闪光 QBSP 镜像 表示安装 Linux 到目标设备的方法（如 SD 卡）。

适用的树莓派目标设备

本指南中的说明适用于树莓派 4 目标设备。

注意：有关支持的目标设备和开发主机的更多详细信息，请参阅 支持的目标设备和开发主机。

安装 Qt

按照本指南中的程序，获取所需的所有资源，包括 Qt Creator 和 Qt 设计工作室。

  1. 登录到 Qt 客户门户 下载 Qt 在线安装器。
  2. 安装程序适用于以下主机
    • ARM架构上的Linux
    • Linux x86
    • macOS
    • Windows

    下载适用于您主机的安装程序包。

  3. 打开安装程序。
  4. 转到安装文件夹并选择自定义安装。
  5. 选择下一步。
  6. 在选择组件中，选择Qt 6.7.2。所需的开发者和设计工具（例如Qt Creator和Qt Design Studio）在安装程序中已预先选中。
  7. 选择下一步。
  8. 转到准备安装并选择安装。

注：如果您已经安装了Qt，请使用Qt维护工具安装缺少的工具。

使用Qt维护工具安装Boot to Qt软件堆栈

要为Raspberry Pi 4安装Boot to Qt软件堆栈，请执行以下操作

  1. 打开Qt维护工具。
  2. 转到选择组件并打开顶级Boot to Qt软件堆栈下拉菜单。
  3. 打开针对正确Qt发行版的Boot to Qt软件堆栈下拉菜单。
  4. 选择Raspberry Pi 4。
  5. 转到准备更新并选择更新。

在目标设备上安装Boot to Qt

在您可以在目标设备上测试您的Qt应用程序之前，您必须使用包含Boot to Qt软件堆栈的镜像闪存目标设备。安装成功后，在设备开机时，Boot to Qt Demo Launcher将显示在屏幕上。

将Boot to Qt镜像刷写至microSD卡

Boot to Qt镜像包含Raspberry Pi 4设备的Boot to Qt软件堆栈。按照以下方式将镜像刷写至microSD卡

  1. 将一张microSD卡插入您的宿主机PC。
  2. 打开Qt Creator。
  3. 选择工具 > 刷写Boot to Qt设备。
  4. 选择下一步。

将镜像刷写至microSD卡后，将该卡插入您的目标硬件，并开启您的设备。

Raspberry Pi 4设备默认以Boot to Qt Demo Launcher应用程序启动。如果您想检查设备的IP地址，请打开通过Boot to Qt Demo Launcher开始使用Boot to Qt。如果设备连接到以太网或Wi-Fi网络，或者通过USB OTG连接到宿主机，则会显示IP地址。

设备设置

Boot to Qt设备可以通过USB、以太网或Wi-Fi连接。下面的部分提供了使用USB、以太网或Wi-Fi连接设置设备的说明。

通过USB设置设备

目标设备可以通过USB On-the-Go (OTG)连接到宿主机。通过USB网络连接后，设备将自动添加到Qt Creator中的设备。

目标设备对USB的访问支持两种不同的USB协议。当连接到Linux或Windows宿主机时，默认的RNDIS协议可用。当您想将目标设备连接到macOS宿主机时，需要切换到CDC-ECM协议。

注：您可以从“通过Boot to Qt开始”中更改协议。

有关通过USB连接设备的更多信息，请参阅在目标设备上设置USB以太网。

通过以太网或Wi-Fi设置设备

目标设备可以通过以太网或Wi-Fi连接到网络。目标设备连接并具有IP地址后，您可以按照以下步骤将其设置为Qt Creator

  1. 打开Qt Creator。
  2. 选择编辑 > 首选项。
  3. 在首选项窗口中
    1. 选择设备。
    2. 选择添加 > Boot2Qt 设备 > 启动向导。
  4. 在Boot2Qt 网络设备设置窗口中
    1. 输入设备名称。
    2. 输入设备地址（Raspberry Pi 4设备的IP地址）。
    3. 选择完成。
  5. 在设备选项卡中
    • 选择确定。

注意：您也可以从Boot to Qt入门设置Wi-Fi连接。

注意：Qt Creator通过IP网络上传应用程序，因此Raspberry Pi 4设备必须与您的开发主机PC在同一个网络中。

在Qt Design Studio中创建应用程序UI

您可以使用Qt Design Studio创建跨平台UI，包括嵌入式Linux应用程序。

  1. 打开Qt Design Studio。
  2. 选择创建项目。
  3. 在预设中，选择通用。
    • 命名您的项目（注意项目路径，以便用Qt Creator打开）。
    • 调整显示分辨率和方向以适应您的显示器。
  4. 确保您的目标Qt版本与您的机器上安装的Qt版本匹配。
  5. 选择创建。

现在您可以根据需要修改您的UI。一旦完成，选择全部保存以确保您可以在Qt Creator中打开您的UI项目。

在Qt Creator中配置和构建应用程序

  1. 打开Qt Creator。
  2. 导航到您使用Qt Design Studio创建的项目。
  3. 选择CMakeLists.txt以打开项目。
  4. 在配置项目窗口中
    • 选择您的Raspberry Pi 4套件。
    • 选择配置项目。

最后，选择构建 > 构建项目以构建您配置的项目。

在设备上运行应用程序

设置完您的设备后，您可以在Raspberry Pi 4设备上上传并启动应用程序。

  1. 打开Qt Creator。
  2. 选择文件 > 打开文件或项目。
  3. 导航到您之前配置的项目，并选择打开。
  4. 在项目窗口中
    • 如有必要，编辑运行设置。
    • 选择运行。

注意：要修改您的应用程序，您只需再次运行它即可简单地将其更新到设备上。

有关如何将Qt项目部署到设备的更多信息，请参阅教程：使用Boot to Qt部署您的第一个项目。

调试应用程序

有关使用Qt Creator调试应用程序的更多信息，请参阅调试。

故障排除

如果您遇到任何与Raspberry Pi 4设备相关的问题，例如如何通过串口连接进行调试，请转到Raspberry Pi 论坛获取更多信息。

有关如何解决Boot to Qt的更多问题，请参阅故障排除。

支持的目标设备和开发主机 教程：使用Boot to Qt部署您的第一个项目

在特定Qt许可下可用。
了解更多信息。