本文档面向希望创建自己的应用程序的开发人员，这些应用程序将Blockly集成为代码编辑器。假定人们通常熟悉Blockly的用法，并且对HTML和JavaScript有基本的了解。

总览

Blockly旨在轻松安装到您的Web应用程序中。用户拖动块，Blockly生成代码，您的应用程序对该代码执行某些操作。从您的应用程序的角度来看，Blockly只是一个文本区域，用户可以在其中键入语法上完美的JavaScript，Python，PHP，Lua，Dart或其他语言。

Blockly是100％的客户端，不需要服务器的任何支持（除非有人想使用云存储功能）。没有第三方依赖关系（除非有人想重新编译内核）。一切都是开源的。

获取代码

首先，从GitHub下载源代码。如果您知道如何使用Git或Subversion，我们强烈建议您从存储库中进行同步，以使您的代码保持最新。

获得代码后，将浏览器指向demos/fixed/index.html并确认可以拖动块。

块状注射

在您验证Blockly的安装正常工作后，使用固定大小将Blockly注入到网页中div。

更高级的网页可能希望允许Blockly调整大小以填充页面。

组态

Blockly.inject上面示例中使用的行将名称-值对字典作为第二个参数。这些用于配置。支持以下选项：

最重要的选择是toolbox。这是一棵XML树，用于指定工具箱（侧面菜单）中可用的块，如何分组以及是否存在类别。

除了Blockly随附的默认块之外，还需要构建自定义块来调用Web应用程序的API。一个例子是这个迷宫游戏，它具有自定义的移动块。

代码生成器

Blockly不是一种编程语言，无法“运行” Blockly程序。相反，Blockly可以将用户的程序转换为JavaScript，Python，PHP，Dart或其他某种语言。

导入和导出块

如果您的应用程序需要保存和存储用户的块并在以后访问时恢复它们，请使用此调用导出到XML：

var xml = Blockly.Xml.workspaceToDom(workspace); 

var xml_text = Blockly.Xml.domToText(xml); 

这将产生一个最小（但难看）的字符串，其中包含用户块的XML。如果希望获得更易读（但更大）的字符串，请 Blockly.Xml.domToPrettyText改用。

从XML字符串还原到块很简单：

var xml = Blockly.Xml.textToDom(xml_text); 

Blockly.Xml.domToWorkspace(xml, workspace); 

云储存

Blockly带有可选的云存储功能。它使用户可以保存，加载，共享和发布他们的程序。如果您的项目托管在App Engine上，则可以利用此服务。