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

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

• 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界面：

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

来自为知笔记(Wiz)