创建分支

创建分支 (fork) 是修改开源项目使其成为您自己的项目的一种常用方法。Blockly 有很多成功的分支,包括 pxt-blockly、scratch-blockly 和 App Inventor。

但是,为 Blockly 创建分支可能会导致您难以在 Blockly 核心中获取更新和 bug 修复。我们强烈建议您使用插件(而不是创建分支)自定义 Blockly。

如需详细了解插件和可用的 API,请参阅“自定义”部分中的插件和其他文档。

替代选项

在论坛上提问

其他人可能实现了您所希望的行为。在论坛中搜索之前的讨论内容,或者发帖询问是否有人已经编写过该代码。

使用现有插件

如果您的更改是用户普遍请求的功能,那么我们可能已将其作为插件发布到 blockly-samples 中。

编写插件

编写使用 Blockly 的公开 API 的代码,实现您所需的更改。例如,对块渲染、工具箱外观和连接检查行为的更改都可以作为插件实现。

提交功能请求

如果您需要一个非公开的 API,可以针对 Core 提交 bug,以将该 API 设为公开。

发出拉取请求

Blockly 欢迎您贡献内容!如果您的更改是通用的,则最好的选择可能是发出拉取请求。Blockly 改进,您无需维护分支,所有人都胜任。

如需了解详情,请访问贡献页面。

更新分支

我们建议您定期在最新版本的 Blockly 中合并。我们每季度发布一次 Blockly 报告,每个版本都包含版本说明和对任何重大更改的讨论。