87 lines
5.8 KiB
Markdown
87 lines
5.8 KiB
Markdown
---
|
||
title: AGDE 调试 Unreal Engine Android 项目指南
|
||
date: 2026-04-22 22:19:13
|
||
excerpt: 使用 Android Game Development Extension (AGDE) 在 Visual Studio 中调试 UE Android 项目的完整流程
|
||
tags:
|
||
- UnrealEngine
|
||
- Android
|
||
- AGDE
|
||
- Debug
|
||
rating: ⭐⭐⭐
|
||
---
|
||
## 安装步骤
|
||
1. 安装AGDE。
|
||
2. 重新生成解决方案。
|
||
3. VS的解决方案窗口上可能会显示“安装XX工具才能正常运行”的提示，安装之后再重启VS就能正常运行了。
|
||
## 下载和安装AGDE
|
||
|
||
若要安装AGDE插件并设置项目的解决方案来使用该插件，请执行以下步骤：
|
||
|
||
1. 确保你安装了 **Visual Studio 2022** ，并将其用作虚幻引擎的默认Visual Studio版本。
|
||
2. 从 [Android开发人员页面](https://developer.android.com/games/agde) 下载AGDE插件。当前UE需要23.1.82或更高版本的AGDE。
|
||
3. 将AGDE插件安装到Visual Studio。
|
||
4. 找到项目的.uproject文件，右键点击打开上下文菜单，然后点击 **生成项目文件（Generate Project Files）** 以重新生成Visual Studio解决方案。
|
||
|
||
新的解决方案文件将默认启用该插件。
|
||
|
||
## 验证你的JDK环境变量
|
||
|
||
从虚幻引擎5.3开始，AGDE和虚幻引擎需要 **OpenJDK 17.0.6 2023-01-17** 作为JDK目标版本。如果你使用全新安装的Android Studio和虚幻引擎5.3及更高版本，则无需执行其他步骤，因为UE的 [Android SDK设置流程](https://dev.epicgames.com/documentation/unreal-engine/advanced-setup-and-troubleshooting-guide-for-using-android-sdk) 会自动设置此JDK版本。如果你是从较早的UE版本迁移，则执行以下步骤：
|
||
|
||
1. 打开 **系统设置（System Settings）** ，并点击 **环境变量（Environment Variables）** 。
|
||
2. 如果你看到名为 `AGDE_JAVA_HOME` 的环境变量，删除它。
|
||
3. 确保 `JAVA_HOME` 指向 `C:\Program Files\Android\Android Studio\jbr` 。
|
||
|
||
如果你需要维护较早虚幻引擎版本的安装，请参阅 [设置Android SDK和NDK](https://dev.epicgames.com/documentation/unreal-engine/advanced-setup-and-troubleshooting-guide-for-using-android-sdk) ，了解有关如何在UE中手动定位SDK路径的信息。If you are working with an earlier version of Unreal Engine, refer to the documentation for that version.
|
||
|
||
## 使用AGDE启动项目
|
||
|
||
AGDE可以调试或附加到你的Android设备上的虚幻引擎应用程序。这需要你在Visual Studio中设置一些配置选项，还需要在使用AGDE之前打包APK，因为它可以编译你的Android项目的代码，但无法烘焙内容。执行以下步骤，在你的设备上启动项目。
|
||
|
||
1. 使用 **BuildCookRun** 命令为Android打包你的项目。你还可以使用 **Turnkey** 或 **虚幻编辑器（Unreal Editor）** 中的 **平台（Platforms）** 下拉菜单。
|
||
|
||
请参阅"构建操作"和"烘焙内容"，详细了解烘焙和打包过程。
|
||
2. 打开你的项目的Visual Studio解决方案。
|
||
3. 将你的 **解决方案配置（Solution Configuration）** 设置为 **DebugGame** ，并将你的 **解决方案平台（Solution Platform）** 设置为 **Android** 。
|
||
4. 使用数据线将你想测试的Android设备插入计算机。设备会询问你授予USB调试权限或计算机访问设备数据的权限，此时请授予权限。
|
||
使用USB连接时，确保计算机上的数据线和端口都支持数据。
|
||
5. 用于构建和调试项目的按钮现在应该显示设备的名称。点击它或按 **F5** 开始调试。你可能需要等待调试器。
|
||
如果你遇到SIGILL错误，请按F5跳过错误并继续运行AGDE。
|
||
|
||
项目将在你的设备上构建和启动，并且你将能够像使用Windows应用程序那样使用Visual Studio的调试工具。
|
||
|
||
## 将AGDE附加到应用程序
|
||
|
||
要附加到虚幻引擎应用程序的运行中实例，请执行以下步骤：
|
||
|
||
1. 点击工具栏中的 **调试（Debug）** 下拉菜单，然后点击 **附加到进程（Attach to Process）** 。
|
||
附加到进程"" loading="lazy" />
|
||
2. 将 **连接类型（Connection Type）** 设置为 **Android游戏开发扩展（Android Game Development Extension）** 。
|
||
3. 点击 **连接目标（Connection Target）** 下拉菜单，然后点击你的设备的条目。
|
||
4. 选择你的应用程序的进程，然后点击 **附加（Attach）** 。
|
||
|
||
|
||
## 错误调试
|
||
|
||
本章节针对在调试AGDE时可能出现的问题提供了修复和错误调试方面的提示。
|
||
|
||
### 修复Android 14设备上的断言
|
||
|
||
AGDE在Android 14设备上运行时，可能会抛出断言。要修复此断言，请按以下步骤操作：
|
||
|
||
1. 在Visual Studio中打开项目的 **配置属性（Configuration Properties）** 并点击 **调试（Debugging）** 。
|
||
2. 在LLDB Post Attach Commands中，添加以下行：
|
||
LLDB Post Attach Commands
|
||
```cpp
|
||
process handle --pass true --stop false --notify true SIGBUS
|
||
```
|
||
[Under Configuration Properties > Debugging, fill LLDB Post Attach Commands with the text above.](https://dev.epicgames.com/documentation/404)
|
||
|
||
## 更多信息
|
||
|
||
有关AGDE的功能的更多信息，请参阅以下文档：
|
||
|
||
- **概述（Overview）** ： [https://developer.android.com/games/agde](https://developer.android.com/games/agde)
|
||
- **项目配置（Project Configuration）** ： [https://developer.android.com/games/agde/adapt-existing-project](https://developer.android.com/games/agde/adapt-existing-project)
|
||
- **调试人员指南（Debugger Guide）** ： [https://developer.android.com/games/agde/debugger](https://developer.android.com/games/agde/debugger)
|
||
- **分析（Profiling）** ： [https://developer.android.com/games/agde/measure](https://developer.android.com/games/agde/measure) |