System Requirements
You can run React-Native for Windows apps only on Windows 10 devices with Windows version: 10.0.15063.0 or higher. See Windows 10 Compatibility for version support details.
To develop React-Native for Windows apps, you will need the following:
Windows Development Dependencies
- Ensure Developer Mode is turned ON in Windows Settings App.
- Install Visual Studio 2019 with the following options:
- Workloads
- Universal Windows Platform development
- Enable the optional
C++ (v141) Universal Windows Platform tools
- Enable the optional
- Desktop development with C++
- Universal Windows Platform development
- Individual Components
- Compilers, build tools and runtimes
MSVC v141 - VS 2017 C++ x64/x86 build tools (v14.16)
MSVC v141 - VS 2017 C++ ARM build tools (v14.16)
- Development activities
- Node.js development support (optional)
- Compilers, build tools and runtimes
- 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)
- 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)
E2E Test
Please refer to Author and Run E2E Test for 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.