Qt For Android的环境搭建

本教程是经过验证可单步调试的环境搭建过程,如果不要求单步调试功能,则相关依赖版本可随意。
在Window7中,亲测如下:
android-ndk32-r10-windows-x86_64.zip
android-ndk-r10-windows-x86_64-gdb.tar.xz
jdk-7u71-windows-x64.exe
android-sdk_r22.6.2-windows.zip
qt-opensource-windows-x86-android-5.5.0.exe,这个版本的qtwebview在退出时,会崩溃。
qt-opensource-windows-x86-android-5.4.0.exe,这个版本经测试,可以调用qtwebview组件,且退出时不崩溃。
qt-opensource-windows-x86-android-5.4.2.exe,这个版本经测试,可以调用qtwebview组件,且退出时不崩溃,在5.4中最高的版本了,也是以后项目使用的版本。
apache-ant-1.8.4-bin.zip
google_usb_driver,这个在android-sdk_422.6.2中如果不自带,则可从其它版本中拷贝过来(我是从低版本中拷贝过来的,其版本号是7),放置到android-sdk的extras目录。

在MacOSX10.10系统中亲测如下:
Yosemite 即OSX10.10版本
android-ndk32-r10-darwin-x86_64.tar.bz2
android-ndk-r10-darwin-x86_64-gdb.tar.bz2
jdk-7u71-macosx-x64.dmg
android-sdk_r22.6.2-macosx.zip
qt-opensource-mac-x64-android-ios-5.5.0.dmg,这个版本的qtwebview在退出时,会崩溃。
qt-opensource-mac-x64-android-ios-5.4.2.dmg,这个版本经测试,可以调用qtwebview组件,且退出时不崩溃。
apache-ant-1.8.4-bin.zip
xcode_6.1.dmg
注:在OSX系统是Android是需要依赖xcode的,在安装完xcode时,则也可以用Qt来开发IOS了。这点也验证了。
注:各个qt版本均带有各自的qtwebview组件,从qtwebview的仓库(http://code.qt.io/cgit/qt/qtwebview.git)。

1.下载NDK和GDB调试版本。
根据Qt的官方要求,在不同的系统,其GDB对应NDK的版本是不同的,现整理如下:
注:如果不使用官方GDB,则可能导致无法执行单步调试,该联系是从http://download.qt.io/official_releases/gdb/的官方网站整理如下:

或Window-32系统
android-ndk32-r10-windows-x86.zip,下载地址:http://dl.google.com/android/ndk/android-ndk32-r10-windows-x86.zip
android-ndk-r10-windows-gdb.tar.xz ,下载地址:http://download.qt.io/official_releases/gdb/windows-7/android-ndk-r10-windows-gdb.tar.xz

或Window-64系统
android-ndk32-r10-windows-x86_64.zip,下载地址:http://dl.google.com/android/ndk/android-ndk32-r10-windows-x86_64.zip
android-ndk-r10-windows-x86_64-gdb.tar.xz,http://download.qt.io/official_releases/gdb/windows-7/android-ndk-r10-windows-x86_64-gdb.tar.xz

或Linux-32系统
http://dl.google.com/android/ndk/android-ndk32-r10-linux-x86.tar.bz2
http://download.qt.io/official_releases/gdb/linux-32/android-ndk-r10-linux-x86-gdb.tar.xz

或Linux-64系统
http://dl.google.com/android/ndk/android-ndk32-r10-linux-x86_64.tar.bz2
http://download.qt.io/official_releases/gdb/linux-64/android-ndk-r10-linux-x86_64-gdb.tar.xz

或MacOSX-64,一般情况只需要64位则可以,原因是MacOSX是64位和32位系统的混合体,系统在安装时会根据CPU的情况而自动选择运行32位还是64位。
http://dl.google.com/android/ndk/android-ndk32-r10-darwin-x86_64.tar.bz2
http://download.qt.io/official_releases/gdb/osx/android-ndk-r10-darwin-x86_64-gdb.tar.bz2

http://dl.google.com/android/ndk/android-ndk-r9d-darwin-x86_64.tar.bz2
http://download.qt.io/official_releases/gdb/osx/android-ndk-r9d-darwin-x86_64-gdb.tar.bz2

http://dl.google.com/android/ndk/android-ndk32-r10-darwin-x86.tar.bz2
http://download.qt.io/official_releases/gdb/osx/android-ndk-r10-darwin-x86-gdb.tar.bz2

http://dl.google.com/android/ndk/android-ndk-r9d-darwin-x86.tar.bz2
http://download.qt.io/official_releases/gdb/osx/android-ndk-r9d-darwin-x86-gdb.tar.bz2

注:根据NDK的文档API介绍,所使用的API版本大于18,则才是全面支持的。如果在小于18系统上,则系统可能不支持部份API如openGL等
(android-ndk-r10/docs/Programmers_Guide/html/md_3__key__topics__libraries__s_t_a_b_l_e-_a_p_i_s.html)

2.Android-SDK-Tool下载与更新
SDKTools的官方格式为:android-sdk_r(x.y.z)-(system),x,y,z是版本号,system是系统环境,如下所示:
android-sdk_r22.6.2-macosx.zip
android-sdk_r23.0.2-macosx.zip
android-sdk_r22.6.2-windows.zip

在Qt5.5中,仅推荐使用android-sdk_r22.6.2-windows.zip和android-sdk_r22.6.2-macosx.zip两个版本,r21的版本,好像不支持了,更高的版本不推荐使用。
http://dl.google.com/android/android-sdk_r22.6.2-windows.zip
http://dl.google.com/android/android-sdk_r22.6.2-macosx.zip

以下图示为当前可单步调试的版本,请不要升级sdktools的版本,因为高版本的adb与gdb和gdbserver不兼容。
当前使用的版本

是否使用当前最新版本,就是对的呢?这答案在ADT集成环境即adt-bundle-windows-x86是正确的,但在Qt的环境中,就是可能不合适了。
这不合适是指:使用高版本的sdk是可以直接编译和部署应用的,但也许无法单步调试应用。这原因主要是以下造成的。
Qt的调试全过程,依赖的程序有哪些:
gcc:由ndk提供
androiddeployqt:由Qt5提供
gdb:由ndk提供。
gdbserver:由ndk提供
adb:由platform-tools提供,该工具是与sdktool的一起的。
ant:第三方提供。
而决定单步调试的上述程序有gcc/adb/gdbserver/gdb,而gcc/gdb/gdbserver都是由ndk提供,故兼容性是没有问题的。那不兼容的问题点主要集在adb。
为什么会造成不兼容呢?极可能是adb和gdbserver的通信协议造成的。虽然adb connect和adb -p 5037是完成了设备的连接,包括网络通信,但版本差异导致gdb的调试指令无法透传给gdbserver,最终导致无法启动手机的调试的应用程序,最终也就无法调试。

3.下载apache-ant,官网要求是大于1.8版本,本人实测版本为1.8.4和1.9.4均没有问题。
http://archive.apache.org/dist/ant/binaries/apache-ant-1.8.4-bin.zip

4.下载Qt5.5或者Qt5.4了。
http://download.qt.io/official_releases/qt/5.5/5.5.0/qt-opensource-mac-x64-android-ios-5.5.0.dmg
http://download.qt.io/official_releases/qt/5.5/5.5.0/qt-opensource-windows-x86-android-5.5.0.exe
注:qt5.5版本在调用qtwebview组件时,在退出进程时会崩溃。
http://download.qt.io/official_releases/qt/5.4/5.4.0/qt-opensource-windows-x86-android-5.4.0.exe,调用qtwebview组件时,退出进程不会崩溃也无其它异常。
http://download.qt.io/official_releases/qt/5.4/5.4.2/qt-opensource-windows-x86-android-5.4.2.exe
http://download.qt.io/official_releases/qt/5.4/5.4.2/qt-opensource-mac-x64-android-ios-5.4.2.dmg

5.JDK的版本,本人使用的JDK7u71版本。
http://download.oracle.com/otn-pub/java/jdk/7u71-b14/jdk-7u71-macosx-x64.dmg
http://download.oracle.com/otn-pub/java/jdk/7u71-b14/jdk-7u71-windows-i586.exe 如果会导致虚拟机启动故障,安装x64的版本。
http://download.oracle.com/otn-pub/java/jdk/7u71-b14/jdk-7u71-windows-x64.exe

6.在Window中需要安装一个USB driver,该usbdirver是sdk-tool中自带的,如果没有自带,可以从其它版本如r23中提取出来放置extras的googles目录下即可。

————-
Error: Target id ‘android–1’ is not valid. Use ‘android.bat list targets’ to get the target ids.
该类出错,是没有每指定android版本,因此会出错。

若出现qt for android 无法调试,则确保检查是否使用的是sdk-tool-r26.2版本。

————————————–
目前经验证,发现无法调试问题,原因是adb的版本,与gdb及gdbserver版本不兼容导致。qt的调试是需要通过adb进行通信的。
——————————–
如果在调试时,提示”Waiting for debug socket connect”的问题,请检查是否存在进程AndroidServer的进程,像QQ或移动助手之类的工具,会自带这种工具。