【Qt】最详细教程,如何从零配置Qt Android安卓环境

2024-06-04 8698阅读

这里写自定义目录标题

  • 安装Qt Creator & Qt
  • 安装下载&安装JDK
  • 设置Android SDK
  • Android模拟器下载
    • 创建android设备(模拟器)
    • Gradle安装
    • 问题解决
      • 无法打开安卓模拟器
      • Build失败
        • 方案一:不适用Qt自带SDK管理器(失败)
        • 方案二:利用Android Studio完善开发环境
        • Debug模式成功,Relase失败

          本文写于2024年1月21日,此时笔者查到的教程,都多少有些不够顺畅,有些是不够详细,有些是已经太久远,笔者折腾了小半天才配置完成。

          为了给有同样需求的小伙伴节省时间,决定把相关教程更新一下。

          文章内容主要包括:

          • 如何在Qt中配置安卓开发环境
          • 在墙内环境下,遇到过哪些问题,最终如何解决的
          • 无法成功打包的问题

            开发环境:

            【Qt】最详细教程,如何从零配置Qt Android安卓环境 第1张

            安装Qt Creator & Qt

            这一步笔者就不详细介绍了,只是强调笔者安装版本如下:

            【Qt】最详细教程,如何从零配置Qt Android安卓环境 第2张

            另外,笔者在Qt Creator 12 + Qt 6.6.0环境下也完成过配置,不过Qt版本又额外下载并使用了Qt 6.2.4

            【Qt】最详细教程,如何从零配置Qt Android安卓环境 第3张

            【Qt】最详细教程,如何从零配置Qt Android安卓环境 第4张

            【Qt】最详细教程,如何从零配置Qt Android安卓环境 第5张

            【Qt】最详细教程,如何从零配置Qt Android安卓环境 第6张

            安装下载&安装JDK

            下载并安装JDK17(笔者尝试过JDK21,印象中会出问题)

            https://www.oracle.com/java/technologies/downloads/#java17

            【Qt】最详细教程,如何从零配置Qt Android安卓环境 第7张

            打开installer开始安装,记得记住安装路径:

            【Qt】最详细教程,如何从零配置Qt Android安卓环境 第8张

            现在可以在Qt Creator中配置JDK了,打开“工具”->“外部”->“配置…”

            【Qt】最详细教程,如何从零配置Qt Android安卓环境 第9张

            选择“设备”->“Android”->JDK位置,通过“浏览”按钮,将JDK位置设置为刚刚安装的JDK路径

            【Qt】最详细教程,如何从零配置Qt Android安卓环境 第10张

            设置Android SDK

            Qt本身带了配置Android SDK的工具的,配置JDK位置的图中,下面一行就是Android SDK,这里的路径可以不做修改,直接点击“设置SDK”按钮,会提示“是否下载并安装安卓SDK到xxx路径”,点击是即可开始下载安卓SDK

            【Qt】最详细教程,如何从零配置Qt Android安卓环境 第11张

            之后会提示:“确实安卓SDK所必要的包,是否安装缺失包”,点击“确认”

            【Qt】最详细教程,如何从零配置Qt Android安卓环境 第12张

            跳出安卓SDK管理器后,所有的都点“是”,就开始安装了(到这里都不需要梯子)

            【Qt】最详细教程,如何从零配置Qt Android安卓环境 第13张

            安装完成后,会自动开始设置安卓OpenSSL,这里基本都会失败,而且是可选项,可以直接取消掉。

            【Qt】最详细教程,如何从零配置Qt Android安卓环境 第14张

            当然也可以去这个Github项目把代码拉下来,然后把OpenSSL二进制位置设置为项目根目录。

            Android模拟器下载

            安装Android后,还缺少Android模拟器。这个也可以直接在SDK管理器中安装:

            【Qt】最详细教程,如何从零配置Qt Android安卓环境 第15张

            在“工具”一栏往下拉就能找到“Android Emulator”点击安装即可:

            【Qt】最详细教程,如何从零配置Qt Android安卓环境 第16张【Qt】最详细教程,如何从零配置Qt Android安卓环境 第17张

            之后重启Qt Creator,应该就在“构建套件”中看到安卓套件了

            【Qt】最详细教程,如何从零配置Qt Android安卓环境 第18张

            创建android设备(模拟器)

            在“设备”->“设备”中,点击“添加”按钮来添加新的设备

            【Qt】最详细教程,如何从零配置Qt Android安卓环境 第19张

            设备类型当然选择Android设备:

            【Qt】最详细教程,如何从零配置Qt Android安卓环境 第20张

            这个时候可能会提示“无法为xxx创建AVD,请先从SDK管理器标签中安装系统镜像”

            这个警告的原因是模拟器的Android版本比较低,我们只安装了Android 12.0,可能与模拟器不匹配。

            我们可以回到Android SDK管理器(参考模拟器安装),安装Android 10.0(Q):

            【Qt】最详细教程,如何从零配置Qt Android安卓环境 第21张

            之后再去创建设备,即可创建成功

            【Qt】最详细教程,如何从零配置Qt Android安卓环境 第22张

            【Qt】最详细教程,如何从零配置Qt Android安卓环境 第23张

            Gradle安装

            到这一步,我们可以去尝试在Qt Creator中创建Android项目了:

            创建项目,选择“Application(Qt)” -> “Qt Widgets Application” -> “选择”

            【Qt】最详细教程,如何从零配置Qt Android安卓环境 第24张

            随便起一个喜欢的项目名称,然后一直点击“下一步”到构建套件(Kit)

            【Qt】最详细教程,如何从零配置Qt Android安卓环境 第25张

            选择“安卓 Qt 6.4.3 Clang x86_64”套件,然后完成创建

            【Qt】最详细教程,如何从零配置Qt Android安卓环境 第26张

            【Qt】最详细教程,如何从零配置Qt Android安卓环境 第27张

            此时如果点击左下角“运行”,会出现如下错误:

            【Qt】最详细教程,如何从零配置Qt Android安卓环境 第28张

            这个错误是下载gradle失败造成的,相信国内安卓开发同学不是第一次遇到了。

            我们直接去这个地址:https://services.gradle.org/distributions/

            下载需要的gradle,从错误信息中可以看到,是"gradle-7.4.2-bin.zip"

            如果像上图所示,点击过“运行”按钮,那你应该可以在“C:\Users\xxx.gradle\wrapper\dists”中找到“gradle-7.4.2-bin”目录,其中有一个一长串字符组成的文件夹。

            【Qt】最详细教程,如何从零配置Qt Android安卓环境 第29张

            我们把下载好的gradle-7.4.2-bin.zip”直接移动到这个文件夹中(不用解压)

            复制完成后,再次点击运行,理论上可以正常运行

            问题解决

            无法打开安卓模拟器

            这里如果出现无法打开模拟器的情况,可以去“启动或关闭Windows功能”

            查看Windows的Hyper-V服务是否已经打开

            【Qt】最详细教程,如何从零配置Qt Android安卓环境 第30张

            Build失败

            到这一步,Qt开发Android的配置已经完成了,可以成功运行起来了吗?

            答案是不能:

            【Qt】最详细教程,如何从零配置Qt Android安卓环境 第31张

            各种查找解决方案,找到如下可能的解决方案:

            • 方案一:不要使用Qt自带的SDK管理器,来源
            • 方案二:问题出在墙上,需要通过android studio协助

              我们分别尝试:

              方案一:不适用Qt自带SDK管理器(失败)

              只有一个地方似乎提到似乎是Qt自带安卓SDK管理器的问题……

              本以为直接使用Qt自带的SDK管理器能方便些,结果还是有坑

              那么我们尝试使用其他教程中提到的SDK Manager重新安装Android SDK吧…,下载地址:https://www.androiddevtools.cn/

              利用这个SDK Manager下载Android SDK和NDK等组件,但结果还是不行,报错也还是一样

              方案二:利用Android Studio完善开发环境

              配置过Android Studio的朋友,看上面的报错信息估计会有些眼熟,看上去像是墙造成的连接失败。

              于是笔者按照之前配置Android Studio的经验,完成Android开发环境的配置。(主要是解决gradle-8.2-bin.zip下载失败的问题,以及梯子的问题)

              【Qt】最详细教程,如何从零配置Qt Android安卓环境 第32张

              配置完成后,重启计算机,再次打开Qt,就可以顺利运行起来了。

              【Qt】最详细教程,如何从零配置Qt Android安卓环境 第33张

              Debug模式成功,Relase失败

              在Debug模式下,成功 运行起来之后,改成Release模式却失败了,报错如下图:

              【Qt】最详细教程,如何从零配置Qt Android安卓环境 第34张

              看报错信息Failed to collect certificates from xxx,应该是和签名有关。

              又去查了Qt中如何配置签名,找到了如下解决方案:

              1. 选择“项目”,找到对应套件的“构建”部分,往下拉到“构建APK”部分,展开详情,里面有证书相关

                【Qt】最详细教程,如何从零配置Qt Android安卓环境 第35张

              2. 点击“创建”,开始创建签名

                【Qt】最详细教程,如何从零配置Qt Android安卓环境 第36张

              3. 填写红框中必要信息,然后点击创建即可

                【Qt】最详细教程,如何从零配置Qt Android安卓环境 第37张

              4. 有了签名后再运行就可以成功了

                【Qt】最详细教程,如何从零配置Qt Android安卓环境 第38张


    免责声明:我们致力于保护作者版权,注重分享,被刊用文章因无法核实真实出处,未能及时与作者取得联系,或有版权异议的,请联系管理员,我们会立即处理! 部分文章是来自自研大数据AI进行生成,内容摘自(百度百科,百度知道,头条百科,中国民法典,刑法,牛津词典,新华词典,汉语词典,国家院校,科普平台)等数据,内容仅供学习参考,不准确地方联系删除处理! 图片声明:本站部分配图来自人工智能系统AI生成,觅知网授权图片,PxHere摄影无版权图库和百度,360,搜狗等多加搜索引擎自动关键词搜索配图,如有侵权的图片,请第一时间联系我们,邮箱:ciyunidc@ciyunshuju.com。本站只作为美观性配图使用,无任何非法侵犯第三方意图,一切解释权归图片著作权方,本站不承担任何责任。如有恶意碰瓷者,必当奉陪到底严惩不贷!

    目录[+]