跳至主内容

贡献指南概览

非官方测试版翻译

本页面由 PageTurner AI 翻译（测试版）。未经项目官方认可。 发现错误？ 报告问题 →

感谢您对贡献 React Native 感兴趣！无论是评论和处理问题、审查代码还是提交拉取请求，任何形式的贡献我们都非常欢迎。 我们的目标是建立一个充满活力且包容的合作伙伴、核心贡献者和社区生态系统，超越 React Native 主仓库的范畴。

开源指南网站为个人、社区和企业提供了丰富的资源，帮助了解如何运营开源项目并参与贡献。

无论是资深贡献者还是开源新手，以下指南都会特别有用：

行为准则​

请谨记，所有贡献者都应遵守我们的行为准则。

版本策略​

要全面理解 React Native 的版本管理机制，我们建议您查阅版本策略页面。 该页面详细说明了支持的 React Native 版本、发布频率以及如何根据实际情况选择合适的版本。

贡献方式​

如果您希望立即开始代码贡献，我们准备了新手友好任务列表，这些任务包含范围相对有限的缺陷修复。 随着经验积累并展现出对推动 React Native 发展的承诺，您可能会获得仓库的问题管理权限。

即使不编写代码，仍有多种方式参与贡献。以下是您可以提供帮助的途径：

  1. 回复和处理未解决问题

    我们每天会收到大量问题反馈，其中部分可能缺少必要信息。您可以通过引导用户填写问题模板、要求补充说明信息，或指引其查看描述相符的现有问题来提供帮助。 更多流程细节请参阅GitHub 问题处理流程页面。

  2. 审查文档拉取请求

    审阅文档更新可以简单到检查拼写和语法问题。 若发现文档中需要优化的表述，点击文档顶部的编辑按钮即可开始贡献。

  3. 协助编写测试方案

    提交到主仓库的部分拉取请求可能缺少完善的测试方案。完善的测试方案能帮助审阅者理解变更的验证过程，从而加速贡献的采纳流程。

每项工作都具有重要价值，维护团队将衷心感谢您的协助。

我们的开发流程​

我们使用 GitHub issues 和 pull requests 来追踪社区的问题报告和贡献。Meta 工程师的所有变更都通过内部源码控制系统与 GitHub 进行同步，而社区贡献则通过 GitHub pull requests 处理。

当 GitHub 上的变更获得批准后，会首先导入 Facebook 内部源码控制系统，并在 Facebook 代码库中进行测试。在 Facebook 合并并通过内部测试后，变更最终会以单个提交的形式同步回 GitHub。

您可以通过以下文档深入了解贡献流程：

我们还有一个活跃的贡献者社区，他们很乐意帮助你上手。你可以通过 @ReactNative 联系 React Native 团队。

仓库​

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

你可能还需要熟悉以下仓库：

浏览这些仓库应能让你了解 React Native 开源项目的管理方式。

GitHub 问题​

我们使用 GitHub 问题（Issues）专门跟踪错误。我们已在问题分类页面记录了问题处理流程。

安全漏洞​

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

帮助改进文档​

React Native 文档托管在 React Native 网站仓库中。该网站使用 Docusaurus 构建。如果你想修改文档，可以点击网站大多数页面右上角的"编辑"按钮开始操作。

如果你要添加新功能或引入行为变更，我们会要求你更新文档以反映这些更改。

为博客供稿​

React Native 博客由 Markdown 源文件生成。

在撰写打算发布在 React Native 博客上的文章之前，请在 React Native 网站仓库中提交问题（issue）或在 Twitter 上 @ReactNative 联系我们，并征得维护者的同意。大多数情况下，你可能更希望在自己的博客或写作平台上分享文章。不过值得一问，万一我们觉得你的文章很适合博客呢。

我们建议参考 react-native-website 仓库的自述文件以了解更多关于为网站做贡献的信息。

贡献代码​

对 React Native 的代码贡献通常以 pull request 的形式提交。具体操作是 fork 仓库并在本地进行更改。

分步指南​

准备好贡献代码时，请查阅我们的提交第一个 pull request 的分步指南，或阅读如何贡献代码页面获取更多细节。

测试​

测试帮助我们防止代码库引入回归问题。GitHub 仓库使用 CircleCI 进行持续测试，测试结果可以通过 commits 和 pull requests 上的 Checks 功能查看。

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

社区贡献​

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