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

2022-06-23 15:18:12

最近学习了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

于是，我安装了如下几项：

Android SDK (包括Android SDK Tools 24.3.2和几个版本的SDK Platform和Google APIs)
Android NDK (android-ndk-r11c-windows-x86)
Apache Ant v1.9.7
JDK 1.7.0_55

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_armv7、5.6\android_x86、5.6\mingw49_32、Tools\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平台），点击构建按钮，成功构建。

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

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)

注意到上面有一行命令是cp，cp是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

对比其中的cp和copy两个命令，可以由此确定是因为构建套件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界面：