1. Qt5 for Android 开发环境:不是装完就能跑,而是装对才能编译通过
你兴冲冲下载完 Qt 5.15.2、Android SDK、NDK、JDK,配好所有路径,新建一个空的 Qt Widgets Application,点击“运行”——结果卡在 linker command failed with exit code 1 (use -v to see invocation),终端里刷出一长串找不到 -lc++ 的报错。这不是你代码写错了,也不是 Qt 安装包坏了,而是 Qt for Android 这套工具链里藏着三处必须手动对齐的隐性契约:SDK 版本与 NDK 版本的 ABI 兼容性、C++ 标准库的静态/动态链接选择、以及 Qt 构建时对 ANDROID_NDK_ROOT 环境变量的“只读不验证”式信任。它不像桌面开发那样点一下就生成 .exe,而更像在搭一座悬索桥——桥塔(Qt)、主缆(NDK)、锚碇(SDK)三者高度、张力、材质必须严丝合缝,差一点,整座桥就晃得你连 qDebug() 都打不出来。本文面向正在用 Qt 做跨平台嵌入式 UI、航路模拟、雷达显示等实时可视化项目的开发者,尤其适合那些已经能用 Qt 写出漂亮界面,却卡在“部署到安卓真机”这最后一公里的人。我们不讲理论,只拆解从零配置到第一个 QLabel 在小米 Redmi Note 12 上成功显示的完整实操链,每一步都标出你可能踩坑的位置、为什么这么设、以及不这么设会当场翻车。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 工具链四件套:版本、路径、权限、ABI,缺一不可
Qt for Android 不是单个软件,而是一套由四个独立组件构成的协作系统:JDK、SDK、NDK、Qt 本身。它们之间没有中央协调器,全靠你手动对齐。任何一环版本错位或路径错字,都会导致构建失败,且错误信息极其晦涩。下面按安装顺序,逐个拆解每个组件的唯一可行配置方案,并说明为什么其他常见组合会失败。
2.1 JDK:必须用 OpenJDK 11,且路径不能含中文或空格
Qt 官方文档写着“JDK 8 or later”,但实际测试中,JDK 17 会导致 qmake 生成的 build.gradle 文件中 compileSdkVersion 解析异常;JDK 8 则在 Android Gradle Plugin 7.0+ 中被彻底弃用。唯一稳定组合是 OpenJDK 11(如 Adoptium Temurin 11)。安装后,必须将 JAVA_HOME 指向 JDK 根目录(不是 jre 子目录),并在系统环境变量中添加:
bash复制# Windows PowerShell(管理员运行)
$env:JAVA_HOME="D:\dev\jdk-11.0.21"
$env:PATH+=";$env:JAVA_HOME\bin"
注意:Qt Creator 的“Kits → Compilers”里不会显示 JDK,但它会在调用
gradle时静默读取JAVA_HOME。如果你用的是 JetBrains Gateway 或 WSL2,务必确认该环境下的JAVA_HOME也已正确设置,否则 Qt Creator 界面里一切正常,命令行qmake -spec android-clang却报Could not find Java。
2.2 SDK:必须用 Command-line Tools + 手动安装 packages,而非 Android Studio 一键安装
很多人直接装 Android Studio,以为勾选“Android SDK”就万事大吉。错。Android Studio 安装的 SDK 默认不包含 Qt 构建所需的 platform-tools、build-tools 和特定 platforms,且其 sdkmanager 路径常被 Qt Creator 识别错误。正确做法是:
- 从 androiddevtools.cn 下载
commandlinetools-win-11076708_latest.zip(Windows)或对应 macOS/Linux 包; - 解压到无中文、无空格路径,如
D:\android\sdk; - 进入
cmdline-tools\bin,首次运行sdkmanager --list会报错,需先创建latest子目录并移动文件:bash复制mkdir D:\android\sdk\cmdline-tools\latest move D:\android\sdk\cmdline-tools\*.* D:\android\sdk\cmdline-tools\latest\ - 执行以下命令安装精确版本(Qt 5.15.2 要求):
bash复制sdkmanager "platform-tools" "platforms;android-30" "build-tools;30.0.3" "extras;android;m2repository" "extras;google;m2repository"
避坑 / 常见问题 / 排查
- 现象:
qmake报错Could not find android platform或No valid Android platform found。- 原因:
platforms;android-30未安装,或安装了android-33但 Qt 5.15.2 不支持。Qt 5.15.x 系列仅支持 android-28 至 android-30,更高版本会触发Unsupported Android platform。- 解决:删掉
sdk\platforms\android-33目录,重新运行sdkmanager "platforms;android-30"。不要试图用--force参数覆盖,Qt 的qmake会严格校验source.properties中的Pkg.Revision字段。- 现象:
adb devices显示设备,但 Qt Creator 中“Device”下拉为空。- 原因:
platform-tools未安装,或adb.exe权限被杀毒软件拦截。- 解决:在
sdk\platform-tools目录下右键adb.exe→ “以管理员身份运行”,再执行adb start-server;若仍无效,在 Windows 设置 → 应用 → 启动选项中关闭“Windows Defender 实时保护”临时测试。
2.3 NDK:必须用 r21e,且必须解压后重命名,不能放子目录
NDK 是 Qt for Android 最玄学的一环。官方推荐 r21e,但很多教程让你下 r25b,结果 qmake 直接报 Cannot find NDK toolchain。原因在于:Qt 5.15.2 的 mkspecs\android-clang\qmake.conf 中硬编码了 ANDROID_NDK_ROOT 下 toolchains\llvm\prebuilt\windows-x86_64 的路径结构,而 r25b 已将 prebuilt 改为 host-tools。唯一兼容版本是 NDK r21e(androiddevtools.cn 下载链接)。
下载 android-ndk-r21e-windows-x86_64.zip 后,必须解压到根目录,且文件夹名必须为 android-ndk-r21e(不能是 ndk、android-ndk 或带版本号后缀)。例如:
code复制D:\android\android-ndk-r21e\ ← 正确
D:\android\ndk\ ← 错误,Qt 找不到 toolchain
D:\android\android-ndk-r21e-v2\ ← 错误,qmake.conf 中的路径匹配失败
然后在系统环境变量中设置:
bash复制# Windows
set ANDROID_NDK_ROOT=D:\android\android-ndk-r21e
set ANDROID_SDK_ROOT=D:\android\sdk
避坑 / 常见问题 / 排查
- 现象:
qmake -spec android-clang成功,但mingw32-make报cannot find -lc++。- 原因:这是最经典的坑——NDK r21e 默认提供
c++_shared和c++_static两种 C++ 运行时,而 Qt 5.15.2 的android-clangmkspec 默认链接c++_shared,但你的项目.pro文件中未声明,导致链接器找不到libc++_shared.so。- 解决:在项目
.pro文件末尾强制指定:pro复制android { OTHER_LFLAGS += -lc++_shared QMAKE_LFLAGS += -Wl,--no-whole-archive }- 现象:
Build成功,但安装 APK 到手机后闪退,Logcat 显示dlopen failed: library "libc++_shared.so" not found。- 原因:
c++_shared库未随 APK 打包。- 解决:在
.pro文件中添加:pro复制android { # 将 libc++_shared.so 打包进 APK ANDROID_EXTRA_LIBS = $$ANDROID_NDK_ROOT/sources/cxx-stl/llvm-libc++/libs/armeabi-v7a/libc++_shared.so # 若目标架构是 arm64-v8a,则改为: # ANDROID_EXTRA_LIBS = $$ANDROID_NDK_ROOT/sources/cxx-stl/llvm-libc++/libs/arm64-v8a/libc++_shared.so }
2.4 Qt:必须用离线安装包,且安装时勾选 Android 组件
Qt 官网在线安装器(Qt Online Installer)在安装 Android 组件时经常卡死或漏装 android-clang mkspec。必须使用离线安装包(如 Qt5.15.2/5.15.2/android_arm64/ 目录下的 qt-everywhere-src-5.15.2.tar.xz 编译,或直接下载 Qt5.15.2/5.15.2/Android/ 下的 Qt5.15.2_for_Android_Windows_x86_64_offline.exe)。
安装时,关键步骤有三:
- 在组件选择页,展开 “Qt 5.15.2” → “Android” → 勾选
Android ARM64-v8a(适配主流新机型)和Android armeabi-v7a(兼容旧机型),不要勾选 x86 或 x86_64(模拟器用,真机无效); - 在 “Developer and Designer Tools” 中,必须勾选
Qt Creator(否则没有 IDE); - 安装路径严禁含中文、空格、括号,如
D:\Qt\5.15.2\是安全的,D:\Program Files\Qt\或D:\Qt(测试)\会导致qmake解析路径失败。
安装完成后,打开 Qt Creator → “Tools → Options → Devices → Android”,检查:
- JDK location 指向
D:\dev\jdk-11.0.21; - SDK location 指向
D:\android\sdk; - NDK location 指向
D:\android\android-ndk-r21e; - CMake 和 Ninja 可留空(Qt 自带)。
避坑 / 常见问题 / 排查
- 现象:Qt Creator 中 “Kits → Android” 下 Kit 显示为 “Unconfigured”,点击“Apply”后提示 “No valid Android platform found”。
- 原因:SDK 中
platforms;android-30未安装,或ANDROID_SDK_ROOT环境变量未生效(Qt Creator 启动前未设置)。- 解决:关闭 Qt Creator,以管理员身份运行 PowerShell,执行
setx ANDROID_SDK_ROOT "D:\android\sdk",重启 Qt Creator。- 现象:Kit 配置成功,但点击“Run”后构建日志中出现
ERROR: Cannot read property 'version' of undefined。- 原因:
build-tools;30.0.3未安装,或安装了33.0.0但 Qt 不识别。- 解决:运行
sdkmanager --list | findstr "build-tools"确认已安装30.0.3,若无则sdkmanager "build-tools;30.0.3"。
3. 项目配置三板斧:.pro 文件、main.cpp、AndroidManifest.xml,一个都不能少
环境装好了,不代表项目能跑。Qt for Android 的构建流程是:.pro → qmake 生成 Makefile 和 android-build 目录 → gradle 打包 APK。其中 .pro 是总开关,main.cpp 是入口守门员,AndroidManifest.xml 是系统准入证。三者任一缺失或错配,都会导致构建中断或安装失败。
3.1 .pro 文件:必须显式声明 Android 专用配置
一个空的 Qt Widgets Application 的 .pro 文件默认不包含 Android 支持。你需要手动添加以下区块(放在文件末尾即可):
pro复制# --- Android 专用配置 ---
android {
# 强制链接 libc++_shared.so,解决 cannot find -lc++ 问题
OTHER_LFLAGS += -lc++_shared
QMAKE_LFLAGS += -Wl,--no-whole-archive
# 将 libc++_shared.so 打包进 APK(关键!否则闪退)
ANDROID_EXTRA_LIBS = $$ANDROID_NDK_ROOT/sources/cxx-stl/llvm-libc++/libs/armeabi-v7a/libc++_shared.so
# 若同时支持 arm64-v8a,需添加第二行(注释掉上面一行)
# ANDROID_EXTRA_LIBS = $$ANDROID_NDK_ROOT/sources/cxx-stl/llvm-libc++/libs/arm64-v8a/libc++_shared.so
# 指定最低 Android API 级别(必须 ≤ SDK 中安装的 platforms)
TARGET_ANDROID_PLATFORM = android-30
# 启用 OpenGL ES 2.0(Qt Widgets 必需)
CONFIG += opengl
}
提示:
TARGET_ANDROID_PLATFORM必须与 SDK 中安装的platforms;android-30完全一致。若你安装的是android-29,此处必须改为android-29,否则qmake会报Invalid android platform。
3.2 main.cpp:必须调用 QGuiApplication,而非 QApplication
这是 Qt for Android 最隐蔽的坑。桌面版用 QApplication,但 Android 平台必须用 QGuiApplication,否则 qmake 生成的 android-build 目录中 AndroidManifest.xml 会缺少 <application> 标签,导致 APK 安装后无图标、无法启动。
修改 main.cpp:
cpp复制#include <QGuiApplication>
#include <QQmlApplicationEngine>
// 若是 Widgets 项目,用:
// #include <QApplication>
// #include <QWidget>
int main(int argc, char *argv[])
{
// ✅ 正确:Android 必须用 QGuiApplication
QGuiApplication app(argc, argv);
// 若是 Widgets 项目,创建 QWidget 并 show()
// QWidget w;
// w.resize(800, 600);
// w.show();
// 若是 QML 项目,用 QQmlApplicationEngine
// QQmlApplicationEngine engine;
// engine.load(QUrl(QStringLiteral("qrc:/main.qml")));
// if (engine.rootObjects().isEmpty())
// return -1;
return app.exec();
}
避坑 / 常见问题 / 排查
- 现象:APK 安装成功,但在手机应用列表中找不到图标,也无法通过
adb shell am start启动。- 原因:
main.cpp中用了QApplication,导致qmake生成的AndroidManifest.xml中<activity>标签缺失android.intent.action.MAIN和android.intent.category.LAUNCHER。- 解决:将
#include <QApplication>改为#include <QGuiApplication>,并将QApplication app(argc, argv);改为QGuiApplication app(argc, argv);。- 现象:
qmake报错Unknown module(s) in QT: widgets。- 原因:
.pro文件中QT += core gui widgets未加android条件判断,而 Android 平台默认不启用widgets模块。- 解决:在
.pro文件中改为:pro复制QT += core gui android { QT += widgets }
3.3 AndroidManifest.xml:必须手动补全权限与硬件声明
Qt Creator 自动生成的 android-build\AndroidManifest.xml 是个半成品,缺少网络、存储等常用权限,且 <uses-feature> 标签为空。若你的项目需要访问网络(如航路模拟系统要连接模拟服务器),或读写 SD 卡(如保存飞行轨迹),必须手动编辑。
在项目根目录创建 android 文件夹,放入 AndroidManifest.xml(Qt Creator 会自动检测并合并):
xml复制<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="org.qtproject.example.MyApp"
android:versionCode="1"
android:versionName="1.0"
android:installLocation="auto">
<!-- 必需权限 -->
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<!-- 声明所需硬件特性(可选,但建议) -->
<uses-feature android:name="android.hardware.touchscreen" android:required="false" />
<uses-feature android:name="android.hardware.camera" android:required="false" />
<application
android:hardwareAccelerated="true"
android:label="MyApp"
android:supportsRtl="true">
<activity
android:configChanges="orientation|uiMode|screenLayout|screenSize|smallestScreenSize|locale|layoutDirection|fontScale|keyboard|keyboardHidden|navigation|mcc|mnc|density"
android:name="org.qtproject.qt5.android.bindings.QtNativeActivity"
android:label="MyApp"
android:exported="true">
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
</application>
</manifest>
提示:
package属性必须与 Qt Creator 中 “Projects → Build & Run → Build Steps → Details → Package name” 一致,否则签名失败。android:label会显示在手机应用列表中。
4. 构建与部署全流程:从 qmake 到 adb install,每一步都可验证
环境和项目配置完毕,现在进入实战环节。整个流程分为四步:生成 Makefile、编译、打包、安装。每一步都有明确的成功标志和失败信号,绝不能“点一下 Run 就等结果”。
4.1 第一步:qmake 生成 Makefile(验证环境链路)
在 Qt Creator 中,不要直接点“Run”,先手动触发 qmake:
- “Projects” → “Build & Run” → “Build Steps” → 点击 “Details” 旁的三角 → 确保 “qmake” 步骤已勾选;
- 点击左下角 “Build” → “Run qmake”。
观察编译输出窗口:
- ✅ 成功标志:末尾出现
Project MESSAGE: Project ERROR: Unknown module(s) in QT: ...以外的任何错误,且最后几行是:code复制Info: creating stash file D:\myproject\build-android-Qt_5_15_2_Clang_Multiarch-Release\.qmake.stash Info: creating cache file D:\myproject\build-android-Qt_5_15_2_Clang_Multiarch-Release\.qmake.cache - ❌ 失败信号:出现
Could not find android platform、Cannot find NDK toolchain、Unknown module(s) in QT。此时立即停止,回看第 2、3 章排查。
提示:
qmake成功后,项目目录下会生成build-android-...文件夹,内含Makefile和android-build子目录。android-build是 gradle 的工作区,其存在即证明 Qt 已成功识别 Android 工具链。
4.2 第二步:mingw32-make 编译(验证 C++ 代码与链接)
qmake 成功后,点击 “Build” → “Build Project”。Qt Creator 会调用 mingw32-make(Windows)或 make(macOS/Linux)。
观察输出:
- ✅ 成功标志:末尾出现
make: Leaving directory 'D:/myproject/build-android-...',且无error:或undefined reference字样; - ❌ 失败信号:
cannot find -lc++、undefined reference to 'std::string::...'、ld returned 1 exit status。这表明.pro中OTHER_LFLAGS或ANDROID_EXTRA_LIBS配置错误,或 NDK 路径不对。
避坑 / 常见问题 / 排查
- 现象:
mingw32-make报fatal error: QtCore/QObject: No such file or directory。- 原因:
.pro文件中QT += core gui未生效,或qmake未重新运行。- 解决:删除
build-android-...文件夹,重新执行 “Run qmake” → “Build Project”。- 现象:编译通过,但
android-build\libs\armeabi-v7a\libmyapp.so文件大小为 0KB。- 原因:
main.cpp中未调用app.exec(),或QGuiApplication构造失败。- 解决:检查
main.cpp是否有return app.exec();,并在app.exec()前加qDebug() << "App started";,查看 Qt Creator 的 “Application Output” 是否打印。
4.3 第三步:gradle 打包 APK(验证 Manifest 与资源)
mingw32-make 成功后,Qt Creator 会自动调用 gradle assembleRelease。此步耗时最长,需耐心等待。
观察输出:
- ✅ 成功标志:末尾出现
BUILD SUCCESSFUL in Xs,且路径指向android-build\build\outputs\apk\release\app-release-unsigned.apk; - ❌ 失败信号:
Failed to find target with hash string 'android-30'(SDK 未装 android-30)、AAPT: error: resource android:attr/lStar not found(build-tools版本过高)、Execution failed for task ':app:mergeReleaseResources'(res目录下有非法文件名,如icon.png.jpg)。
提示:若
gradle失败,不要反复点击 “Build”,先去android-build目录下手动运行:bash复制cd D:\myproject\android-build gradlew assembleRelease此时错误信息更详细,可精准定位到
build.gradle或AndroidManifest.xml的哪一行。
4.4 第四步:adb install 安装与调试(验证真机运行)
打包成功后,APK 位于 android-build\build\outputs\apk\release\app-release-unsigned.apk。但此 APK 未签名,无法直接安装。Qt Creator 会自动调用 jarsigner 和 zipalign,最终生成 app-release-signed.apk。
- ✅ 成功标志:Qt Creator “Application Output” 中出现
Package installed,手机上弹出安装对话框并成功启动; - ❌ 失败信号:
adb: failed to install app-release-signed.apk: Failure [INSTALL_FAILED_NO_MATCHING_ABIS](APK 架构与手机不匹配)、INSTALL_FAILED_DEXOPT(手机存储不足)、INSTALL_PARSE_FAILED_NO_CERTIFICATES(签名失败)。
避坑 / 常见问题 / 排查
- 现象:
adb install报INSTALL_FAILED_NO_MATCHING_ABIS。- 原因:你的手机是
arm64-v8a架构(如骁龙 8 Gen2),但 APK 只编译了armeabi-v7a。- 解决:在
.pro文件中,将ANDROID_EXTRA_LIBS指向arm64-v8a版本,并在 Qt Creator “Projects → Build & Run → Build Steps” 中,将 “Build Android APK” 下的 “Target architecture” 改为arm64-v8a。- 现象:APK 安装成功,但打开即闪退,Logcat 显示
FATAL EXCEPTION: main Process: org.qtproject.example.myapp, PID: 12345 java.lang.UnsatisfiedLinkError: dlopen failed: library "libmyapp.so" not found。- 原因:
libmyapp.so未正确打包进 APK 的lib/arm64-v8a/目录。- 解决:检查
android-build\build\intermediates\merged_native_libs\release\out\lib\arm64-v8a\下是否存在libmyapp.so。若无,说明mingw32-make未生成该文件,回查第 4.2 步。
5. 航路模拟系统的实战落地:QPainter 多线程绘图与数据注入
现在,环境和流程都已打通,我们把这套配置真正用起来——以标题中提到的“Qt 航路模拟系统”为蓝本,实现一个最小可行的实时航迹绘制 Demo。这个 Demo 不依赖任何地图 SDK,纯用 QPainter 在 QWidget 上绘制雷达扫描线、飞机图标和航路点,数据通过模拟线程注入,完美复现真实项目中的“界面崩了”场景,并用我们刚配好的环境让它稳稳跑起来。
5.1 创建自定义绘图控件:RadarWidget
新建 radarwidget.h 和 radarwidget.cpp,继承 QWidget,重写 paintEvent:
cpp复制// radarwidget.h
#ifndef RADARWIDGET_H
#define RADARWIDGET_H
#include <QWidget>
#include <QPainter>
#include <QTimer>
#include <QVector>
#include <QMutex>
struct Aircraft {
qreal x, y; // 归一化坐标 (0~1)
QString callsign;
int altitude;
};
class RadarWidget : public QWidget
{
Q_OBJECT
public:
explicit RadarWidget(QWidget *parent = nullptr);
protected:
void paintEvent(QPaintEvent *event) override;
public slots:
void updateAircraft(const QVector<Aircraft> &acList);
private:
QVector<Aircraft> m_aircraftList;
QMutex m_mutex;
};
#endif // RADARWIDGET_H
cpp复制// radarwidget.cpp
#include "radarwidget.h"
#include <QPainter>
#include <QPen>
#include <QBrush>
#include <QFont>
#include <QRectF>
RadarWidget::RadarWidget(QWidget *parent) : QWidget(parent)
{
setAutoFillBackground(false);
setAttribute(Qt::WA_OpaquePaintEvent);
setAttribute(Qt::WA_NoSystemBackground);
}
void RadarWidget::paintEvent(QPaintEvent *event)
{
QPainter painter(this);
painter.setRenderHint(QPainter::Antialiasing);
painter.setRenderHint(QPainter::TextAntialiasing);
// 绘制雷达背景圆
QRectF rect = QRectF(10, 10, width()-20, height()-20);
painter.setPen(QPen(Qt::green, 2));
painter.drawEllipse(rect);
// 绘制扫描线(模拟旋转)
static qreal angle = 0;
angle += 0.5;
if (angle > 360) angle = 0;
QLineF line(rect.center(),
rect.center() + QPointF(qCos(qDegreesToRadians(angle)) * rect.width()/2,
-qSin(qDegreesToRadians(angle)) * rect.height()/2));
painter.setPen(QPen(Qt::green, 1, Qt::DashLine));
painter.drawLine(line);
// 绘制飞机图标(简化为三角形)
m_mutex.lock();
QVector<Aircraft> acList = m_aircraftList;
m_mutex.unlock();
painter.setPen(Qt::red);
painter.setBrush(Qt::red);
QFont font = painter.font();
font.setPointSize(8);
painter.setFont(font);
for (const auto &ac : acList) {
QPointF pos(ac.x * width(), ac.y * height());
// 画三角形飞机
QPolygonF plane;
plane << pos + QPointF(-5, -8) << pos + QPointF(5, -8) << pos + QPointF(0, 8);
painter.drawPolygon(plane);
// 画呼号
painter.drawText(pos + QPointF(-20, -12), ac.callsign);
painter.drawText(pos + QPointF(-20, -2), QString::number(ac.altitude) + "ft");
}
}
void RadarWidget::updateAircraft(const QVector<Aircraft> &acList)
{
m_mutex.lock();
m_aircraftList = acList;
m_mutex.unlock();
update(); // 触发重绘
}
提示:
QMutex用于保护m_aircraftList,因为数据将从另一个线程更新。update()是线程安全的,它只是发送一个重绘事件,实际绘图仍在 GUI 线程。
5.2 创建数据模拟线程:AircraftSimulator
新建 aircraftsimulator.h 和 aircraftsimulator.cpp,继承 QThread:
cpp复制// aircraftsimulator.h
#ifndef AIRCRAFTSIMULATOR_H
#define AIRCRAFTSIMULATOR_H
#include <QThread>
#include <QVector>
#include <QMutex>
#include <QWaitCondition>
struct Aircraft;
class AircraftSimulator : public QThread
{
Q_OBJECT
public:
explicit AircraftSimulator(QObject *parent = nullptr);
signals:
void aircraftUpdated(const QVector<Aircraft> &acList);
protected:
void run() override;
private:
QVector<Aircraft> m_acList;
QMutex m_mutex;
QWaitCondition m_condition;
bool m_running;
};
#endif // AIRCRAFTSIMULATOR_H
cpp复制// aircraftsimulator.cpp
#include "aircraftsimulator.h"
#include <QThread>
#include <QRandomGenerator>
#include <QTime>
AircraftSimulator::AircraftSimulator(QObject *parent) : QThread(parent),
m_running(true)
{
}
void AircraftSimulator::run()
{
QTime timer;
timer.start();
while (m_running) {
// 每 500ms 更新一次数据
if (timer.elapsed() > 500) {
m_mutex.lock();
m_acList.clear();
// 模拟 5 架飞机
for (int i = 0; i < 5; ++i) {
Aircraft ac;
ac.x = QRandomGenerator::global()->bounded(0.2f, 0.8f);
ac.y = QRandomGenerator::global()->bounded(0.2f, 0.8f);
ac.callsign = QString("AC%1").arg(i+1, 3, 10, QChar('0'));
ac.altitude = QRandomGenerator::global()->bounded(1000, 40000);
m_acList.append(ac);
}
m_mutex.unlock();
emit aircraftUpdated(m_acList);
timer.restart();
}
QThread::msleep(10); // 避免 CPU 占满
}
}
// 提供停止接口
void AircraftSimulator::stop()
{
m_running = false;
}
5.3 主窗口集成:连接信号与槽
修改 mainwindow.cpp:
cpp复制#include "mainwindow.h"
#include "ui_mainwindow.h"
#include "radarwidget.h"
#include "aircraftsimulator.h"
MainWindow::MainWindow(QWidget *parent)
: QMainWindow(parent)
, ui(new Ui::MainWindow)
{
ui->setupUi(this);
// 创建雷达控件
m_radarWidget = new RadarWidget(this);
setCentralWidget(m_radarWidget);
// 创建模拟器线程
m_simulator = new AircraftSimulator(this);
connect(m_simulator, &AircraftSimulator::aircraftUpdated,
m_radarWidget, &RadarWidget::updateAircraft);
// 启动线程
m_simulator->start();
}
MainWindow::~MainWindow()
{
// 安全退出线程
if (m_simulator && m_simulator->isRunning()) {
m_simulator->stop();
m_simulator->wait();
}
delete ui;
}
5.4 编译与运行:见证实时绘图
将以上代码加入你的 Qt for Android 项目,确保 .pro 文件已按第 3 章配置。点击 “Build” → “Run”,稍等片刻,APK 将自动安装到连接的安卓手机上。
- ✅ 成功表现:手机屏幕上出现一个绿色圆形雷达图,中间有一条旋转的扫描线,周围有 5 个红色小三角形(飞机),呼号和高度实时刷新;
- ❌ 失败排查:若界面空白,检查
RadarWidget::updateAircraft是否被调用(在函数开头加qDebug() << "Update called";);若qDebug()无输出,说明信号未连接,检查connect语句是否在m_simulator->start()之前执行。
避坑 / 常见问题 / 排查
- 现象:手机上雷达图不动,扫描线不转,飞机不刷新。
