as

Settings
Sign out
Notifications
Alexa
亚马逊应用商店
AWS
文档
Support
Contact Us
My Cases
新手入门
设计和开发
应用发布
参考
支持

修复Vega SDK问题

修复Vega SDK问题

此页面可帮助您解决Vega SDK的常见问题。如果您在此处找不到特定问题的解决方案,请在开发者论坛中发布问题以获得更多支持。


Homebrew安装

尝试安装Homebrew时,您可能会看到以下消息。

Homebrew: error while attempting to install Homebrew:...
==> Running in non-interactive mode because `$NONINTERACTIVE` is set.==> Checking or `sudo` access (which may request your password)...
Need sudo access on macOS (for example, the user USERNAME needs to be an Administrator)!

原因: 您可能没有管理员权限,或者未根据系统架构将Homebrew安装到正确目录中。

解决方案: 确保拥有管理员权限,然后完成以下操作:

  1. 禁用Rosetta。

  2. 按照Homebrew页面中的说明安装brew。

  3. 在您的PATH上查找brew。

    已复制到剪贴板。

     which brew
    

    路径应该是:

    arm64: 将Homebrew安装到/opt/homebrew/bin/brew之下。

    x86_64: 将Homebrew安装到/usr/local/bin/brew之下。

  4. .profile/.rc文件中正确设置HOMEBREW变量。

    arm64:

    已复制到剪贴板。

    eval $(/opt/homebrew/bin/brew shellenv)
    

    x86_64:

    已复制到剪贴板。

     eval $(/usr/local/bin/brew shellenv)
    
  5. 检查您的brew程序包是否为最新版本。

    已复制到剪贴板。

    brew upgrade
    

SDK下载错误

Failed to load the SDK installation interface

原因: 生成下载URL时可能出现问题。

解决方案: 重新加载页面。如果重新加载页面后问题仍然存在,请在Vega社区空间中发布问题。

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

Download succeeded [OK]
Installing Vega SDK <版本>.This takes 5 minutes.
Installation failed [X]
[X] Vega SDK for darwin-x86_64 is incompatible with current darwin-aarch64

原因: Vega SDK安装程序与您的系统架构不适配。

例如: 您使用的是M系列Mac (arm64) 架构,但下载的是Intel Mac (x86_64) 版本。

解决方案:

  1. 返回安装Vega SDK页面。
  2. 选择与计算机适配的平台。
  3. 获取新安装命令。
  4. 重新运行安装程序。

安装期间下载失败

如果下载期间发生安装进程中止或失败,您可能会看到:

  • 安装停滞且无进度。
  • 网络相关错误消息。
  • 未完成的下载通知。

原因: 下载期间出现网络问题。

解决方案:

  1. Command+C (Mac) 或Ctrl+C (Linux) 终止安装。
  2. 连接至可靠网络。
  3. 返回安装Vega SDK页面。
  4. 重新运行安装程序。

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

Vega Error:  Installation failed: [Errno 28] No space left on device

原因: 设备可用存储空间不足。

解决方案:

  1. 释放磁盘空间。
  2. 清理磁盘空间后,确认可用空间至少剩余20GB。
  3. 重新运行安装程序。

SDK安装完成

Directory found at /Users/<用户>/kepler/sdk/<版本>.Remove? [y/N]:

原因: 安装程序已在指定安装路径下检测到SDK目录。出现这种情况的原因有:

  • 存在之前安装的版本。
  • 之前安装失败但未删除文件。
  • 尝试过多次安装。

解决方案:

选项1: 覆盖现有安装版本:

  1. 按照提示输入y,允许安装程序替换现有全部文件。

选项2: 进行纯净安装:

  1. 将现有文件夹备份到其他位置。
  2. 使用rm -rf<安装路径>移除旧版本。
  3. 重新运行安装程序。

“打开的文件过多”错误

在构建应用时,您可能会收到一条错误消息,该消息指出打开的文件过多:

node:events:495
throw er; // 未处理的'error'事件
^
Error: EMFILE: too many open files, watch
at FSWatcher._handle.onchange (node:internal/fs/watchers:207:21)
Emitted 'error' event on NodeWatcher instance at:
at FSWatcher._checkedEmitError (/Users/username/keplersampleapp/node_modules/metro-file-map/src/watchers/NodeWatcher.js:134:12)
at FSWatcher.emit (node:events:517:28)
at FSWatcher._handle.onchange (node:internal/fs/watchers:213:12) {
errno: -24,
syscall: 'watch',
code: 'EMFILE',
filename: null
}

原因: 此错误是由于Watchman的已知问题造成的,该问题会影响Mac M1用户。Watchman是Metro bundler使用的文件监视系统。

解决方案: 要解决此问题,请重新安装Watchman:

已复制到剪贴板。

brew reinstall watchman
watchman shutdown-server; watchman watch-del-all; watchman

node_api.h file not found

原因: 您可能移除了对turbomoduleAPI程序包的find_packagetarget_link_libraries调用。

解决方案:

  1. 确保CMakeLists.txt文件含有下列行:

    • find_package (turbomoduleAPI REQUIRED)
    • target_link_libraries (…turbomoduleAPI::turbomoduleAPI…)
  2. 重建项目。

缺少Turbo模块注册内容导致应用崩溃

"TurboModuleRegistry.getEnforcing(...): '[module]' could not be found" error.

原因: Turbo模块未正确注册,因此应用无法在运行时找到它。

解决方案:

  1. 清理并重建:

    a. 清理Turbo模块项目中的dist文件夹。

    b. 执行Turbo模块项目纯净构建。

    c. 执行应用项目纯净构建。

  2. 验证自动链接:

    a. 检查react-native.config.js是否存在。

    b. 确保自动链接设置正确。


Last updated: 2025年10月31日