Vega SDK发布说明

请在此处为您的Vega SDK使用体验评分（仅提供英文版）。

Vega SDK版本0.23

我们很高兴为您带来0.23版本，其中包括对AI和性能工具的更新、错误修复和功能改进。主要更新包括：

• 扩展了MCP服务器 - Amazon Devices Builder Tools服务器增加了SDK安装工作流程、代码审查跟踪和Node.js v24兼容性。新的提示包括用于解决用户界面流畅度问题的AI协助。
• 性能工具更新 - 丢帧指标现在使用更准确的计算方法，Shaka播放器应用的TTFVF指标已恢复。
• 链接器命名空间 - 强制执行链接器命名空间可确保您的应用不会与系统库发生冲突。
• ACR改进 - 报告中现已包含新的崩溃来源属性

公告

kepler CLI命令由vega取代

kepler CLI命令现已弃用。现在，所有工具都使用vega等效命令。为了向后兼容，kepler别名在v0.23中继续有效，但未来的版本将删除它。

需要采取行动： 更新所有脚本、CI管道和工作流程，用vega命令取代了kepler命令。例如，用vega <符号化参数>取代了kepler <符号化参数>。

不再需要KEPLER_SDK_PATH环境变量

您不再需要KEPLER_SDK_PATH来配置Vega SDK。改用Vega SDK管理器来安装和选择特定的SDK版本。

需要采取行动： 从您的shell配置文件、CI脚本和环境设置文件删除export KEPLER_SDK_PATH=...。如果您遇到任何仍然需要它的工具，请提交错误报告。

请参阅Vega SDK管理器

连续丢帧指标方法变更

计算连续丢帧的算法现在使用基于vsync的分段处理，可以生成更精确的流畅度测量值。v0.23中的丢帧次数与早期版本无法相提并论。

需要采取行动： 重新设置任何跟踪连续丢帧的性能控制面板或阈值的基准。

请参阅衡量应用KPI

强制执行链接器命名空间

链接器命名空间是一种运行时库隔离机制，可将共享库组织到单独的链接环境中。动态链接器强制执行命名空间边界，以防止应用绑定库和系统库之间发生冲突，从而确保操作系统更新的稳定性。您的应用只能通过Vega OS公共ABI列表访问系统库，并且必须将第三方依赖项捆绑到应用程序包中。构建时间ABI验证（自SDK 0.22起可用）和运行时强制执行协同工作，可以及早发现问题并保证合规性。这适用于在Vega OS上运行的所有原生代码，包括C/C++库、第三方原生SDK和自定义Turbo模块。有关详细信息，请参阅使用链接器命名空间管理原生库。

已从内容启动器中移除搜索

内容启动器不再支持搜索功能。您可以使用内容启动器进行导航，例如播放、快进等。

新功能

AI辅助诊断和解决用户界面流畅度问题

现在，您可以使用基于提示的解决方案来诊断和修复用户界面流畅性/滚动问题，从而可提出以下问题：

@vega为什么我的应用中的滚动速度很慢？  
@vega改进我的应用流畅度  
@vega给我看看我的滚动代码中的热门函数 
@vega给我看看'xyz'热门函数的堆栈跟踪 

改进

MCP服务器： SDK安装工作流程和Node.js 24

Amazon Devices Builder Tools MCP服务器现在包括用于自动设置的SDK安装工作流程、用于诊断用户界面流畅度问题的AI辅助提示，并兼容Node.js v24（从better-sqlite3迁移到了sqlite3）。

@amazon-devices/vega-devtools-mcp程序包现在为@amazon-devices/amazon-devices-buildertools-mcp。

请参阅设置Vega DevTools MCP服务器

Fire TV上的开发者模式发现通知

Fire TV设备现在会在Settings（设置）> My Fire TV（我的Fire TV）> Developer Options（开发者选项）中显示通知，其中二维码链接到Vega开发者门户，让您可以更轻松地发现和启用开发者模式。

ACR崩溃来源属性

汇总崩溃报告 (ACR) 摘要现在包含的信息可将应用程序代码与系统或框架代码对比，帮助您确定应用程序代码是否导致了崩溃。如果您使用ACR报告，则无需更改任何工作流程即可获得可采取行动的崩溃属性。

请参阅利用ACR摘要进行崩溃调试

VVD登陆板主屏幕

现在，Vega虚拟设备 (VVD) 在启动时显示登陆板主屏幕，在用户界面中直接内置了设备注册功能。您无需离开虚拟设备即可注册您的VVD以进行亚马逊服务测试。

已解决的问题

针对多种设备、WebView的Chrome DevTools调试修复

此版本解决了两个单独的Chrome DevTools (CDT) 问题。当连接了多个设备或模拟器时，CDT无法连接到正确的目标，因为端口转发未指定设备序列号。CDT现在始终以正确的设备为目标。此外，CDT目标选择组合框（用于在ReactNative和WebView调试之间进行选择）没有出现在Vega Studio中，因为WebView npm程序包的范围从@amzn更改成了@amazon-devices，阻碍了程序包解析。这两个问题现已解决。如果您以前必须断开额外设备才能使用CDT，则不再需要这样做。

请参阅Chrome DevTools

已恢复Shaka播放器应用的TTFVF指标

对于使用Shaka播放器的应用，KPI指标“播放器启动时间”和“播放器开始播放第一视频帧”(TTFVF) 显示空值。根本原因是KVA迁移到了Shaka播放器，它不会发出该工具之前所依赖的mediaplayer_create跟踪信息。性能工具已更新，使用了新的Shaka播放器专属轨迹。现在，所有Shaka播放器应用的TTFVF指标都应该是可靠的。

衡量应用KPI

KPI可视化工具月份数字校正

由于JavaScript的零索引月份处理，KPI可视化工具正在生成输出文件夹名称，其月份值减一。一月被标记为月份0，二月标记为月份1，依此类推。此问题已更正为使用1索引月份。请注意，对于任何按月份解析KPI可视化工具输出文件夹名称的脚本或自动化而言，这都是一项重大更改 - 更新月份解析逻辑，预期索引值为1 (1–12)。此修复之前生成的历史输出文件夹将保留不正确的月份值。

衡量应用KPI

Activity Monitor内存显示

Activity Monitor图表中的内存值未按预期以兆字节为单位显示。如果您依靠活动监视器进行内存分析，则现在可以看到准确的MB值。

衡量应用KPI

@amzn/至@amazon-devices/范围迁移造成的问题已解决

在迁移期间，范围迁移工具不再静默地引入破坏性版本升级。迁移器现在会警告您潜在的重大版本更改，但您仍应在运行该工具后手动审核所有更改。

Mac上的内存分析附件修复

修复了Mac上的Vega Studio中出现的Vega Studio无法附加和读取资源的问题，该问题会显示“no shared libraries loaded”（未加载共享库）错误。此问题已得到解决，恢复了基于Mac的开发者的内存分析工作流程。

检测内存泄漏

范围迁移和程序包管理

• 修复了由剩余@amzn/依赖项导致的CLI模板构建失败。
• 解决了Rosetta下的M1 Mac上的kepler-build脚本失败问题。
• KeplerCLI版本集修复了阻止应用在VVD和物理设备中启动的自动链接故障。

开发者工具和调试

• 修复了连接多台设备时的Chrome DevTools (CDT) 连接失败问题。
• 此前@amzn到@amazon-devices的范围更改导致程序包解析失败，现在用于WebView调试的CDT目标选择下拉框现已恢复正常。
• 调试工具和性能工具不再依赖于KEPLER_SDK_PATH。
• bin/tools中的VDA包装器现在可以正确传递参数。
• 由于读取元数据文件时出错，VVD无法启动。此修复恰当地忽略了元数据文件读取错误。SDK v0.23.x中解决了使用kepler命令时VVD启动失败的问题。

已知问题

将Expo依赖锁定为~50.0.0

目前，SDK中约有69个expo-*程序包将其expo上的对等依赖项声明为“*”而不是“~50.0.0”。这允许以静默方式安装不兼容的Expo版本，这可能会导致运行时EventEmitter错误和应用崩溃。修复正在进行中，但在修复发布之前，您必须手动锁定Expo。

需要采取行动： 将"expo": "~50.0.0"添加到您的package.json依赖项中。运行npm run clean然后运行npm install。使用npm ls expo验证只有50.0.x版本可以解析。重建您的应用。

未设置$HOME时SDK Manager安装失败

如果未设置$HOME环境变量，VVM安装将失败。这主要影响CI/CD环境和Docker容器。

解决方法：在运行VVM安装程序之前运行export HOME=$(eval echo ~$USER)。

请参阅Vega SDK管理器

Vega Audio App (VAA) 参考应用在选择图块时崩溃

当您在发行版本中选择图块时，VAA参考应用会崩溃。如果没有VPN，这个问题无法重现。如果您在MRC版本中使用KAA参考应用，请注意这种不稳定性。没有可用的解决方法。

Last updated: 2026年6月18日