让开源，少一点语言距离。
npm包中文文档

@callstack/react-native-visionos

中文文档
0.79.6发布于 2025/08/23MITTypeScript近 30 天下载 1.8万

视觉OS 原生反应

中文使用文档
中文原文
文档目录4 节
  1. 建设您的第一个空间反应原生应用程序
  2. 页:1
  3. 捐款
  4. 释放过程
React Native visionOS

学过一次,在任何地方写作:
用React构建空间应用.

React Industrial visionOS允许您在对SDK平台的全力支持下写出visionOS. 这是主存储器的全叉子,有支持视觉OS所需的修改.

Screenshot

建设您的第一个空间反应原生应用程序

跟着 开始 向导。 如果您希望快速启动, 您可以使用此命令 :

npx @callstack/react-native-visionos@latest init YourApp

页:1

反应原生视觉OS文件全文可见于我们 网站。 。 。 .

React Industrial visionOS文档和网站的源头是单独的Repo,@callstack/react-native-visionos-docs.

捐款

先决条件:

  • 下载最新的Xcode( 至少15.2)
  • 安装 CMake 的最新版本( 至少 v3.29. 0)

检查出来 rn-tester 读取 从源头构建回声原生.

记住要用 RNTester-visionOS 目标

若为 RNTester-visionOS 方案不会显示, 请点击“ 新方案” , 此方案应预先使用 RNTester-visionOS。使用 Xcode 构建应用程序.

释放过程

我们用一个剧本 oot-release.js 自动释放 visionos 软件包,并将依赖性版本与 React 原生核心对齐.

用法 :

node ./scripts/oot-release.js --new-version "<visionos-version>" --react-native-version "<react-native-version>" --one-time-password "<otp>"

为了测试我们使用的发布和模板 韦尔达克西奥。 。 。 .

版本与发布记录

@callstack/react-native-visionos 共发布 38 个版本，首次发布于 2023/11/28；过去 12 个月发布了 0 个版本。

版本发布日期距今
0.79.6latest2025/08/231.2 年前
0.78.02025/03/031.7 年前
0.77.02025/01/241.8 年前
0.77.0-rc.1next2025/01/071.8 年前
0.77.0-rc.02024/11/271.9 年前
0.76.22024/11/182 年前

其他发布通道：0.73-stable → 0.73.12，next → 0.77.0-rc.1。

关于 @callstack/react-native-visionos 的常见问题

@callstack/react-native-visionos 是什么？

视觉OS 原生反应

如何安装 @callstack/react-native-visionos？

在项目目录运行 npm install @callstack/react-native-visionos，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（^19.0.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。它还提供命令行工具 react-native，可以用 npx react-native 直接运行。

@callstack/react-native-visionos 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

@callstack/react-native-visionos 需要什么版本的 Node.js？

package.json 的 engines 字段要求 Node.js >=18。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

@callstack/react-native-visionos 可以商用吗？

@callstack/react-native-visionos 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

@callstack/react-native-visionos 的下载量有多少？

根据 npm 官方下载统计，@callstack/react-native-visionos 在 2026/10/09 – 2026/11/07 这 30 天内被下载 18,115 次，日均约 604 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

@callstack/react-native-visionos 还在维护吗？

最新版本 0.79.6 发布于 2025/08/23（1.2 年前）；至今共发布 38 个版本，其中过去 12 个月发布了 0 个；首次发布于 2023/11/28。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。