开始为 Blockly 做贡献

Blockly 是开源的,主要由小型团队进行维护。我们欢迎核心团队以外的开发者做出贡献;如果没有我们的社区,我们不可能构建每项请求的功能或修复用户报告的每项错误。本部分包含一些常规指南,尤其是在您刚开始接触开源开发时,可能会对您很有帮助。

如需了解您在做出贡献之前应该阅读的特定于 Blockly 的信息,请参阅为核心内容做贡献为示例做贡献部分。

哪个代码库?

代码库包含单个项目的所有文件。Blockly 有两个代码库:blockly core 和 blockly-samples。

Blockly core 是 Blockly 库的代码库。如果您希望以适用于库中所有用户的方式更改核心 Blockly 行为,请使用此代码库。

Blockly 示例是示例、插件和 Codelab 的代码库。如果您想要创建或修改插件、编写 Codelab,或者创建或修改示例,请使用此代码库。

分步说明

您每次进行更改时,都需要按照以下常规步骤操作。

  1. 按照工具部分中的链接安装 Git 和 Node。
  2. 创建代码库分支并克隆代码库。GitHub 上提供了关于创建代码库分支的精彩教程。如需将其应用于块,只需将 octocat/Spoon-Knife 中的每个实例替换为 google/blocklygoogle/blockly-samples,具体取决于您要使用的代码库。
  3. 同步您的分支。GitHub 还提供了有关如何同步分支的教程。
  4. 查看 main 分支。在块核心中,这是 develop 分支。在 block-samples 中,这是 master 分支。
  5. 安装依赖项和构建工具,方法是在根目录中运行 npm install
  6. 通过在终端中运行 git checkout -b myBranchName创建新分支。该名称应该有助于您记住您正在进行的工作。
  7. 进行更改。
  8. 按照核心示例指南验证您的更改
  9. 使用 git commit -am "fix: My commit message" 保存更改详细了解提交消息
  10. 使用 git push origin myBranchName 将您的更改推送到 GitHub。
  11. 代码准备就绪后打开拉取请求。Blockly 团队成员会审核您的更改,并在获得批准后将其合并到 Blockly 中。如需了解详情,请参阅 PR 审核流程