yafeilinux 发表于 2024-1-2 15:17:04

Qt 6.x 创建Android开发环境及相关问题解决办法

Qt支持移动应用程序的开发和部署。对于Android平台,可以将Qt 6.5程序运行在Android 8.0(API Level 26)以上版本中。除了极少数和平台特定的一些模块外,几乎所有Qt模块都支持Android平台。Qt Widgets项目也可以在移动平台运行,但是Qt Quick更适合开发手机移动界面。

1. 下载Android组件
进行Android开发需要在安装Qt时选择安装Android组件,如果在安装时没有选择,那么可以先到Qt安装目录(笔者这里是C:\Qt)运行MaintenanceTool.exe工具,然后选择“添加或移除组件”(如果有更新,需要先进行更新组件才可以添加组件),这时在组件列表中勾选自己已安装版本中的Android组件。如果列表中没有该组件,可以先勾选右侧的Archive复选框,然后单击下面的“筛选”按钮即可。
2. 工具软件的下载和安装
(1)打开Qt Creator,选择“编辑→Preferences”菜单项,在弹出的首选项对话框左侧选择“设备”,在这里可以对Android开发环境进行配置。可以看到,主要需要3个工具软件,分别是JDK、Android SDK、Android NDK,下面先来下载安装必要的软件,然后进行配置。

(2)首先手动下载OpenJDK:地址:https://adoptium.net/zh-CN/temurin/releases/?version=11下载文件:OpenJDK11U-jdk_x64_windows_hotspot_11.0.17_8.zip注意,为了避免因开发环境的版本差异产生不必要的问题,推荐下载和这里相同的软件版本,如果读者无法打开提供的链接,或者无法找到相同的版本,可以到Qt开源社区(www.qter.org)的下载页面进行下载。

(3)然后将下载的文件进行解压缩,比如解压缩到D:\Android目录下。在Qt Creator首选项对话框中设置好JDK的位置,然后设置Android SDK的路径,比如D:\Android\SDK(可以提前在D:\Android中新建SDK文件夹),最后单击Android SDK路径后面的Set Up SDK按钮。


(4)下面会弹出下载SDK工具对话框,提示将Android SDK安装到D:\Android\SDK。下面单击“是”按钮开始下载。
问题一:如果下载文件时出现如下图所示的错误,可以通过更换cmdline-tools版本进行解决。

首先可以通过如下链接(或者到Qt开源社区进行下载):https://dl.google.com/android/re ... -9123335_latest.zip
下载commandlinetools-win-9123335_latest.zip文件,将其解压后,使用其cmdline-tools目录中的所有文件,覆盖D:\Android\SDK\cmdline-tools\latest中的文件。
完成后单击SDK管理器。在弹出的Android SDK管理器对话框单击右上角的“更新已安装的”按钮。
当完成更新后会弹出提示,单击“确定”按钮即可。这时会再次弹出修改Android SDK对话框,显示有5个SDK包需要安装,单击“确定”按钮即可。
下载完所有安装包以后,当单击“确定”按钮后,会发现Android设置已经完成了,后面的Android NDK列表也已经自动设置好了。对于最后面的OpenSSL设置是可选的,现在先不用设置。
(5)下载完成后默认勾选了“为安卓工具链自动创建套件”选项,这样会自动生成Android构建套件。现在先单击首选项对话框下面的“确定”按钮关闭该对话框,然后重新打开首选项对话框,并在左侧选择构建套件(Kits),可以看到这里自动生成了Android相关的套件。下面就可以开始Android开发了。

3.编译运行Android程序
这里使用小米11手机进行演示,其系统是基于Android 13的MIUI 14稳定版。要在Qt Creator中将程序部署到手机上运行,需要在手机设置的开发者选项中开启USB调试。笔者这里的开启方式是依次选择“设置→更多设置→开发者选项→USB调试、USB安装”(注意,在MIUI 14稳定版中需要进入“设置→我的设备→全部参数”,在“MIUI版本”上多次单击才能进入开发者模式,这样才会出现开发者选项)。使用USB数据线将手机连接到计算机,这时手机端会弹出对话框询问是否允许USB调试,选择一律允许即可。
在Qt Creator创建一个项目,然后将目标选择器中将构建套件选择为Android版本。可以看到,在上面的设备处已经自动选择了相应的手机设备,这里的M2102K1C是手机的认证型号,可以在手机“设置→我的设备→全部参数”中查看。如果想更改这个名称,可以单击右侧的管理按钮或者选择“编辑→Preferences”菜单项,在打开的首选项对话框中设备页面的Devices选项卡页面进行修改。
问题二:在编译过程中,可能会在下载gradle-8.0-bin.zip时出现问题。

如果这里等待长时间无法完成,可以自己手动下载该文件(可以到Qt开源社区进行下载),并将其复制到目录:C:\Users\Administrator\.gradle\wrapper\dists\gradle-8.0-bin\ca5e32bp14vu59qr306oxotwh,这里的Administrator是笔者使用的用户名,读者可以根据自己实际情况选择。再次运行程序就可以很快完成了。


页: [1]
查看完整版本: Qt 6.x 创建Android开发环境及相关问题解决办法