解决Vega虚拟设备问题

本页提供常见的Vega虚拟设备 (VVD) 问题的解决方案。如果您在此处找不到特定问题的解决方案，请在开发者论坛中发布问题以获得更多支持。

基于Webview的Vega应用在Ubuntu上运行失败

Module dependency not found: /com.amazon.vega.webview_3@IWebview_3

原因：

VVD不支持在Ubuntu或基于Intel的Mac平台上运行Webview。

解决方案：

使用Apple Silicon Mac（M1、M2、M3、M4）或Fire TV 4K Select进行Webview应用测试。

替代方案： 考虑使用Vega SDK，这样可以在所有平台上提供全面的虚拟设备支持。

VVD启动后崩溃

原因：

以下因素可能会干扰VVD启动：

• 某些USB集线器或扩展坞

• 某些音频接口（如Focusrite 2i2）同时用于输入和输出时

解决方案：

对于USB或扩展坞干扰：

1. 断开所有USB集线器与主机的连接。
2. 断开所有扩展坞与主机的连接。
3. 重启VVD。

对于音频接口崩溃（启动后10-20秒发生）：

1. 可以使用音频接口进行输入或输出，但不能输入输出同时进行。
2. 或者，在运行VVD时临时使用不同的设备输入和输出。

无法为亚马逊服务注册VVD

原因：

VVD需要先注册，然后才能使用任何亚马逊服务进行测试。如果没有完成注册流程，您的应用将无法在虚拟设备上访问亚马逊服务。

解决方案：

1. 点击右上角的“Register this device”（注册此设备）。
2. 记下屏幕上显示的注册码。
3. 前往www.amazon.com/code并输入验证码。

查找此消息以确认注册：

Your device has successfully been registered

由于内存不足导致VVD崩溃

原因： 当同时运行多个资源密集型进程（例如屏幕、音频和视频录制）时，VVD可能会崩溃。高内存使用量会造成内存压力，导致VVD崩溃。

解决方案： 在VVD运行时检查内存使用情况。

在Mac上：

1. 打开Activity Monitor（Applications（应用程序）> Utilities（实用程序）> Activity Monitor）。
2. 单击Memory（内存）选项卡。

在Linux上：

1. 打开终端。

2. 使用以下命令之一：

   • top（基本系统监视器）
   • htop（如果已安装，更易于使用）
   • free -h（以GB/MB为单位显示内存，而不是以字节为单位）

   复制代码 已复制到剪贴板。

   free -h
             total        used        free
   Mem:       16G         8.2G        4.3G
   

   如果没有-h，输出会以字节为单位显示：

   复制代码 已复制到剪贴板。

   free
             total        used        free
   Mem:    16777216    8388608     4304892
   

如果可用内存小于2GB：

1. 关闭资源密集型进程。
2. 关闭不必要的应用。

3. 重新启动VVD：

   复制代码 已复制到剪贴板。

   vega virtual-device start
   

VVD无法启动

原因：

由于您的Ubuntu系统上禁用了虚拟技术 (KVM)，您会看到有关/dev/kvm上读取或写入权限的错误。

解决方案：

确保您的Ubuntu映像已启用KVM虚拟化技术。如果您将Ubuntu作为虚拟机运行，请前往Settings（设置）> Processors & Memory（处理器和内存）> Advanced options（高级选项），并启用管理程序应用的支持。

设备服务崩溃后应用冻结

原因：

VVD服务崩溃，导致您的应用冻结并变得没有响应。由于VVD中断连接，即使在重新启动服务后，该应用仍处于冻结状态。

解决方案：

1. 停止VVD：

   复制代码 已复制到剪贴板。

   vega virtual-device stop
   

2. 重启VVD：

   复制代码 已复制到剪贴板。

   vega virtual-device start
   

3. 重启应用：

   复制代码 已复制到剪贴板。

   vega device launch-app [应用名称]
   
   // 示例
   vega device launch-app com.example.sampleapp
   

VVD无法连接到互联网

原因：

由于潜在的网络配置问题，VVD无法连接到互联网。

解决方案：

在VVD上打开shell来测试连接性：

vega virtual-device start

vega device shell

ping www.amazon.com

预期输出：

传输了三个数据包，接收了三个数据包，丢包率为0%

找不到kepler-ui-components的模块依赖项

原因：

您的应用使用@amazon-devices/kepler-ui-components，但您在较早的VVD版本上测试，该版本中没有所需的原生模块。每个SDK版本都包含一个VVD映像，其中具有特定的原生操作系统组件。SDK 0.21及更早版本中的VVD版本不包括近期更新中添加的原生模块。

症状：

安装应用时看到以下错误：

error (Module dependency not found): error: Unable to install '/tmp/myapp.vpkg'
as the required dependencies are not found on the device.
The Kepler Virtual Device is missing modules that are available on a physical
device.Test your app using a Fire TV Stick instead.
The following module dependencies declared in the application manifest are
not found:
/com.amazon.kepler.native_ui_components_2@INativeUiComponents_13

解决方案：

升级到最新的SDK（0.22或更高版本）：

vega sdk install

最新SDK包括最新的VVD，其中包含所有必需的原生模块。

如果无法升级，请使用以下替代方法之一：

• 在实体Fire TV Stick 4K Select上进行测试。实体设备会定期更新并包含所有必需的模块。
• 从应用中删除@amazon-devices/kepler-ui-components依赖项，或者将VVD测试限制在不使用用户界面组件的功能范围内。

相关主题

• 在Vega虚拟设备上运行您的应用

Last updated: 2026年2月27日