1. 环境准备：工具链与版本选择

第一次接触Qt for Android开发时，最让人头疼的就是各种工具的版本匹配问题。记得我刚开始配置环境时，因为NDK版本选错导致整整两天都在解决编译报错。为了避免大家重蹈覆辙，这里把Qt5.14.2所需的"黄金组合"整理出来：

• JDK 8u351：Oracle官方最后一个免费JDK8版本（下载路径：/technologies/downloads/#java8）
• Android SDK 26.1.1：对应Android 8.0 Oreo系统（国内镜像站：/androiddevtools.cn/）
• Android NDK r21e：Qt5.14.2官方适配的稳定版本（历史版本下载：/ndk/downloads/revision_history）

这三个工具的安装目录务必遵守两个铁律：全英文路径和无空格字符。我见过太多因为"D:\开发工具\JDK"这样的路径导致环境变量失效的案例。建议直接在磁盘根目录创建QtAndroid文件夹，所有组件都安装在这个目录下。

注意：Qt官方文档特别强调，Qt5系列不支持JDK11及以上版本。有次我偷懒装了JDK17，结果Qt Creator直接拒绝识别Java环境。

2. 环境变量配置实战

配置环境变量就像给操作系统画地图，告诉它去哪里找关键工具。Windows用户按Win+R输入sysdm.cpl打开系统属性，切换到"高级"-"环境变量"：

1. JAVA_HOME：指向JDK安装目录（例如C:\QtAndroid\jdk1.8.0_351）
2. ANDROID_HOME：指向SDK安装目录（例如C:\QtAndroid\android-sdk）
3. PATH追加：添加以下三条路径（具体根据你的安装位置调整）：
   • %JAVA_HOME%\bin
   • %ANDROID_HOME%\tools
   • %ANDROID_HOME%\platform-tools

验证配置是否成功：打开cmd分别执行java -version、adb version和ndk-build --version。如果看到版本号输出，说明环境变量设置正确。这里有个隐藏坑点——某些杀毒软件会拦截adb进程，如果adb命令报错，记得把platform-tools目录加入杀软白名单。

3. Qt Creator的安卓套件配置

打开Qt Creator后别急着新建项目，先到"工具"-"选项"-"设备"中完成以下配置：

3.1 安卓设备设置

在"Android"选项卡中指定：

• JDK位置：刚才设置的JAVA_HOME路径
• Android SDK位置：ANDROID_HOME对应的目录
• Android NDK位置：解压后的NDK文件夹（例如C:\QtAndroid\android-ndk-r21e）

3.2 构建套件验证

转到"Kits"选项卡，确保已自动检测到Android套件。关键检查三点：

1. 编译器：显示Clang（NDK自带）
2. Qt版本：显示Qt5.14.2 Android ARMv7
3. 调试器：显示自动检测到的GDB

如果缺少任何一项，建议重新安装Qt时勾选"Android ARMv7"组件。遇到过最诡异的情况是套件显示正常但编译失败，后来发现是Qt安装时网络波动导致组件不完整。

4. 真机调试全流程

4.1 手机端准备

1. 开启开发者模式（连续点击"设置-关于手机-版本号"7次）
2. 启用USB调试和USB安装权限
3. 连接电脑后选择"文件传输"模式

4.2 创建测试项目

新建Qt Widgets Application时，务必勾选"创建AndroidManifest.xml"。这个文件相当于安卓应用的身份证，没有它会导致安装失败。模板代码里有个坑：默认的android:targetSdkVersion可能高于你安装的SDK版本，需要手动修改为26（对应Android 8.0）。

4.3 编译与部署

首次构建时会自动下载Gradle组件，这个过程可能很慢。建议提前准备好gradle-6.1.1-bin.zip（国内镜像），放到C:\Users\你的用户名\.gradle\wrapper\dists\gradle-6.1.1-bin\随机目录下。当控制台出现"Unzipping..."时，立即暂停构建（点Qt Creator的停止按钮），把zip文件放入该目录后再继续构建。

当看到"Starting: Intent"日志时，恭喜你！APP应该已经出现在手机上了。如果安装失败，重点检查：

• 手机是否弹出安装确认对话框（有些机型需要手动确认）
• 电脑是否安装了正确的USB驱动（华为/小米等品牌需要单独安装驱动）
• AndroidManifest.xml中的minSdkVersion是否高于手机系统版本

5. 常见问题解决方案

问题1：编译时报错"Unable to find a valid JDK"

• 检查JAVA_HOME是否包含在系统环境变量（非用户变量）
• 确认Qt Creator重启过（环境变量更新需要重启生效）
• 尝试在Qt Creator的"帮助"-"关于"中查看检测到的Java版本

*问题2：部署时报错"Failed to install.apk"

• 手机存储空间是否不足（至少保留500MB）
• 是否开启了USB安装白名单（部分国产手机需要额外授权）
• 尝试卸载手机上的旧版本APP再重新安装

问题3：运行时报错"dlopen failed: library "libc++_shared.so" not found"

• 在项目.pro文件中添加：

  android { ANDROID_EXTRA_LIBS = $$[QT_INSTALL_LIBS]/libc++_shared.so }

• 清理构建目录后重新编译

最后分享一个性能优化技巧：在android/build.gradle中添加以下配置可以显著减少APK体积：

android { splits { abi { enable true reset() include 'armeabi-v7a' universalApk false } } }