Unreal发布Android App如何面对混乱的Android SDK开发环境

混乱的Android SDK开发环境

Unreal编译Android App需要配置SDK开发环境
在这里插入图片描述

其中包含了Android SDK NDK JDK,非常混乱,几个DK之间的版本不匹配,编译出错,报错信息很笼统,很难定位具体问题。一般来说,借用其他软件自动安装的DK一般为兼容的一套,如果可以直接使用,会减少很多我们自己配置SDK出现版本兼容的问题。
在这里插入图片描述

Unreal 4可以借用Unity3D安装的Android环境

Unity 3D使用Unity HUB安装Android开发环境时会自动安装一套配套的Android SDK NDK JDK,Unreal可以借用版本匹配的Unity3D的Android开发环境。
比如Unreal 4.27就可以使用Unity3D 2021.3.33f1c1的开发环境,路径如下:
SDK:D:\Program Files\Unity Hub\Editor\2021.3.33f1c1\Editor\Data\PlaybackEngines\AndroidPlayer\SDK
NDK:D:\Program Files\Unity Hub\Editor\2021.3.33f1c1\Editor\Data\PlaybackEngines\AndroidPlayer\NDK
JDK:D:\Program Files\Unity Hub\Editor\2021.3.33f1c1\Editor\Data\PlaybackEngines\AndroidPlayer\OpenJDK

Unreal 5需要安装Android Studio开发环境

Unreal 5需要使用SDK的版本为r25b,这个和Unity3D安装的Android SDK并不匹配,而且Unreal会验证系统是否安装了Android Studio,没有安装则直接报错退出编译。

有人说可以建一个空目录欺骗Unreal,因为输出Android Apk时只需要用到3个DK,完全没有用到Android Studio的其他组件。

Android Studio给人很混乱的一个感觉,就是各种版本。前面说的Unreal需要Android SDK版本为r25b,高于或者低于这个版本都是不行的。

UATHelper: Packaging (Android (ETC2)): Android: (Status=Invalid, Allowed_Sdk=r25b, Current_Sdk=r23b, Allowed_AutoSdk=r25b, Current_AutoSdk=, Flags="InstalledSdk_InvalidVersionExists, Platform_ValidHostPrerequisites")

但是打开Android Studio的SDK Manager管理器,可以看到各种版本号
在这里插入图片描述
Android Studio的SDK Manager管理器中显示了很多版本号,有API的版本,有Android系统的版本,唯独没有我们要的r25b这个版本,让我们无从下手。
实际上,这里说的r25b实际上是Android SDK Build-Tools和NDK的版本。
在这里插入图片描述
默认情况下,我们是看不到这个版本号的,需要点击右下角的Show Package Details复选框
在这里插入图片描述
在这里插入图片描述
这个时候我们才能看到SDK Tools的版本(SDK和NDK版本),这个才是Unreal需要的版本号,Unreal 5.3安装对应的25版本即可。

Android Studio的DK版本目录

Android SDK和NDK目录在SDK Manager管理器中有显示
在这里插入图片描述
SDK:C:\Users\wlf\AppData\Local\Android\sdk
NDK:C:\Users\wlf\AppData\Local\Android\sdk\ndk\25.1.8937393

在这里插入图片描述
NDK目录下有我们安装的多个版本,选择Unreal要求的版本。
但JDK的版本不在这个目录下。AAndroid Studio内置了一个JDK,没有通过SDK Manager进行管理,位置位于Android Studio的安装目录下。
JDK:C:\Program Files\Android\Android Studio\jre

处理gradle和java版本

Unreal打包Android APK需要用到gradle,gradle是安卓的打包工具,需要和IDE配套,一般会自动下载,但由于墙的存在,可能会下载失败。
在这里插入图片描述
Unreal提示出错信息

UATHelper: Packaging (Android (ETC2)): Creating rungradle.bat to work around commandline length limit (using unused drive letter Z:)
UATHelper: Packaging (Android (ETC2)): Making .apk with Gradle...
UATHelper: Packaging (Android (ETC2)): Downloading https://services.gradle.org/distributions/gradle-7.5-all.zip

gradle的建构目录位于:C:\Users\wlf\.gradle\wrapper\dists
在这里插入图片描述
目录下有不同IDE用到的不同gradle版本。如果没有对应的版本或者下载失败(0字节zip),可以手动下载并解压覆盖。

gradle提示错误

gradle是IDE最终合成apk的阶段,提示错误一般很笼统,很难看明白。

UATHelper: Packaging (Android (ETC2)): FAILURE: Build failed with an exception.
UATHelper: Packaging (Android (ETC2)): BUILD FAILED in 5s
UATHelper: Packaging (Android (ETC2)): cmd.exe failed with args /c "H:\Coding\Unreal\ARStream5.3\Intermediate\Android\arm64\gradle\rungradle.bat" :app:assembleDebug
UATHelper: Packaging (Android (ETC2)): BUILD FAILED

可以手动运行Unreal安装目录下的setupandroid.bat来检查具体出错信息。
在这里插入图片描述
如果有错误,会提示具体错误。

PS D:\Program Files\Epic Games\UE_5.3\Engine\Extras\Android> .\setupandroid.bat

Android Studio Path: C:\Program Files\Android\Android Studio Android Studio SDK Path: 
C:\Users\wlf\AppData\Local\Android\Sdk Using sdkmanager: 
C:\Users\wlf\AppData\Local\Android\Sdk\cmdline-tools\latest\bin\sdkmanager.bat 
Error: A JNI error has occurred, please check your installation and try again Exception in thread "main" java.lang.UnsupportedClassVersionError: 
com/android/sdklib/tool/sdkmanager/SdkManagerCli has been compiled by a more recent version of the Java Runtime (class file version 61.0), this version of the Java Runtime only recognizes class file versions up to 52.0 at 
java.lang.ClassLoader.defineClass1(Native Method) at 
java.lang.ClassLoader.defineClass(ClassLoader.java:757) at 
java.security.SecureClassLoader.defineClass(SecureClassLoader.java:142) at 
java.net.URLClassLoader.defineClass(URLClassLoader.java:468) at 
java.net.URLClassLoader.access$100(URLClassLoader.java:74) at 
java.net.URLClassLoader$1.run(URLClassLoader.java:369) at 
java.net.URLClassLoader$1.run(URLClassLoader.java:363) at java.security.AccessController.doPrivileged(Native Method) at 
java.net.URLClassLoader.findClass(URLClassLoader.java:362) at 
java.lang.ClassLoader.loadClass(ClassLoader.java:419) at 
sun.misc.Launcher$AppClassLoader.loadClass(Launcher.java:352) at 
java.lang.ClassLoader.loadClass(ClassLoader.java:352) at 
sun.launcher.LauncherHelper.checkAndLoadMain(LauncherHelper.java:495) Update failed. Please check the Android Studio install.

chatGPT解释一下错误
在这里插入图片描述
其实就是jdk版本问题,IDE需要的gradle 7.5需要java-17,而我安装的Android Studio自带的jdk是java-8的,不能编译java文件造成的。
单独安装java-17并配置环境变量JAVA_HOME
在这里插入图片描述

按说明文档只要配置Unreal的Project Setting的SDK目录即可,但保险起见还需要配置JAVA_HOME目录,因为Unreal调用命令行执行外部命令时可能会使用系统环境变量而不使用Unreal配置的SDK目录

配置Unreal/Project Setting/Android SDK目录
在这里插入图片描述

总结

总的来说,Unreal编译Android APK需要用到Android SDK NDK,JDK和gradle。
其中Android SDK是安卓开发环境的编译器,NDK是Android编译C/C++代码需要的工具,SDK和NDK的版本需要和Unreal需求的特定版本一致,比如Unreal 5.3需要r25b版本,安装Android SDK/NDK 25版即可。
JDK是JAVA语言开发包,也就是java的编译环境,是安卓开发的基础。gradle是IDE(也就是Unreal编辑器)打包Android APK的工具,运行在java开发环境下,gradle的版本是IDE规定的(比如Unreal 5.3需要gradle 7.5),而确定的gradle需要特定的java开发环境,也就是特定JDK版本,比如gradle 7.5需要java-17,安装并配置java-17版本即可。

最近更新

  1. TCP协议是安全的吗?

    2024-03-17 16:16:03       18 阅读
  2. 阿里云服务器执行yum,一直下载docker-ce-stable失败

    2024-03-17 16:16:03       19 阅读
  3. 【Python教程】压缩PDF文件大小

    2024-03-17 16:16:03       18 阅读
  4. 通过文章id递归查询所有评论(xml)

    2024-03-17 16:16:03       20 阅读

热门阅读

  1. SeAndroid 安全策略机制

    2024-03-17 16:16:03       18 阅读
  2. Android init.rc 解析

    2024-03-17 16:16:03       21 阅读
  3. spring redis 工具类

    2024-03-17 16:16:03       18 阅读
  4. [c++] lambda 表达式

    2024-03-17 16:16:03       18 阅读
  5. c语言:汽车时代

    2024-03-17 16:16:03       23 阅读
  6. Hive中的NVL函数与COALESCE函数

    2024-03-17 16:16:03       21 阅读
  7. Python3 字符编解码

    2024-03-17 16:16:03       18 阅读
  8. 修改Docker 默认存储路径,镜像容器移动到新路径

    2024-03-17 16:16:03       19 阅读
  9. 【Docker】Kong 容器化部署及配置参数说明

    2024-03-17 16:16:03       17 阅读