Qt For Android实战：从零搭建Qt5.14.2安卓开发环境与避坑指南
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打开系统属性，切换到"高级"-"环境变量"：
- JAVA_HOME：指向JDK安装目录（例如
C:\QtAndroid\jdk1.8.0_351） - ANDROID_HOME：指向SDK安装目录（例如
C:\QtAndroid\android-sdk） - 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套件。关键检查三点：
- 编译器：显示Clang（NDK自带）
- Qt版本：显示Qt5.14.2 Android ARMv7
- 调试器：显示自动检测到的GDB
如果缺少任何一项，建议重新安装Qt时勾选"Android ARMv7"组件。遇到过最诡异的情况是套件显示正常但编译失败，后来发现是Qt安装时网络波动导致组件不完整。
4. 真机调试全流程
4.1 手机端准备
- 开启开发者模式（连续点击"设置-关于手机-版本号"7次）
- 启用USB调试和USB安装权限
- 连接电脑后选择"文件传输"模式
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 } } }