System Requirements
Windows Development Dependencies
You can run React-Native for Windows apps only on Windows 10 devices with Windows version: 10.0.16299.0 (aka 1709, aka Redstone 3, aka Fall Creators Update) or higher. Some features may not work on all versions. See Windows 10 Compatibility for version support details.
To develop React-Native for Windows apps, you need to install several dependencies.
Script to check and install all dependencies
To check or install dependencies, run the script rnw-dependencies.ps1
in an elevated PowerShell window.
Run this command:
Start-Process -Verb RunAs powershell -ArgumentList @("-command", "iex ((New-Object System.Net.WebClient).DownloadString('https://aka.ms/rnw-vs2019-deps.ps1'))")
Manual setup
Alternatively, you can setup your environment manually:
- Ensure Developer Mode is turned ON in Windows Settings App.
- Install Visual Studio 2019 with the following options checked:
- Workloads
- Universal Windows Platform development
- Desktop development with C++
- Individual Components
- Development activities
- Node.js development support (optional)
- Development activities
- Workloads
React Native Development Dependencies
Install the standard React Native dependencies
Install Node.js via one of the following methods:
- Using Chocolatey (React Native recommended). To use chocolatey, from an elevated Command Prompt, run:
choco install nodejs.install --version=12.9.1
- Directly from Node.js
- By selecting the "Node.js development support" component in the Visual Studio 2019 installer (above)
For both of the non-chocolatey installations, ensure that you are installing version 12.9.1 as that is the recommended version when building React Native Windows apps.
Install Chrome (optional, but needed for JS debugging)
Install Yarn (optional if only consuming react-native-windows, but required to contribute to react-native-windows)
Troubleshooting
- If after running the app, the packager does not update (or) app does not show React Native content - close the packager command prompt window and the app, make sure browser is open, run
yarn start
and run the app from Visual Studio again. - If you get a red error box in your UWP app window with the error message :
ERROR: Instance failed to start. A connection with the server cannot be established
, make sure you have the packager running usingyarn start
and run the app again.