一、开发环境搭建（基于Qt 6.4+）
1. 基础工具链配置
需安装 _Qt Maintenance Tool_ 与 _Android Studio_，并通过`sdk_definitions.json`文件指导安装SDK组件。关键工具包包括：
2. IDE配置流程
| 配置项 | Qt Creator路径 | Android Studio路径 |
| JDK路径 | 首选项→设备→Android | SDK Manager→JDK Location |
| SDK路径 | 同上 | 默认`C:Users[用户]AppDataLocalAndroidSdk` |
| 设备模拟器 | 需通过Android Device Manager创建ABI兼容设备（建议选择x86_64架构） |
3. 常见问题解决方案
二、核心功能架构解析
1. 跨平台UI框架
2. 本地服务调用
| 功能类型 | 实现方式 | 示例代码片段 |
| 传感器访问 | 通过`QtSensors`模块 | `QAccelerometer sensor = new QAccelerometer(this);` |
| 文件系统 | 使用`QStandardPaths`类 | `QString docsPath = QStandardPaths::writableLocation(QStandardPaths::DocumentsLocation);` |
| 摄像头控制 | `QCamera`与`QMediaDevices`配合 | `QCamera camera = new QCamera(QMediaDevices::defaultVideoInput);` |
3. JNI交互机制
cpp
QAndroidJniObject id = QAndroidJniObject::callStaticObjectMethod(
android/os/Build", "MODEL", "Ljava/lang/String;");
cpp
QAndroidJniObject::callStaticMethod
android/widget/Toast", "makeText",
(Landroid/content/Context;Ljava/lang/CharSequence;I)Landroid/widget/Toast;",
QtAndroid::androidActivity.object,
QAndroidJniObject::fromString("Hello Qt").object, 1);
三、版本兼容性对照表
| Qt版本 | NDK版本 | Build Tools | 支持API Level |
| 6.4+ | 23.1 | 31.0.0 | 31 |
| 6.2-6.3| 22.1 | 31.0.0 | 30 |
| 5.15 | 21.3 | 28.0.2 | 28 |
| 5.12 | 19.2 | 28.0.2 | 26 |
四、部署注意事项
1. 权限声明：需在`AndroidManifest.xml`中显式声明权限，如摄像头使用需添加：
xml
2. APK签名：推荐使用Android Studio生成jks密钥库，Qt Creator中配置签名路径：
Build Steps→Build Android APK→Sign Package→Keystore
3. 性能优化：启用`-no-warnings-are-errors`编译选项，关闭RTTI和异常处理以减小包体积
五、调试技巧
热重载：Qt Creator 12+支持修改QML文件后通过`Ctrl+R`实时刷新界面