编辑

系统要求

您只能在 Windows 上开发 React Native for Windows 应用。您只能在以下设备上运行 React Native for Windows 应用：

• 所有 Windows 11 设备
• 已更新的 Windows 10 设备（详情请参阅Windows 操作系统兼容性）

要开发 React-Native for Windows 应用，您需要安装一些依赖项。

安装开发依赖项

要检查或安装依赖项，请在提升的 PowerShell 窗口中运行脚本 rnw-dependencies.ps1。

运行此命令：启动提升的 PowerShell 窗口并运行

Set-ExecutionPolicy Unrestricted -Scope Process -Force;
iex (New-Object System.Net.WebClient).DownloadString('https://aka.ms/rnw-vs2022-deps.ps1');

手动设置说明

建议使用上述脚本，因为本手册部分的信息可能会过时

或者，您可以手动设置环境

• 确保在 Windows 设置应用中开启了开发人员模式。
• 强烈建议更新 Windows 系统。
• 安装最新版本的Visual Studio 2022，并选中以下选项
  • 工作负载
    • Node.js 开发，或以下替代方案之一
      • 从单个组件安装
        • 开发活动
          • Node.js 开发支持
      • 单独安装 Node.js，请参阅下方选项
    • .NET 桌面开发
    • 使用 C++ 的桌面开发
      • 包含 MSVC v143 - VS 2022 C++ x64/x86 构建工具（最新）（在“可选”下检查）
    • 通用 Windows 平台开发
      • 包含 C++ (v143) 通用 Windows 平台工具（在“可选”下检查）
  • 单个组件
    • 包含 Windows 10 SDK (10.0.22621.0)（目标操作系统版本来自此表）
    • 包含 MSVC v143 - VS 2022 C++ ARM64 构建工具（最新）（以针对 ARM64 设备）
• 在 Windows 10 版本 1607 及更高版本中启用长路径.
• 安装最新版本的 .NET 6.0 SDK。

单独安装 Node.js 的选项

• 使用 WinGet（React Native 推荐）。要使用 WinGet，请从提升的命令提示符运行

winget install OpenJS.NodeJS.LTS --version 18.18.0

• 使用其他包管理器，例如 Scoop 或 Node Version Switcher (nvs)
• 直接从 Node.js

强烈建议的可选步骤

• 安装 Yarn（贡献 react-native-windows 必需）
• 使用以下方法安装 git
  • 使用包管理器，例如 WinGet、Chocolatey 或 Scoop
  • 安装 git for Windows
  • 安装 GitHub Desktop

故障排除

• 如果运行应用后，打包器没有更新（或）应用没有显示 React Native 内容 - 关闭打包器命令提示符窗口和应用，确保浏览器已打开，运行 yarn start，然后再次从 Visual Studio 运行应用。
• 如果您的 UWP 应用窗口中出现红色错误框，并显示错误消息：ERROR: Instance failed to start. A connection with the server cannot be established，请确保您正在使用 yarn start 运行打包器，然后再次运行应用。