编辑

原生平台：入门

类似于Windows 入门指南引导您创建基础 React Native 应用（支持 iOS 和 Android），然后添加 Windows 支持一样，本指南将引导您完成创建基础 React Native 库的步骤，然后添加 Windows 支持。

开始之前，请确保您已安装所有开发依赖项。

注意：一直以来，创建基础 React Native 库的方法有很多种，每种方法都会创建略微不同的设置。本指南使用 create-react-native-library 工具（带有特定选项）来启动一个全新的库，因为这是 React Native for Windows 团队测试过的特定设置。尝试向其他工具创建的（现有）库添加 Windows 支持时，您的体验可能会有所不同。

创建新的 React Native 库项目

在您希望项目目录所在的目录中调用以下命令

npx --yes create-react-native-library@0.48.9 --react-native-version ^0.79.0 <projectName>

注意：将 <projectName> 替换为您的库名称。本指南的其余部分将假设您将项目命名为 testlib。

然后，系统会提示您输入有关您要创建的库的更多信息（尽管您也可以在命令行中指定答案）。大多数都是不言自明的，但对于本指南，您需要选择

选项	值	CLI 参数
包名称	testlib	--slug testlib
库类型	Turbo 模块	--type turbo-module
语言	Kotlin & Objective-C	--languages kotlin-objc

注意：有关所有可用选项的更多信息，请参阅create-react-native-library 的文档。

进入这个新创建的目录

该命令将在新的子目录中创建您的项目，您必须进入该子目录才能继续

cd <projectName>

将 React Native for Windows 添加到项目的节点依赖项中

接下来，您需要添加 react-native-windows 作为依赖项

yarn add react-native-windows@^0.79.0 --dev
yarn add react-native-windows@* --peer
yarn install

初始化 React Native for Windows 原生代码和项目

最后，使用 init-windows 命令和 cpp-lib 模板初始化 React Native for Windows 库

npx react-native init-windows --template cpp-lib --overwrite

注意：该命令不仅会初始化库项目本身的 Windows 代码，还会初始化由 create-react-native-library 在 example 文件夹中创建的示例应用的 Windows 代码。

运行 React Native for Windows 示例应用

如果您按照本指南的说明操作，并为 create-react-native-library 创建的基础项目添加了 Windows 支持，您应该能够使用 run-windows 命令启动提供的 example 应用

yarn react-native run-windows

注意：对于我们的 example 应用，您可以从 example 文件夹中运行给定的命令，或者直接从库的根文件夹中运行 yarn example react-native run-windows。

后续步骤

在您初始化一个新项目以支持 Windows 之后，您的下一步是用原生代码实现 Windows 支持。

如果您正在实现一个原生模块（即公开非 UI 原生代码），请继续阅读原生平台：原生模块。

如果您正在实现一个原生组件（即公开原生 Windows UI），请继续阅读原生平台：原生组件。