虚幻引擎（Unreal Engine、UE5）打包安卓Android环境配置完整版（东西较多、按照目录找本身想看的）

风雨路人

文件路径中的Administrator，是我的用户名，换成你本身的
这篇文章的前提是安装好VisualStudio且配置好环境，以为UE安装好Android的模板
0.前提

0.0.相关运行库

保举6.0.7和3.1.10





0.1.UE安装Android模板





0.2.VisualStudio配置（有编纂器）

建议安装负载使用C++进行游戏开发，右边 可选 建议都不要勾选


C++sdk建议10.18




插件
0.3.BuildTools配置（和VisualStudio二选一，这个没编纂器），建议搭配Rider（Visual Studio Code可以尝尝）使用



1.Android Studio1.1.下载Android Studio

UE官方建议4.02，最新的也可以。这里演示用的4.02。
Android Studio有安装法式、压缩包和命令行。压缩包和安装法式没区别，安装法式较为省心。直接用命令行安装SDK、NDK，打包会掉败，需安装Android Studio，只安装不打开，不建议使用这个方式，但这个教程里面会写。
Command line tools only下载的是命令行。






1.2.安装Android Studio



Android Virtual Device，按照我的尝试，勾选不勾选没区别。感觉保险一点，勾选。












这个是选择是否上传你的使用习惯，建议Don't send








到这里已完成，如果已配置好JDK，请跳转（2.2.SDK、Build-Tools、NDK、cmdline-tools、Cmake安装）


1.3.安装cmdline-tools

记得装Android Studio，最新或者4.02都可以，只需安装，无需打开
从 Android Studio 下载页面中下载最新的“command line tools only”软件包，然后将其解压缩。
将解压缩的 cmdline-tools 目录移至您选择的新目录，例如 android_sdk。这个新目录就是您的 Android SDK 目录。
在解压缩的 cmdline-tools 目录中，创建一个名为 latest 的子目录。
将原始 cmdline-tools 目录内容（包罗 lib 目录、bin 目录、NOTICE.txt 文件和 source.properties 文件）移动到新创建的 latest 目录中。此刻，您就可以从这个位置使用命令行东西了。
<hr/>如需安装旧版命令行东西，请运行以下命令：（可选）
android_sdk/cmdline-tools/latest/bin/sdkmanager --install ”cmdline-tools;version”
将 version 替换为您要安装的版本，例如 5.0。
注意：对于当地使用情况，您可以使用 latest 软件包。对于脚本，则应选择特定版本以确保不变性。
<hr/>





环境变量设置如下






把android_sdk\cmdline-tools\latest\bin添加进path



命令
可参考官方教程
sdkmanager --list
sdkmanager packages
sdkmanager --no_https ”platforms;android-30”
sdkmanager --install ”platforms;android-30”
sdkmanager --uninstall packages

sdkmanager --install ”platforms;android-30”
sdkmanager --install ”sources;android-30”
sdkmanager --install ”build-tools;30.0.3”
sdkmanager --install ”cmake;3.10.2.4988404”
sdkmanager --install ”ndk;25.1.8937393”
1.4.卸载Android Studio

有多种卸载方式，控制面板、通过卸载软件等。这里介绍两种，第一张图片是，通过自带卸载法式卸载；第二张图片是通过安装法式卸载，如果空间足够，建议保留Android Studio安装法式



通过自带卸载法式卸载



通过安装法式卸载








1.5.断根Android Studio残留

Android Studio残留分布不才面几个目录，如果安装报错、图标显示错误，查抄下面几个目录，把里面东西删掉
C:\Users\Administrator\.AndroidStudio4.0
C:\Users\Administrator\.gradle    这个不建议删除，
虚幻引擎的gradle也安装在这个位置。目录是这个C:\Users\Administrator\.gradle\wrapper\dists
C:\Users\Administrator\.android
C:\Users\Administrator\AppData\Local\Google
C:\Users\Administrator\AppData\Local\Android （存放下载的SDK的路径）
C:\Users\Administrator\AppData\Roaming\Google
1.6.使用技巧

1.6.1更改主题为暗中主题




1.6.2封锁更新




1.6.3更新gradle
有三种方式
第一种从官网下载解压至C:\Users\Administrator\.gradle\wrapper\dists
Gradle Distributions
第二种改削Engine\Build\Android\Java\gradle\gradle\wrapper中的gradle-wrapper.properties文件
第三种操作Android Studio更新






创建的文件位置在C:\Users\Administrator\AndroidStudioProjects


选择方针Gradle版本




2.配置环境

2.1.JDK安装

JDK保举jdk-8u201、microsoft-jdk-11.0.19、open-jdk-8到13
设置环境变量


下载链接
按照引擎兼容的gradle判断
下载gradle的脚本路径是gradle-wrapper.properties，存放路径是下面两个
D:\Epic\UE\UE_5.2\Engine\Build\Android\Java\gradle\gradle\wrapper
UE_5.2\Engine\Plugins\Runtime\AndroidFileServer\Source\AFSStub\gradle\wrapper


gradle下载路径
C:\Users\Administrator\.gradle\wrapper\dists


gradle和jdk关系如下，
Compatibility Matrix
Gradle Distributions



gradle和jdk对照表

2.2.SDK、Build-Tools、NDK、cmdline-tools、Cmake安装

关于安装的SDK、Build-Tools、NDK、cmdline-tools、Cmake版本问题
UE_5.2\Engine\Extras\Android
打开SetupAndroid.bat
<hr/>SET PLATFORMS_VERSION=android-32
SET BUILDTOOLS_VERSION=30.0.3
SET CMAKE_VERSION=3.10.2.4988404
SET NDK_VERSION=25.1.8937393
<hr/>PLATFORMS这个参考官方文档，建议android-32，编译最低撑持android-30，最低撑持android-26，建议android-30
开发要求


BUILDTOOLS_VERSION、CMAKE通用
NDK UE4.26、UE4.27、UE5.0.3、UE5.1.1、UE5.2.1是纷歧样的，看好再装
事先筹备，安装完成跋文得查抄SDK、NDK环境变量是否设置，以及位置是否正确，没有新建一个。
一般是这个



一般是这个

报错设置成这个



报错设置成这个

AGDE调试要求JDK，环境变量是这个


NDK环境变量






SDK Manager缺组件，打不开，直接用Settings


















Android SDK Platform和Sources for Android版本要一致












手动安装不需要Android SDK Command line Tools，这个是命令行东西，如果必然要安装，官方建议8.0


















3.3一些报错的解决法子

3.3.1.gradle错误
来源
1 UATHelper: Packaging (Android (ASTC)):   ERROR: cmd.exe failed with args /c ”E:\UE4Project426\PicoSDK_UE4_MobileDemo\Intermediate\Android\armv7\gradle\rungradle.bat” :app:assembleDebug
2 PackagingResults: Error: cmd.exe failed with args /c ”E:\UE4Project426\PicoSDK_UE4_MobileDemo\Intermediate\Android\armv7\gradle\rungradle.bat” :app:assembleDebug
3 PackagingResults: Error: Unknown Error

解决方式，封锁UE4项目工程，找到项目文件夹当地位置，删除Intermediate文件夹，从头打开项目进行打包。


3.4官方文档的问题

3.4.1来源
在Visual Studio中使用AGDE调试


Engine\Build\Android\Java\gradle\gradle\wrapper
gradle-wrapper.properties
UE5.2.1
distributionUrl=https\://http://services.gradle.org/distributions/gradle-6.1.1-all.zip
gradle-6.1.1撑持的JDK最高是13
UE5.3（源码版已放出，github可获取）
distributionUrl=https\://http://services.gradle.org/distributions/gradle-7.5-all.zip
gradle-7.5撑持的JDK最高是18
上图的内容不撑持UE5.2.1，但撑持UE5.3
3.虚幻引擎内的设置

3.1配置环境路径



3.2打包设置

勾选是把所有内容打包到apk里面


编纂器开始地图，编纂器打开时的阿谁，默认是OpenWorld
游戏默认地图，打包的方针地图，不换自动打包OpenWorld


这样显示，说明环境正确，第一次打包需要联网，因为需要下载gradle到C:\Users\Administrator\.gradle\wrapper\dists，第二次不再需要需要联网，因为已经下载了