vault backup: 2026-04-22 23:13:56

2026-04-22 23:13:56 +08:00
parent 225217d385
commit 148970ad6b
4 changed files with 114 additions and 19 deletions
--- a/.claudian/claudian-settings.json
+++ b/.claudian/claudian-settings.json
@@ -19,11 +19,11 @@
    "scrollDownKey": "s",
    "focusInputKey": "i"
  },
-  "locale": "en",
+  "locale": "zh-CN",
  "providerConfigs": {
    "claude": {
      "safeMode": "acceptEdits",
-      "cliPath": "",
+      "cliPath": "C:\\Users\\loujiajie\\AppData\\Local\\pnpm\\global\\5\\.pnpm\\@anthropic-ai+claude-code@2.1.110\\node_modules\\@anthropic-ai\\claude-code\\cli.js",
      "cliPathsByHost": {},
      "loadUserSettings": true,
      "enableChrome": false,
@@ -42,9 +42,9 @@
      "reasoningSummary": "detailed",
      "environmentVariables": "",
      "environmentHash": "",
-      "installationMethod": "native-windows",
-      "installationMethodsByHost": {},
-      "wslDistroOverride": "",
+      "installationMethodsByHost": {
+        "HIH-D-X41334": "native-windows"
+      },
      "wslDistroOverridesByHost": {}
    }
  },
--- a/.claudian/sessions/conv-1776867797531-2zvbzcnt3.meta.json
+++ b/.claudian/sessions/conv-1776867797531-2zvbzcnt3.meta.json
@@ -1,12 +1,23 @@
 {
  "id": "conv-1776867797531-2zvbzcnt3",
  "providerId": "claude",
-  "title": "https://dev",
+  "title": "1",
  "titleGenerationStatus": "failed",
  "createdAt": 1776867797532,
-  "updatedAt": 1776869006689,
-  "lastResponseAt": 1776869006689,
-  "sessionId": null,
-  "providerState": {},
-  "currentNote": "03-UnrealEngine/Mobile/AGDE 安装笔记.md"
+  "updatedAt": 1776870712307,
+  "lastResponseAt": 1776870712307,
+  "sessionId": "227d238a-c567-44bb-aea1-68b54f566949",
+  "providerState": {
+    "providerSessionId": "227d238a-c567-44bb-aea1-68b54f566949"
+  },
+  "currentNote": "03-UnrealEngine/Mobile/AGDE 安装笔记.md",
+  "usage": {
+    "model": "opus[1m]",
+    "inputTokens": 1,
+    "cacheCreationInputTokens": 2815,
+    "cacheReadInputTokens": 56049,
+    "contextWindow": 1000000,
+    "contextTokens": 58865,
+    "percentage": 6
+  }
 }
--- a/.obsidian/plugins/claudian/data.json
+++ b/.obsidian/plugins/claudian/data.json
@@ -1,5 +1,9 @@
 {
-  "claudeCliPath": "C:\\Users\\loujiajie\\AppData\\Local\\pnpm\\global\\5\\.pnpm\\@anthropic-ai+claude-code@2.1.110\\node_modules\\@anthropic-ai\\claude-code\\cli.js",
+  "providerConfigs": {
+    "claude": {
+      "cliPath": "C:\\Users\\loujiajie\\AppData\\Local\\pnpm\\global\\5\\.pnpm\\@anthropic-ai+claude-code@2.1.110\\node_modules\\@anthropic-ai\\claude-code\\cli.js"
+    }
+  },
  "tabManagerState": {
    "openTabs": [
      {
--- a/03-UnrealEngine/Mobile/AGDE
+++ b/03-UnrealEngine/Mobile/AGDE
@@ -1,7 +1,87 @@
 ---
-title: 未命名
+title: AGDE 调试 Unreal Engine Android 项目指南
 date: 2026-04-22 22:19:13
-excerpt: 
+excerpt: 使用 Android Game Development Extension (AGDE) 在 Visual Studio 中调试 UE Android 项目的完整流程
 tags:
-rating: ⭐
+  - 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）** 下拉菜单。
+	![点击](https://d1iv7db44yhgxn.cloudfront.net/documentation/images/3de0f335-11f3-4185-929d-5226c9b8aa70/packageproject.png)
+	请参阅"构建操作"和"烘焙内容"，详细了解烘焙和打包过程。
+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）** 。
+	![从菜单选择要附加到的进程](https://d1iv7db44yhgxn.cloudfront.net/documentation/images/98d473e8-d081-49e3-82ec-b3e6a048692a/attachtoprocessmenu.png)
+
+## 错误调试
+
+本章节针对在调试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)