跳到主要内容

贡献概述

感谢您对为 React Native 做出贡献感兴趣！从评论和分类问题，到审查和提交拉取请求，所有贡献都受到欢迎。我们的目标是建立一个充满活力且包容的 合作伙伴、核心贡献者和社区生态系统，而不仅仅局限于 React Native 的主要 GitHub 仓库。

有关如何运行和贡献开源项目的资源，请参阅 开源指南 网站上的相关内容。

贡献者和开源新人都会觉得以下指南特别有用：

行为准则​

提醒您，所有贡献者都应遵守 行为准则。

版本策略​

为了全面了解 React Native 的版本控制，我们建议您查阅 版本策略 页面。在该页面，我们描述了支持哪些 React Native 版本、发布频率以及根据您的情况应该使用哪个版本。

贡献方式​

如果您渴望立即开始贡献代码，我们有一份 适合初学者的问题 列表，其中包含范围相对有限的 Bug。随着您积累更多经验并致力于 React Native 的发展，您可能会获得仓库中的问题管理权限。

还有其他不需要编写一行代码的贡献方式。以下是您可以提供帮助的一些方式：

  1. 回复和处理公开的问题。

    我们每天都会收到大量问题，其中一些可能缺乏必要的信息。您可以通过指导用户填写问题模板、询问澄清信息或指向与他们遇到的问题描述相符的现有问题来提供帮助。我们将在 分类 GitHub 问题 页面更详细地介绍此过程。

  2. 审查文档的拉取请求。

    审查 文档更新 可以很简单，只需检查拼写和语法。如果您遇到可以更好地在文档中解释的情况，请点击大多数文档页面顶部的“编辑”按钮，开始您自己的贡献。

  3. 协助编写测试计划。

    提交到主仓库的一些拉取请求可能缺少适当的测试计划。这些有助于审阅者了解更改是如何经过测试的，并可以加快贡献被接受的速度。

这些任务中的每一项都具有高度影响力，维护者将非常感谢您的帮助。

我们的开发流程​

我们使用 GitHub 的问题和拉取请求来跟踪社区提交的 Bug 报告和贡献。来自 Meta 工程师的所有更改都将通过与 Meta 内部源代码控制的桥梁同步到 GitHub。社区的贡献通过 GitHub 拉取请求进行处理。

一旦 GitHub 上的更改获得批准，它将首先导入 Facebook 的内部源代码控制，并针对 Facebook 的代码库进行测试。在 Facebook 合并后，该更改在通过 Facebook 的内部测试后，最终将作为单个提交同步回 GitHub。

您可以在以下文档中了解更多关于贡献过程的信息：

我们还有一个蓬勃发展的贡献者社区，他们很乐意帮助您入门。您可以通过 @ReactNative 联系 React Native 团队。

仓库​

主仓库包含 React Native 框架本身，我们在此跟踪 Bug 报告并管理拉取请求。

还有一些其他仓库您可能想熟悉一下：

浏览这些仓库应该能让您对 React Native 开源项目的管理方式有所了解。

GitHub 问题​

我们仅使用 GitHub 问题来跟踪 Bug。我们在 分类问题页面 中记录了我们的问题处理流程。

安全 Bug​

Meta 有一个 赏金计划，用于安全地披露安全 Bug。在这些情况下，请遵循该页面概述的流程，不要公开提交问题。

协助文档编写​

React Native 文档托管在 React Native 网站仓库中。该网站使用 Docusaurus 构建。如果您想更改文档中的任何内容，可以点击网站上大多数页面右上角的“编辑”按钮开始。

如果您正在添加新功能或引入行为更改，我们将要求您更新文档以反映您的更改。

为博客做贡献​

React Native 博客 由博客的 Markdown 源生成。

请在 React Native 网站仓库中提交一个问题，或在 Twitter 上标记 @ReactNative，并在撰写计划用于 React Native 博客的文章之前获得维护者的批准。在大多数情况下，您可能想在自己的博客或写作平台分享您的文章。不过，值得一问，以防我们发现您的文章非常适合博客。

我们建议参考 react-native-website 仓库的 README 文件，以了解更多关于网站总体贡献的信息。

贡献代码​

对 React Native 的代码级贡献通常以 拉取请求 的形式进行。这通过分叉仓库并在本地进行更改来完成。

分步指南​

当您准备好贡献代码时，请查看我们的 提交第一个拉取请求的分步指南，或阅读 如何贡献代码 页面以获取更多详细信息。

测试​

测试有助于我们防止在代码库中引入回归。GitHub 仓库使用 CircleCI 进行持续测试，其结果可通过 提交 和拉取请求上的“检查”功能获得。

您可以在 如何运行和编写测试 页面上了解更多关于运行和编写测试的信息。

社区贡献​

对 React Native 的贡献不仅限于 GitHub。您可以通过分享您使用 React Native 的经验来帮助他人，无论是通过博客文章、在会议上发表演讲，还是简单地在 Twitter 上分享您的想法并标记 @ReactNative。