# @callstack/react-native-visionos 中文文档

规范地址：https://npmcn.com/package/%40callstack/react-native-visionos/

版本：0\.79\.6
npm 元数据更新时间：2026-11-06T13:30:27.965Z
中文译文更新时间：2026-11-09T00:07:58.638Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40callstack/react-native-visionos
原文对照：https://npmcn.com/package/%40callstack/react-native-visionos/?lang=original
项目主页：https://reactnative.dev/
源码仓库：https://github.com/callstack/react-native-visionos

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：19.2 MB，3995 个文件
- TypeScript 类型：包内自带
- Node.js 要求：\>=18
- 运行依赖：36 个
- peer 依赖：react ^19\.0\.0，@types/react ^19\.0\.0
- 首次发布：2023-11-27T20:20:43.771Z
- 最新版本发布：2025-08-23T15:48:52.195Z
- 近 30 天下载量：18115（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：38（近 12 个月 0 个）

## 中文简介

视觉OS 原生反应

## 安装

```sh
npm install @callstack/react-native-visionos
```

也可以使用：`pnpm add @callstack/react-native-visionos`、`yarn add @callstack/react-native-visionos`、`bun add @callstack/react-native-visionos`

## README

[![React Native visionOS](https://github.com/user-attachments/assets/1298cfb6-7648-4b80-aecf-6f40c7b1a5c8)](https://www.callstack.com/open-source?utm_campaign=generic&utm_source=github&utm_medium=referral&utm_content=react-native-visionos)

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

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

![Screenshot](https://github.com/callstack/react-native-visionos/assets/52801365/0fcd5e5f-628c-49ef-84ab-d1d4675a011a)

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

跟着 [开始](https://callstack.github.io/react-native-visionos-docs/category/getting-started) 向导。 如果您希望快速启动, 您可以使用此命令 :

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

## 页:1

反应原生视觉OS文件全文可见于我们 [网站](https://callstack.github.io/react-native-visionos-docs)。 。 。 .

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

## 捐款

先决条件:

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

检查出来 `rn-tester` [读取](https://npmcn.com/package/%40callstack/react-native-visionos/packages/rn-tester/README.md) 从源头构建回声原生.

记住要用 `RNTester-visionOS` 目标

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

## 释放过程

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

用法 :

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

为了测试我们使用的发布和模板 [韦尔达克西奥](https://verdaccio.org/)。 。 。 .

## 常见问题

### @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 和提交记录判断。