Skip to main content

Android 开发环境搭建:Android Studio 与 AGDE 两条路

March 26, 2024About 2 minAndroidUnreal EnginePlatform

Android 开发环境搭建:Android Studio 与 AGDE 两条路

UE 出 Android 包有两条配环境的路:用 Android Studio(标准),或用 VS + AGDE(不装 Android Studio,适合习惯在 VS 里调试的)。两条路都绕不开一件事:SDK/NDK/Build-tools 的版本必须和引擎版本对得上。

版本对应

每个引擎版本对应的 SDK/NDK/Build-tools 版本不同,以下数字以 UE4.27 为例,别照抄到其他引擎版本。查准确版本的方法见下文"确定版本号"。

确定 SDK/NDK/Build-tools 版本

打开引擎里的 Engine\Extras\Android\SetupAndroid.bat,找这一行(UE4.27 为例):

call "%SDKMANAGER%" "platform-tools" "platforms;android-28" "build-tools;28.0.3" "cmake;3.10.2.4988404" "ndk;21.4.7075529"

拆出来就是:

  • SDK platform: android-28
  • Build-tools: 28.0.3
  • cmake: 3.10.2.4988404
  • ndk: 21.4.7075529

路线 A:Android Studio

  1. 装 SDK 和 NDK:申请 IT 网络权限。装好 Android Studio,SDK 用它的 SDK Manager 装。NDK 按引擎要求的版本装(UE4.27 用 r21b)。

  2. 装 Android Studio:开 SDK Manager,勾上需要的组件(取消勾 "Hide Obsolete Packages",别选 "Android SDK Tools(Obsolete)"),Apply。装组件需要 IT 开相关网络权限。

  3. 设环境变量:

    • JAVA_HOME 指向 Android Studio 目录下的 jre 子目录,如 C:\Program Files\Android\Android Studio\jre
    • 把 jre\bin 加进 Path,如 C:\Program Files\Android\Android Studio\jre\bin
    • 加 CLASSPATH,值为 .;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar

  4. 接受 SDK licenses:命令行进 Android SDK 目录,sdkmanager --licenses,全部 y(需要 IT 开网络权限)。

  5. UE 编辑器设置:Edit → Project Settings → Platforms → Android 设三个变量;再到 Platforms → Android SDK 设 SDK/NDK 路径。

  6. 第三方插件目录调整(按需):某些音频中间件(如 Wwise)的 Android 库目录结构和 UE 期望的不一致,需要重排。例如进 Engine\Plugins\Wwise\ThirdParty\ 新建 Android 目录,把 Android_arm64-v8a / Android_armeabi-v7a / Android_x86 / Android_x86_64 四个目录拷进去,再去掉前缀改成 arm64-v8a / armeabi-v7a / x86 / x86_64。

  7. 打包:File → Package Project → Android → Android(ETC)。

命令行打包示例:

"%UE4_RUN_UAT%" -ScriptsForProject="%PROJ_UPROJ%" BuildCookRun -nocompileeditor -project="%PROJ_UPROJ%" -noP4 -platform=%PLATFORM% -clientconfig=%BUILD_TARGET% -client -cook -build -stage -pak -archive -iterate -archivedirectory="%PROJ_BINARY_DIR%" -package -ue4exe=%UE4_DIR%\Engine\Binaries\Win64\UE4Editor-Cmd.exe -clean -compressed -SkipCookingEditorContent -ddc=DerivedDataBackendGraph -targetplatform=Android -cookflavor=ETC2 -build -CrashReporter -target=%TARGET% -utf8output -stacktrace -debug -scan

-cookflavor 选 ASTC/DXT/ETC2 的区别见 UE 打包 Android 概览。UE 官方文档:https://docs.unrealengine.com/5.1/zh-CN/how-to-set-up-android-sdk-and-ndk-for-your-unreal-engine-development-environment/

路线 B:VS + AGDE(不装 Android Studio)

AGDE(Android Game Development Extension)让你在 VS 里直接开发调试 Android,不用 Android Studio。

  1. 装 JDK 11,设系统变量 JAVA_HOME 和 Path。
  2. 装 AGDE:https://developer.android.com/games/agde
  3. 装完打开 VS 2019/2022,添加 AGDE 的 Toolbar。
  4. 按上文"确定版本号"定好要装的 SDK/NDK/Build-tools 版本。
  5. 打开 SDK Manager,装对应版本的 SDK/NDK/Build-tools。
  6. 设环境变量。
  7. UE 编辑器 → Project Settings 里配好 SDK、NDK 路径。

官方文档:https://docs.unrealengine.com/4.27/en-US/SharingAndReleasing/Mobile/Android/VisualStudioDebuggingforAndroid/

在模拟器里跑 Android pak

没真机时用 MuMu 模拟器:装 MuMu,更新到 12 版本(需要联网),双击 Android pak 就能在模拟器里找到游戏。