as

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

安装脚本下载失败

原因: 网络限制、企业防火墙阻止下载,或DNS解析问题导致无法访问sdk-installer.vega.labcollab.net。解决方案:
  1. 检查网络连接:
  2. 如果企业防火墙阻止下载,请联系您的IT部门将该域名列入许可名单。
  3. 请确认您在Ubuntu上使用的是否是Snap版本的curl(此版本存在沙盒限制):
    如果显示快照路径,请安装原生curl:
  4. 重试SDK安装 重新运行安装Vega SDK中的安装命令。

在系统引导初始化阶段,SDK安装失败。

原因: 在安装Vega CLI后,系统会自动下载SDK,在此期间出现网络连接、防火墙限制或权限不足问题。解决方案:
  1. 检查网络连接:
  2. 如果企业防火墙阻止下载,请联系您的IT部门将该域名列入许可名单。
  3. 请确认您在Ubuntu上使用的是否是Snap版本的curl(此版本存在沙盒限制):
    如果显示快照路径,请安装原生curl:
  4. 重新运行安装Vega SDK中的安装命令。

无法下载Vega CLI

原因: 网络限制、企业防火墙阻止下载,或者存在安装脚本访问权限问题,导致无法安装CLI二进制文件。解决方案: 使用传统的引导程序设置: 安装Vega SDK

Homebrew安装

尝试安装Homebrew时,您可能会看到以下消息:
原因: 您可能没有管理员权限,或者未根据系统架构将Homebrew安装到正确目录中。解决方案: 确保拥有Administrator权限,然后完成以下操作:
  1. 禁用Rosetta。
  2. 按照Homebrew页面中的说明安装brew。
  3. 验证brew是否在您的PATHPATH上。
    路径应该是: arm64: 在下/opt/homebrew/bin/brew方安装 Homebrew。 x86_64: 在下/usr/local/bin/brew方安装 Homebrew。
  4. 在**.profile/.rc**文件中正确设置HOMEBREWHOMEBREW变量。 arm64:
    x86_64:
  5. 更新您的brew软件包。

SDK下载错误

原因: 下载网址可能未正确生成。解决方案: 重新加载页面。如果重新加载页面后问题仍然存在,请在Vega社区空间中发布问题。

安装SDK期间出现平台不匹配错误。

原因: Vega SDK安装程序与您的系统架构不适配。您使用的是M系列Mac (arm64) 架构,但下载的是Intel Mac (x86_64) 版本。解决方案:
  1. 验证您的终端是否在Rosetta下运行:
    • 在M系列Mac上,如果返回x86_64,则说明您的终端运行在Rosetta环境中。
    • 在M系列Mac上,如果返回arm64,则说明您的终端运行在原生环境中。
  2. 如果您的终端已启用Rosetta,请将其禁用: a. 完全退出Terminal/iTerm b. 右键点击“应用程序”中的Terminal.app(或iTerm.app) c. 选择Get Info(显示简介) d. 如果已启用Open using Rosetta(使用Rosetta打开),请取消勾选 e. 重新打开Terminal并使用uname -m进行验证(应显示arm64)
  3. 重新运行安装命令:
  4. 确认安装脚本准确识别到您设备的原生架构。

升级到macOS 27后Vega工具出现故障

原因: 从macOS 26升级到macOS 27会移除多个Vega DevKit组件所依赖的Rosetta。这可能会使原生调试和VDA等工具处于损坏状态。新安装的SDK不会受到影响,因为它们会在安装过程中将Rosetta作为依赖项安装。解决方案: 重新安装Rosetta,然后重启终端:
也可以在Install the Vega SDK(安装Vega SDK)页面上重新安装Rosetta,作为完整依赖项步骤的一部分。

安装期间下载失败

如果下载期间发生安装进程中止或失败,您可能会看到:
  • 安装停滞且无进度。
  • 网络相关错误消息。
  • 未完成的下载通知。
原因: 下载期间出现网络问题。解决方案:
  1. 按Command+C (Mac) 或Ctrl+C (Linux) 终止安装。
  2. 连接至可靠网络。
  3. 恢复SDK安装 返回安装Vega SDK页面。
  4. 重新运行安装程序。

磁盘空间不足导致安装失败

原因: 设备可用存储空间不足。解决方案:
  1. 释放磁盘空间。
  2. 清理磁盘空间后,确认可用空间至少剩余20GB。
  3. 重新运行安装程序。

SDK安装完成

原因: 安装程序已在指定安装路径下检测到SDK目录。出现这种情况的原因有:
  • 存在之前安装的版本。
  • 之前安装失败但未删除文件。
  • 多次尝试过安装。
解决方案:选项1: 覆盖现有安装版本:
  1. 当提示替换所有现有文件时,输入yy。
选项2: 进行纯净安装:
  1. 将现有文件夹备份到其他位置。
  2. 使用删除旧的安装程序。
  3. 重新运行安装程序。

相关主题


最后修改于 2026年9月23日