跳到主要内容

贡献概述

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

开源指南（Open Source Guides）网站提供了一系列资源，面向希望学习如何运行和贡献开源项目的个人、社区和公司。

贡献者和开源新手都会发现以下指南特别有用

行为准则​

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

版本控制策略​

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

贡献方式​

如果您渴望立即开始贡献代码，我们有一份 “适合首次贡献者”的问题列表，其中包含范围相对有限的错误。随着您获得更多经验并表现出对 React Native 发展的承诺，您可能会获得仓库中的问题管理权限。

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

  1. 回复和处理开放性问题。

    我们每天都会收到很多问题，其中一些可能缺乏必要的信息。您可以帮助引导人们完成填写问题模板的过程，询问澄清信息，或指出与他们问题描述相符的现有问题。我们将在 分类 GitHub 问题 页面上详细介绍此过程。

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

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

  3. 协助编写测试计划。

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

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

我们的开发流程​

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

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

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

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

仓库​

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

还有一些其他仓库可能需要您熟悉

浏览这些仓库应该可以让你了解 React Native 开源项目是如何管理的。

GitHub 问题​

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

安全漏洞​

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

协助文档编写​

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

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

为博客贡献内容​

React Native 博客是从 博客的 Markdown 源文件 生成的。

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

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

贡献代码​

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

分步指南​

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

测试​

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

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

社区贡献​

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