原生平台:概述
有时,React Native 应用需要访问尚未通过 react-native
或现有社区库公开的原生功能。无论是访问平台 API 还是其他自定义原生代码,React Native 都被设计为可扩展的,使任何人都可以编写原生代码并将该功能公开给其应用的 JavaScript。
reactnative.dev 原生平台指南将原生模块定义为用于访问非 UI 原生代码的原生库,将原生组件定义为用于访问原生平台视图的库。该指南包括为 Android 和 iOS 平台实现新的原生模块(和/或组件)的步骤。本指南将介绍如何为 Windows 平台实现新的原生模块(和/或组件)。
架构说明:React Native 指南建议创建 Turbo 原生模块和/或 Fabric 原生组件以支持 React Native 的新架构,而不是使用为旧架构设计的传统 API。本指南将详细介绍如何创建支持 Windows 上两种架构的单个库。有关 React Native for Windows 中 React Native 架构的更多信息,请参阅新旧架构。
入门
实现新的原生模块(和/或组件)的第一步是创建新的基础原生库并初始化对 React Native for Windows 的支持。请参阅原生平台:入门。
实现 Windows 支持
在初始化新项目以支持 Windows 后,下一步是在原生代码中实现 Windows 支持。
如果您正在实现原生模块(即公开非 UI 原生代码),请继续阅读原生平台:原生模块。
如果您正在实现原生组件(即公开原生 Windows UI),请继续阅读原生平台:原生组件。
在 Windows 上使用原生库
实现原生库后,最后一步是在适用于 Windows 的 React Native 应用中使用它。继续阅读 原生平台:使用原生库。
原生模块示例
原生模块示例项目是一个完整的 React Native for Windows 库,包含:
- 几个原生模块示例
- 一个原生组件示例,其中包含 Paper 和 Fabric 的实现
- 新旧架构的示例应用