修复调试问题

开放Beta测试文档 作为预发布开放Beta测试的一项内容，亚马逊提供了此技术文档。随着亚马逊收到反馈并对功能进行迭代，所描述的这些功能可能会发生变化。有关最新功能的信息，请参阅发行说明。

此页面旨在帮助您解决在使用Vega Studio调试Vega应用时可能出现的常见问题。如果您在此处找不到特定问题的解决方案，请在开发者论坛中发布问题以获得更多支持。

应用在调试过程中意外终止，导致调试会话中断

原因： 生命周期管理器 (LCM) 会终止不发送心跳信号的应用。断点会暂停您的应用，从而阻止心跳信号，甚至导致终止。

解决方案： 验证您的设备是否支持禁用超时设置。

在设备的shell中，运行以下代码：
```
vlcm --help
```
在调试命令输出中查找--disable-app-timeout标记。

警告： 如果您没有看到--disable-app-timeout标记，请更新您的SDK并检查操作系统是否有更新。
使用以下选项之一防止应用终止：

选项1：使用Vega Studio（推荐）

a. 打开您的launch.json文件。 b.添加disableAppTimeout设置或将其改为true：
```
  {
   "name": "(script) Launch",
   "type": "kepler",
   "request": "launch",
   "disableAppTimeout": true
  }
```
c. 保存并重新启动调试会话。

警告： 这仅适用于Launch请求，不适用于Attach请求。要进行连接调试，请使用CLI方法。

选项2：使用Vega CLI

a. 为您的组件禁用超时设置：
```
vlcm debug <组件ID> --disable-app-timeout
```
b. 启动您的应用：
```
kepler device launch-app --appName <组件ID>
```

c. 在Vega Studio中附加调试器。

使用以下选项之一进行调试后，重新启用超时设置：
- Vega Studio：正常启动应用（无需进行调试配置）
- Vega CLI：运行vlcm debug <组件ID> --clear，然后启动应用
有关启动应用的信息，请参阅运行您的应用。

启动和调试Vega和Turbo模块应用的示例模板：

{
    // 使用IntelliSense了解可能的属性。
    // 悬停鼠标可查看现有属性的描述。
    // 有关更多信息，请访问：https://go.microsoft.com/fwlink/?linkid=830387
    "version": "0.2.0",
    "configurations": [
        {
            "name": "(script) Launch",
            "type": "kepler",
            "request": "launch",
            "keplerMode": "debug",
            "cwd": "${workspaceFolder}",
            "deviceId": "${command:kepler.state.getSelectedDeviceId}",
            "disableAppTimeout": true,
            "perf": {
                "startActivityMonitoring": false
            }
        },
        {
            "name": "(native) Launch",
            "type": "keplerNative",
            "request": "launch",
            "cwd": "${workspaceFolder}",
            "deviceId": "${command:kepler.state.getSelectedDeviceId}",
            "disableAppTimeout": true
        }
    ]
}

GDB本机调试错误：找不到liblzma.5.dylib

错误：

{Starting: "/usr/local/bin/gdb" --interpreter=mi
dyld[57162]: Library not loaded: /usr/local/homebrew/opt/xz/lib/liblzma.5.dylibReferenced from: <5BAC9301-8CA6-3EA3-9537-CD0E961C0FAB> /usr/local/bin/gdbReason: tried: '/usr/local/homebrew/opt/xz/lib/liblzma.5.dylib' (no such file), '/System/Volumes/Preboot/Cryptexes/OS/usr/local/homebrew/opt/xz/lib/liblzma.5.dylib' (no such file), '/usr/local/homebrew/opt/xz/lib/liblzma.5.dylib' (no such file)"/usr/local/bin/gdb" exited with code 134 (0x86).ERROR: Unable to start debugging.Unable to establish a connection to GDB. }

原因： GDB找不到所需的XZ压缩库 (liblzma.5.dylib)，此压缩库是本机调试的依赖项。

解决方案： 安装或重新安装XZ库：

安装XZ库：
已复制到剪贴板。
```
brew install xz
```
如果已经安装，请尝试重新安装：
已复制到剪贴板。
```
brew reinstall xz
```
验证符号链接：
已复制到剪贴板。
```
brew link xz
```
如果问题仍然存在，请尝试以下其他步骤：
清除Homebrew缓存：
已复制到剪贴板。
```
brew cleanup
```
更新Homebrew：
已复制到剪贴板。
```
brew update && brew upgrade
```

其他注意事项

已安装最新版本的Homebrew。
某些macOS版本可能需要针对GDB进行额外的安全配置。
访问压缩库位置所需的权限。

Last updated: 2025年9月30日

修复调试问题

应用在调试过程中意外终止，导致调试会话中断

GDB本机调试错误：找不到liblzma.5.dylib

相关主题