as

Settings
Sign out
Notifications
Alexa
亚马逊应用商店
Ring
AWS
文档
Support
Contact Us
My Cases
新手入门
设计和开发
应用发布
参考
支持
原生
Skip to main content
本页可帮助您解决在VS Code中使用Vega Studio构建和运行应用时的常见问题。如果您在此处找不到特定问题的解决方案,请在开发者论坛中发布问题以获得更多支持。

端口转发失败并出现“operation unsuccessful”(操作不成功)错误消息

原因: 当Vega虚拟设备未运行时,会发生此错误。 解决方案:
  1. 前往Vega Studio > 设备。
  2. 如果它显示VirtualDevice:Tv (Not running),请转到项目部分,然后单击项目名称旁边的播放按钮。

在VS Code中加载网页视图时出错

使用VS Code时,您的屏幕可能会显示以下消息:
原因: 当打开VS Code的多个实例时,会发生此错误。 解决方案: 退出所有已打开的VS Code实例,然后重新启动。

创建新项目时React Native Tools扩展无法激活

创建新项目时,您可能会收到以下错误消息:
原因: VS Code工作区配置问题阻碍了React Native Tools扩展的正确加载。 解决方案: 在VS Code工具栏中(文件 > Open Workspace from File [从文件打开工作区])将您的项目作为工作区打开,然后另存为新工作区。

尝试启动应用时React Native打包器已经在运行

尝试启动应用时,您会看到以下错误:
原因: 当您有一个多项目工作区并且有应用当前正在运行时,就会出现这个问题。 解决方案: 在启动其他应用之前停止打包器。在VS Code命令面板中,输入React Native: Stop Packager。

React Native Tools打包器在选择错误的项目后变得没有响应

当运行多个项目并意外地在RN打包器中选择了错误的项目名称时,React Native: Stop Packager命令变为禁用状态。 原因: 当选择了错误的项目时,React Native Tools扩展会丢失对当前打包器进程的跟踪。 解决方案: 从命令面板重新加载VS Code窗口。
  1. 按Ctrl+Shift+P (Linux) 或Cmd+Shift+P (Mac) 打开命令面板。
  2. 输入Developer: Reload Window。
  3. 选择重新加载VS Code的命令。
  4. 重新启动项目的打包器。

选择模板时不显示任何项目模板

原因: Vega SDK中的环境变量未正确加载到当前VS Code会话中。 解决方案: 要加载Vega SDK环境变量,请运行以下命令,然后使用code从同一终端打开VS Code:

由于端口冲突,构建或启动失败

原因: 另一个进程是使用所需的端口。 解决方案: 要解决端口冲突,请在VS Code中设置不同的React Native端口。有关步骤,请参阅 使用Vega Studio构建应用中的“步骤3:(可选)配置自定义端口”。

更改代码时,快速刷新功能不更新应用

原因: 端口转发连接问题阻止快速刷新功能与设备通信。 解决方案: 重置反向端口转发连接并重新启动应用:
  1. 列出当前的反向端口转发规则:
  2. 删除所有反向端口转发规则:
  3. 重新启动您的应用。

逐行调试不起作用

原因: 未配置开发者模式,或者shared_preferences.json中缺少调试主机设置。 解决方案: 要解决此问题,请验证开发者模式并查看shared_preferences.json。有关详细信息,请参阅在Fire TV Stick上配置开发者模式。 要在自定义端口上启用逐行调试,请在设备上的/data/shared_preferences.json文件中添加以下配置:
将替换为您正在使用的端口号。

构建失败并报错“缺失 [os.version]”

构建应用时,您会看到以下错误:
原因: 自Vega SDK 0.24版本起,manifest.toml中必须含有 [os.version] 部分。在此要求生效前创建的现有项目不包含该配置。 解决方案: 在项目根目录下运行下列命令,然后重新构建:
您也可以手动添加该部分到manifest.toml中:
对于SDK 2.0,推荐设置为min = "2.0"。有关何时改用1.2,请参阅选择最小值。 请勿将操作系统版本模块条目 (/com.amazon.vega.os@IVega_*) 添加到您的源manifest.toml中。构建会从[os.version]生成它们。有关详细信息,请参阅清单 [os.version] 部分。 要将现有应用升级到目标OS 2.0,同时继续支持OS 1.2,请参阅升级应用的操作系统版本兼容性。如果您的应用是使用SDK 0.23或更早版本构建的,请参阅从 SDK 0.23 或更早版本迁移。

相关主题


最后修改于 2026年10月23日