react-native-windows README

The project's README from github.com/microsoft/react-native-windows. As one markdown file: README.md.

Hero Image with Logo

React Native for Windows

Follow @ReactNativeMSFT

Website · Documentation · Release notes

See the official React Native website for an introduction to React Native.

React Native is a framework developed by Meta that enables you to build world-class application experiences on native platforms using a consistent developer experience based on JavaScript and React. The focus of React Native is on developer efficiency across all the platforms you care about - learn once, write anywhere.

This repository adds support for the Windows 10 SDK, which allows you to build apps for all devices supported by Windows 10 including PCs, tablets, 2-in-1s, Xbox, Mixed reality devices etc.

Visit the official React Native for Windows + macOS website to learn more.

🛣️ Roadmap

Check out our blog if you'd like to stay up to date on the status of React Native for Windows and check out current and past roadmaps.

New Architecture

Fabric is the new rendering system for React Native, designed to share more rendering logic cross-platform. RNW's existing Paper renderer is built on UWP XAML, dropping down into native Composition as need be; the new RNW Fabric renderer targets Composition from the start but has the ability to host islands of XAML for advanced native controls. Apps on the new architecture will be WinAppSDK Win32 by default. For more details on our roadmap to Fabric, check out this pinned issue.

Make sure to also check out the React Native Gallery, our interactive sample experience showing everything you can do with React Native for Windows.

WinUI 3 Gallery


📋 Getting Started

See the Getting Started Guide on our React Native for Windows + macOS website to build your first React Native for Windows app.

Requirements

You can run React Native Windows apps only on devices supported by the Windows 10 SDK.

For a full and detailed list of the system requirements and how to set up your development platform, see our System Requirements documentation on our website.

Logging Issues

Search the existing issues and try to make sure your problem doesn’t already exist before opening a new issue. If your issue doesn't exist yet, provide as much information as possible so we can better help you. Include the information requested by the appropriate issue template.

Documentation

React Native has great documentation. React Native for Windows adds its own separate Windows and macOS documentation for desktop platform information like API docs and blog updates.

Examples

📢 Contributing

See Contributing guidelines for how to setup your fork of the repo and start a PR to contribute to React Native for Windows.

Not sure where to start? The good first issue and help wanted labels are the best starting points.

Code of Conduct

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact [email protected] with any additional questions or comments.

react-native-windows (microsoft/react-native-windows)

Searching Database…

这是什么?这是微软推出的框架,用 JavaScript 和 React 构建原生 Windows 应用。它把 Meta 的 React Native 扩展到 Windows 10 SDK 支持的所有设备:电脑、平板、二合一设备、Xbox 以及混合现实设备。
它和我在 iOS、Android 上用的 React Native 是同一个吗?我还是写 JavaScript 吗?是的——开发体验和 Meta 的 React Native 一样:用 JavaScript 和 React 搭建界面(“一次学会,随处编写”)。这个仓库提供的是 Windows 原生运行时本身,所以它的代码大部分是 C++。
我怎么用它做出我的第一个应用?按照 React Native for Windows + macOS 官网上的入门指南操作——它的 CLI 会生成一个完整的示例应用,你可以马上开始修改。更多示例可以看 samples 仓库和 RNTester。
开发需要准备什么?我的应用能在哪些设备上运行?开发需要在 Windows 上进行,并安装 Windows 10 SDK;完整的配置清单见官网 System Requirements 文档。做好的应用只能在 SDK 支持的设备上运行。
我做出来的应用是 UWP 应用,还是普通的桌面 Win32 应用?取决于架构版本:旧的 Paper 渲染器基于 UWP XAML,而采用新 Fabric 架构的应用默认是 WinAppSDK Win32——新项目应该按这条路走。
正式开工之前,我能先感受一下它都能做什么吗?可以——打开 React Native Gallery,这是一个交互式示例应用,展示了 React Native for Windows 能做什么;也可以浏览 RNTester 和独立的 samples 仓库。
项目名字里的 macOS 是不是说我的应用也能跑在 Mac 上?这项工作覆盖两大桌面平台:同一个官网上分别提供 Windows 和 macOS 的平台 API 文档以及博客更新。这个仓库是其中 Windows 这一侧的成果。
Paper 和 Fabric 渲染器是什么?Paper 是目前的渲染器,Fabric 则是新渲染系统,目标是让更多逻辑跨平台共享:它从一开始就面向 Composition,并且可以嵌入 XAML 岛来使用高级原生控件。
和直接写原生 Windows 应用相比,为什么选它?卖点是开发效率:用 JavaScript 和 React 搭界面,开发体验统一,不用为每个平台手写原生界面层。
这个项目还在活跃开发吗?是的——这是一个由微软维护的仓库,star 数超过 17000。路线图和进展会发布在 React Native Developer Blog 上,CI 会运行构建、lint、性能测试和依赖检查。
Creator
microsoft
Size
377.7 MB
Stars
17.4K
Age
10y
Commits · 90 Days