react-native-windows

We're excited to release our first preview of react-native-windows targeting React Native 0.69. There have been many changes to both react-native-windows and react-native itself and we would love your feedback on anything that doesn't work as expected.

How to upgrade

You can view the changes made to the default new React Native Windows applications for C++ and C# using React Native Upgrade Helper. See this document for more details.

What's new from React Native

• React 18: react-native 0.69 has been upgraded to react 18. While this includes lots of "out-of-the-box" improvements, if you're sharing your JS code with a react-based web application, you'll want to make sure that you're able to do the upgrade. See the React v18.0 blog post for details.
• Hermes Distribution: Apps using the "New Architecture" will default to using Hermes as the default JS engine. To support this Hermes will now be bundled with react-native. See Hermes as default engine discussion for details.

For more information on the upcoming RN 0.69, see the Road to 0.69.0 release discussion.

What's new from React Native for Windows

Performance

• Reduced app boot time by 1 second or more in Debug mode
• Some libraries used only in uncommon scenarios are now delay-loaded on demand
• Fixes issue with run-windows ignoring a cache when autolinking windows modules, repeating disk reads

Debuggability

• [Hermes] Fix issues with debugger connection dropping when reloading the instance
• [Hermes] Enables collecting information about the state of Hermes when a crash occurs
• Exposed options for apps to request inline source maps from Metro

Reliability

• Fixes a crash in unpackaged win32 (XAML island) apps
• Fixes a crash that could happen when canceling some image loads
• Fixes a reentrancy issue that could lead to a crash when initializing RN or Hermes from multiple threads
• Fixes an issue where multiple debug targets would linger when creating new RN instances with Hermes
• Fixes a crash when hosting some non-RNW content (XAML, Adaptive Cards, etc.) in a RNW app

Accessibility

• Implemented importantForAccessibility="no-hide-accessibility"
• Fixes the focusable and accessible property behavior for TextInput

Other

• Adds support for unpackaged win32 apps carrying embedded resources (JS bundle, image assets, etc.)
• Enables RNW version checks from IDL for community modules
• Fixes an issue where right click events were not captured
• Adds wrap-reverse to flex wrap options
• Adds support for dependency checking script to detect multiple versions of Visual Studio
• Using react-native-window-init to upgrade your RNW project re-uses the existing ProjectGUID, reducing the upgrade diff to your native project files
• Various updates to the (still incomplete) turbo module and fabric implementation
• Various updates to the (still incomplete) WindowsAppSDK-based implementation
• Various dependency version updates to resolve security issues
• Various other bugfixes and improvements

Breaking Changes

Known Issues

• Pressable Pointer Events: React Native 0.69 adds experimental support for W3C pointer events for Pressables, (disabled by default). RNW does not raise these events, so enabling the support will break hover events on Windows.

This is patch release of react-native-windows, fixing bugs or adding non-breaking enhancements. To see a summary of changes in this major release, see release notes for React Native Windows 0.67.0.

New changes

• 9458dad1 Fix clang-check errors in NativeModules.h ([email protected])
• 38c05472 Fix JSI for Node-API and update V8 to 0.65.11 ([email protected])
• e3ef52d5 Handle abrupt WebSocket connection interruption (#9829) ([email protected])

This is patch release of react-native-windows, fixing bugs or adding non-breaking enhancements. To see a summary of changes in this major release, see release notes for React Native Windows 0.66.0.

New changes

• 94d54d33 Fix clang-check errors in NativeModules.h ([email protected])
• e2571e1d Handle abrupt WebSocket connection interruption (#9829) ([email protected])

This is patch release of react-native-windows, fixing bugs or adding non-breaking enhancements. To see a summary of changes in this major release, see release notes for React Native Windows 0.68.0.

New changes

• 2c283f37 Built in turbomodules should not override app provided versions ([email protected])
• 6cd67bf3 Fix JSI for Node-API and update V8 to 0.65.11 ([email protected])
• b8308ae3 Handle abrupt WebSocket connection interruption (#9829) ([email protected])
• de549c0a Enable loading the bundle from an embedded resource via resource://moduleName/resourceId ([email protected])
• 5eb9ff6f Avoid crash in DevSupportManager when running in unpackaged apps with Hermes ([email protected])
• cc725c1a Fix clang-check errors in NativeModules.h ([email protected])
• de549c0a Bump @react-native-windows/cli to v0.68.2 (beachball)

This is patch release of react-native-windows, fixing bugs or adding non-breaking enhancements. To see a summary of changes in this major release, see release notes for React Native Windows 0.68.0.

New changes

• 503b52a6 Fix Sequential DispatchQueue deadlock on shutdown ([email protected])

This is patch release of react-native-windows, fixing bugs or adding non-breaking enhancements. To see a summary of changes in this major release, see release notes for React Native Windows 0.67.0.

New changes

• d3174822 Fix Sequential DispatchQueue deadlock on shutdown ([email protected])

This is patch release of react-native-windows, fixing bugs or adding non-breaking enhancements. To see a summary of changes in this major release, see release notes for React Native Windows 0.66.0.

New changes

• 3e1da9e9 Fix JSI for Node-API and update V8 to 0.65.11 ([email protected])
• 9ace3b51 Fix Sequential DispatchQueue deadlock on shutdown ([email protected])

This is patch release of react-native-windows, fixing bugs or adding non-breaking enhancements. To see a summary of changes in this major release, see release notes for React Native Windows 0.68.0.

New changes

• 223d20b7 Bump @react-native-windows/cli to v0.68.1 (beachball)

We're excited to release react-native-windows targeting React Native 0.68.

How to upgrade

You can view the changes made to the default new React Native Windows applications for C++ and C# using React Native Upgrade Helper. See this document for more details.

What's New

• PackageReference for C++ projects: New C++ projects use recently added MSBuild support for PackageReference based NuGet restoration. This change lays the foundation for simplified build logic, smaller downloads, and always up-to-date references to libraries (such as the RNW NuGet
  package).

• Native animation driver improvements: There have been many improvements to the native animation driver, around both correctness and reliability.

• onMouseEnter/onMouseLeave on arbitrary native components: We previously exposed onMouseEnter and onMouseLeave callbacks on <View>. These are now exposed to all native components (e.g. <Text>).

-onDropViewInstance API addition: We've created the onDropViewInstance API to enable view managers to track when a view has been removed the shadow tree.

• editable support for <TextInput> with secureTextEntry: <TextInput> components that are marked as secureTextEntry now correctly respect the editable prop.

• Debug variant NuGet packages: We now publish binaries for the debug builds of Microsoft.ReactNative, that can be used in place of the default release-mode binaries. E.g. by using the Microsoft.ReactNative.Debug Nuget package in place of Microsoft.ReactNative.

• run-windows architecture selection: run-windows previously would always default to building x86 applications. It now defaults to the system architecture (e.g. x64 or ARM64).

• Automatic PCH selection: We've enabled large PCH's by default on machines with more than 7GB of memory per-thread. This can help to significantly reduce build time on pools with high-memory hardware.

• Other bug-fixes and improvements: We've made many more fixes across the platform. Expect less crashes, more correct behavior, and quality of life improvements for developers.

-**Support for WebView2 control via react-native-webview:**We've enabled the use of the WinUI WebView2 control via the react-native-webview community module for React Native Windows apps that use v0.68+.

Breaking Changes

• packages.config projects: Projects using packages.config, either directly, or transitively through community modules, may need to be modified. run-windows, and Visual Studio using the default project, restore both packages.config and PackageReference dependencies, but you may need to restore packages.config projects explicitly if using MSBuild directly. This requirement may be removed before the final release of RNW 0.68.

• Node 14: react-native 0.68 now requires Node 14 or later to be used.

This is patch release of react-native-windows, fixing bugs or adding non-breaking enhancements. To see a summary of changes in this major release, see release notes for React Native Windows 0.67.0.

New changes

• e9260264 MustBeNoExceptVoidFunctor should depend on the template type parameter to avoid being evaluated too early (#9609) ([email protected])
• f4f970be Promote 0.67 to legacy ([email protected])
• e9260264 Bump @react-native-windows/cli to v0.67.2 (beachball)
• e9260264 Bump @react-native-windows/virtualized-list to v0.67.1 (beachball)
• e9260264 Bump @react-native-windows/codegen to v0.67.1 (beachball)

This is patch release of react-native-windows, fixing bugs or adding non-breaking enhancements. To see a summary of changes in this major release, see release notes for React Native Windows 0.66.0.

New changes

• aab0df70 MustBeNoExceptVoidFunctor should depend on the template type parameter to avoid being evaluated too early (#9609) ([email protected])

This is patch release of react-native-windows, fixing bugs or adding non-breaking enhancements. To see a summary of changes in this major release, see release notes for React Native Windows 0.67.0.

New changes

• cca2db0a Guard against crashes due to cancelations and other errors from BitmapSource/SvgImageSource SetSourceAsync ([email protected])

This is a preview of the next version of react-native-windows. To see a summary of changes in this major release, see release notes for React Native Windows 0.68.0-preview.1.

New changes

• 423d9144 Guard against crashes due to cancelations and other errors from BitmapSource/SvgImageSource SetSourceAsync ([email protected])
• eada31cd Enable version checks in IDL files ([email protected])

This is patch release of react-native-windows, fixing bugs or adding non-breaking enhancements. To see a summary of changes in this major release, see release notes for React Native Windows 0.67.0.

New changes

• ea1da780 move some DLLs to delayload ([email protected])

This is a preview of the next version of react-native-windows. To see a summary of changes in this major release, see release notes for React Native Windows 0.68.0-preview.1.

New changes

• eb3fa990 Update WebView Pkg Dep Following Pkg Ref ([email protected])
• 94d29494 Integrate 0.68.0-rc.2 ([email protected])
• 43f8f593 move some DLLs to delayload ([email protected])
• 43f8f593 Bump @react-native-windows/virtualized-list to v0.68.0-preview.3 (beachball)

This is patch release of react-native-windows, fixing bugs or adding non-breaking enhancements. To see a summary of changes in this major release, see release notes for React Native Windows 0.67.0.

New changes

• d43b5dda Safe re-entrancy for EnsureHermesLoaded ([email protected])

This is patch release of react-native-windows, fixing bugs or adding non-breaking enhancements. To see a summary of changes in this major release, see release notes for React Native Windows 0.66.0.

New changes

• 7c9bdabe Safe re-entrancy for EnsureHermesLoaded ([email protected])

This is a preview of the next version of react-native-windows. To see a summary of changes in this major release, see release notes for React Native Windows 0.68.0-preview.1.

New changes

• 09fa7051 Safe re-entrancy for EnsureHermesLoaded ([email protected])
• 09fa7051 Bump @react-native-windows/cli to v0.68.0-preview.6 (beachball)

This is a preview of the next version of react-native-windows. To see a summary of changes in this major release, see release notes for React Native Windows 0.68.0-preview.1.

New changes

• a891608d Implement crash management for optional collection of Hermes JS callstack and heap addresses with Windows Error Reporting ([email protected])
• f23a548f Set ResolveNuGetPackages in external props (#9628) ([email protected])
• 3e25b040 Bkpt API Docs Change ([email protected])
• 98ca6329 [0.68] Capture MSBuild properties in telemetry ([email protected])
• f23a548f Bump @react-native-windows/cli to v0.68.0-preview.5 (beachball)

This is patch release of react-native-windows, fixing bugs or adding non-breaking enhancements. To see a summary of changes in this major release, see release notes for React Native Windows 0.67.0.

New changes

• 502c215d Enable TurboModule Promise completion from any thread (#9595) ([email protected])
• 0cd8d8f0 Expose InlineSourceMap property ([email protected])
• cd3b6fdb Crash when getting Platform.osVersion on Windows 8.1 ([email protected])