Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Adding Win10Compat matrix #3461

Merged
merged 3 commits into from
Oct 21, 2019
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 2 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,10 +29,7 @@ This repository adds support for the [Windows 10 SDK](https://developer.microsof

We are in the process of re-implementing react-native-windows in C++, for better performance, and to better align with the shared C++ react-native core as it evolves. Please see the [Roadmap 2019](blog/Roadmap2019.md) blog for details on this effort and investment roadmap for the upcoming months.

### Latest updates
*Last updated: July 2019*

Both the `current` and `vnext` implementations of `react-native-windows` have been upgraded to support [React Native version 0.59](https://facebook.github.io/react-native/blog/2019/03/12/releasing-react-native-059). Please see the [July 2019 Updates Blog](blog/July2019Updates.md) for all the latest updates!
Please see the [July 2019 Updates Blog](blog/July2019Updates.md) for all the latest updates!

## Quick Links

Expand All @@ -54,7 +51,7 @@ See the official [React Native website](https://facebook.github.io/react-native/

- You can run React Native Windows UWP apps only on Windows 10 devices
- React Native Windows -[current](https://github.com/microsoft/react-native-windows/tree/master/current) supports Windows 10 SDK >= [14393](https://developer.microsoft.com/en-us/windows/downloads/sdk-archive) and Windows 8.1
- React Native Windows -[vnext](https://github.com/microsoft/react-native-windows/tree/master/vnext) currently supports Windows 10 SDK >= [15063](https://developer.microsoft.com/en-us/windows/downloads/sdk-archive)
- React Native Windows -[vnext](https://github.com/microsoft/react-native-windows/tree/master/vnext) currently supports Windows 10 SDK >= [15063](https://developer.microsoft.com/en-us/windows/downloads/sdk-archive). See [Windows 10 Compatability](./win10compat.md) for version support details.
- You can run React Native Windows WPF apps using the [current](https://github.com/microsoft/react-native-windows/tree/master/current) implementation on Windows 7-10 so long as .NET 4.6 is installed on the end user's machine
- Download [Visual Studio 2017 Community or Greater](https://www.visualstudio.com/downloads/). (Visual Studio 2015 support has been deprecated.)
- You will need to start Visual Studio after it is installed to do some final setup before it can be used to build or run your React Native Windows application
Expand Down
2 changes: 1 addition & 1 deletion vnext/docs/GettingStarted.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
This is a summary of setup steps needed to install and work with React Native for Windows (vnext). See the [React Native Getting Started Guide](http://facebook.github.io/react-native/docs/getting-started.html) for React Native details and see [Getting Started Guide - current](https://github.com/microsoft/react-native-windows/blob/master/current/docs/GettingStarted.md) for working with the `current` React Native for Windows implementation.

## System requirements
* You can run React-Native for Windows10 apps only on Windows 10 devices and Windows version: 10.0.15063.0 or higher.
* You can run React-Native for Windows10 apps only on Windows 10 devices and Windows version: 10.0.15063.0 or higher. See [Windows 10 Compatability](./win10compat.md) for version support details.
* [Visual Studio 2019](https://www.visualstudio.com/downloads) with the following options:
* Workloads
* Universal Windows Platform development
Expand Down
13 changes: 13 additions & 0 deletions vnext/docs/win10compat.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
# Backward compatibility with Windows versions

React Native for Windows vnext supports Windows 10 devices and OS versions 10.0.15063 and higher. React Native for Windows layers cleanly on top of the [native Windows UI platform](https://github.com/microsoft/microsoft-ui-xaml) which means there are some APIs that may not be supported in all versions of Windows since the corresponding native capabilities were not backward compatible with older OS versions. The following table captures these deltas. If you are using any of the APIs below, they will gracefully fail (no-op) when the app is running on Windows 10 devices of corresponding OS versions.

_Note : There is an ongoing effort to decouple the Windows UI platform from the UWP SDK and ship out of band – [WinUI 3.0](https://github.com/microsoft/microsoft-ui-xaml/blob/master/docs/roadmap.md#winui-3-q4-2019---2020). React Native for Windows vNext will layer on top of this lifted WinUI platform once it is available at which time several of the below unsupported APIs may start lighting up._

| [Windows 10 SDK](https://developer.microsoft.com/en-us/windows/downloads/sdk-archive) | React Native for Windows vnext support |
|:-:|-|
| __May 2019 update__<br> Version-1903 ; Build-10.0.18362.1 | __All APIs, scenarios supported__ |
| __October 2018 update__<br> Version-1809 ; Build-10.0.17763.0 | Unsupported: <ul><li>useNativeDriver for animations</li><li>View.transform property</li><li>React Native for Windows in XamlIslands for hosting inside WPF/Win32 scenarios</li>|
| __April 2018 Update__<br> Version-1803 ; Build-10.0.17134.12 | Unsupported : (Same as above plus): <ul><li>Flyout: edge alignments, ShowAt capability</li><li>Picker.editable, Picker.text</li> |
| __Fall Creators Update__<br> Version-1709 ; Build-10.0.16299.91 | Unsupported : Same as above |
| __Creators Update__<br> Version-1703 ; Build-10.0.15063.468 | Unsupported : (Same as above plus): <ul><li>Keyboard events</li><li>TextInput.placeholderTextColor</li><li>TextInput.secureTextEntry may have some fast typing issues</li>