Qt for Android开发环境搭建及测试过程记录

最近学习了Qt的QML编程技术,感觉相较于以前的QtGUI来说更方便一些,使用QML可以将界面与业务逻辑解耦,便于开发。
QML支持跨平台,包括支持Android平台,因此可以使用Qt的QML进行Android开发。本文记录了Qt for Android环境搭建及测试过程。

本文使用Qt 5.6.1版本。

1. 下载Qt for Android

Qt for Android (5.6.1)安装包下载地址:http://download.qt.io/archive/qt/5.6/5.6.1/qt-opensource-windows-x86-android-5.6.1.exe

2. 安装Android依赖环境

参考Qt for Android官方网站:Getting Started with Qt for Android | Qt 5.7,可知需要安装如下几项:

  • Android SDK (包括Android SDK Tools和Android Debug Bridge(ADB))
  • Android NDK
  • Apache Ant v1.8 or later
  • Java SE Development Kit (JDK) v6 or later

于是,我安装了如下几项:

3. 安装Qt for Android

如果之前没有安装过Qt 5.6.1的任何平台版本(包括VS2015、VS2013等),则可以直接双击运行qt-opensource-windows-x86-android-5.6.1.exe,按提示进行安装即可。

但如果之前安装过Qt 5.6.1,比如我之前安装了Qt 5.6.1 VS2010 x86,安装目录下的结构如下:

D:\ProgramFiles\Qt\5.6.1
├─5.6
│ ├─msvc2010_x86
│ └─Src
├─Docs
├─Examples
├─Tools
└─……(其他不重要的目录或文件)

我又在虚拟机里测试安装了一下qt-opensource-windows-x86-android-5.6.1.exe,得到的目录结构如下:

D:\ProgramFiles\Qt\5.6.1
├─5.6
│ ├─android_armv7
│ ├─android_x86
│ ├─mingw49_32
│ └─Src
├─Docs
├─Examples
├─Tools
│ └─mingw492_32
└─……(其他不重要的目录或文件)

从上面两个目录结构的对比中可以看出,Qt 5.6.1在不同编译平台下的安装文件的区别就在于5.6目录下和Tools目录下的对应内容。

于是,我将虚拟机中的5.6\android_armv75.6\android_x865.6\mingw49_32Tools\mingw492_32这几个文件夹复制到主机中安装了Qt 5.6.1 VS2010的对应目录下。现在汇总的目录结构如下:

D:\ProgramFiles\Qt\5.6.1
├─5.6
│ ├─android_armv7
│ ├─android_x86
│ ├─mingw49_32
│ ├─msvc2010_x86
│ └─Src
├─Docs
├─Examples
├─Tools
│ └─mingw492_32
└─……(其他不重要的目录或文件)

其中Tools\mingw492_32目录相当于MinGW编译器的安装目录,需要将Tools\mingw492_32\bin的绝对路径添加到系统Path环境变量中,否则后面Qt Creator会找不到mingw32-make.exe文件。

OK,到这里就算安装完成了。

4. 后续配置

安装完之后,就是在Qt Creator中配置Qt路径了,比较简单,就不再赘述了。

我的电脑上配置完之后如下(在Qt Creator中选择"工具"->"选项"来查看):



5. 测试

打开Qt Creator,新建一个工程,配置如下:




选择构建套件为Qt 5.6.1(即VS2010平台),点击构建按钮,成功构建。
再点击运行按钮,成功运行可以看到一个Hello World界面:

然后选择构建套件为Android for armeabi-v7a (GCC 4.9, Qt 5.6.1)(即Android平台),点击构建按钮,成功构建。

此时可能会出现如下错误:

  1. Execute failed: java.io.IOException: Cannot run program${aapt}": error=2, No such file or directory

解决办法参考:android - ant jar error: Execute failed: …… - Stack Overflow

Have you updated the Android SDK tools to 24.3.2? This seems to have caused the issue. Add following 4 lines to android-sdk-path/tools/ant/build.xml starting line 484 and hopefully it should solve.

<property name="aidl" location="${android.build.tools.dir}/aidl${exe}" />
<property name="aapt" location="${android.build.tools.dir}/aapt${exe}" />
<property name="dx" location="${android.build.tools.dir}/dx${bat}" />
<property name="zipalign" location="${android.build.tools.dir}/zipalign${exe}" />

于是,用文本编辑器打开D:\ProgramFiles\Android\sdk\tools\ant\build.xml,在第484行处添加上面几行内容,保存。

重新点击Qt Creator的构建按钮,又出现了如下错误:

02:23:45: 正在启动 "D:\ProgramFiles\Qt\5.6.1\Tools\mingw492_32\bin\mingw32-make.exe" "INSTALL_ROOT=D:/ProgramData/QtCreatorProjects/AndroidTest/build-AndroidTest-Android_for_armeabi_v7a_GCC_4_9_Qt_5_6_1-Debug/android-build" install
cp -f libAndroidTest.so D:/ProgramData/QtCreatorProjects/AndroidTest/build-AndroidTest-Android_for_armeabi_v7a_GCC_4_9_Qt_5_6_1-Debug/android-build/libs/armeabi-v7a/libAndroidTest.so
makefile:820: recipe for target 'install_target' failed
process_begin: CreateProcess(NULL, cp -f libAndroidTest.so D:/ProgramData/QtCreatorProjects/AndroidTest/build-AndroidTest-Android_for_armeabi_v7a_GCC_4_9_Qt_5_6_1-Debug/android-build/libs/armeabi-v7a/libAndroidTest.so, ...) failed.
make (e=2): 系统找不到指定的文件。
mingw32-make: [install_target] Error 2 (ignored)

注意到上面有一行命令是cpcp是Linux系统中的复制命令,在Windows系统中对应的是copy,问题就出在这儿。

查看该工程Android平台build目录(build-AndroidTest-Android_for_armeabi_v7a_GCC_4_9_Qt_5_6_1-Debug)下的Makefile,发现里面有下面这段内容:

COPY = cp -f
COPY_FILE = cp -f
COPY_DIR = cp -f -R

而在VS2010平台build目录(build-AndroidTest-Qt_5_6_1-Debug)下的Makefile中的对应内容为:

COPY = copy /y
COPY_FILE = copy /y
COPY_DIR = xcopy /s /q /y /i

对比其中的cpcopy两个命令,可以由此确定是因为构建套件Android for armeabi-v7a (GCC 4.9, Qt 5.6.1)(即Android平台)生成的Makefile是只适用于Linux平台的。
(注:我试过在"工具"->"选项"中修改该构建套件生成的Makefile的类型,但是不管选择哪种Makefile类型,生成的Makefile中都是cp而不是copy。)

于是考虑在Windows系统中搭建虚拟Linux环境。

MSYS可以解决我的这个问题!

MSYS,即Minimal GNU(POSIX)system on Windows,是一个小型的GNU环境,包括基本的bash,make等等。与Cygwin大致相当。

于是下载MSYS,安装,然后将其bin路径添加到系统Path环境变量中。

再次点击Qt Creator的构建按钮,OK,成功构建!

最后点击运行,可以选择安装到Android模拟器或是真机,安装apk后可以看到和Windows平台上界面类似的Android界面:




到此,Qt for Android开发环境搭建以及测试全部完成!





posted @   陪你仰望星空  阅读(16003)  评论(0编辑  收藏  举报
编辑推荐:
· 没有源码,如何修改代码逻辑?
· 一个奇形怪状的面试题:Bean中的CHM要不要加volatile?
· [.NET]调用本地 Deepseek 模型
· 一个费力不讨好的项目,让我损失了近一半的绩效!
· .NET Core 托管堆内存泄露/CPU异常的常见思路
阅读排行:
· 微软正式发布.NET 10 Preview 1:开启下一代开发框架新篇章
· 没有源码,如何修改代码逻辑?
· DeepSeek R1 简明指南:架构、训练、本地部署及硬件要求
· NetPad:一个.NET开源、跨平台的C#编辑器
· PowerShell开发游戏 · 打蜜蜂
点击右上角即可分享
微信分享提示