开始

本指南面向希望创建自己的应用程序并将Blockly作为代码编辑器的Android开发人员。假设他们熟悉Blockly的使用，并且基本了解使用Android Studio的Java和应用程序开发。

主要步骤是：

1. 下载并构建库.Download and build the library
2. 创建项目并配置ActivityCreate the project and configure the activity
3. 配置项目的依赖项Configure the project’s dependencies
4. 扩展AbstractBlocklyActivity并实现必要的方法Extend AbstractBlocklyActivity

结果将是你自己的应用程序，看起来像Blockly Simple演示，一个工具箱充满块和一个大工作空间。

Get the Code

---

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

一旦你有代码，通过导入项目的根目录在Android Studio中打开它。你应该看到四个模块，第一个是blocklydemo。构建并运行blocklydemo以验证您的安装。
一旦构建，您会发现以下库文件

1. blockly-android/blocklylib-core/build/outputs/aar/blocklylib-core-release.aar
2. blockly-android/blocklylib-core/build/outputs/aar/blocklylib-core-debug.aar
3. blockly-android/blocklylib-vertical/build/outputs/aar/blocklylib-vertical-release.aar
4. blockly-android/blocklylib-vertical/build/outputs/aar/blocklylib-vertical-debug.aar

core文件包括模型和控制器类，以及视图的基类。vertical文件包括垂直堆叠块视图，由VerticalBlockViewFactory和相关的视图类定义。您将在项目中至少包含一个。

创建项目和Activity

---

如果您还没有应用程序项目，请使用“空活动”模板创建一个。Blockly需要16或更高的minSdkVersion。
如果使用现有应用程序，请向项目中添加“”Empty Activity”。

在任一情况下，您不需要生成带有活动的布局文件。您的块式活动最初将使用Blockly库提供的布局。

在AndroidManifest.xml文件的新<Activity>中，将windowSoftInputMode设置如下：

<application ...    
      android:windowSoftInputMode="stateHidden|adjustPan"    
/>

windowSoftInputMode确保键盘在关闭位置启动，即使有键盘输入字段。它还将确保工作区在键盘（或其他IME）打开时显示此类字段。

在应用程序AppTheme中，在res / values / styles.xml中找到，将父主题设置为BlocklyVerticalTheme

<style name="AppTheme" parent="BlocklyVerticalTheme">   
     <!-- Customize your theme here. -->    
    ...
</style>

此父样式配置块和字段的多个默认值。您可以在the style’s definition中找到更多详细信息。

Configure project dependencies

---

在应用程序项目中，打开File | Project Structure....确保应用程序模块包含库依赖关系…

• com.android.support:support-v4
• com.android.support:appcompat-v7
• com.android.support:recyclerview-v7
  用项目结构对话框中的“+”按钮将模块添加到项目中。选择“导入.JAR / .AAR软件包”模块模板，并从blockly-android项目目录中选择blocklylib-debug.aar或blocklylib-release.aar。然后，在应用程序模块依赖项中，将新模块添加为模块依赖项。

  

  导入这些.aar文件将它们复制到以下位置的项目目录中：

• MyBlocklyApp/blocklylib-core-debug/blocklylib-core-debug.aar
• MyBlocklyApp/blocklylib-core-release/blocklylib-core-release.aar
• MyBlocklyApp/blocklylib-vertical-debug/blocklylib-vertical-debug.aar
• MyBlocklyApp/blocklylib-vertical-release/blocklylib-vertical-release.aar

要更新项目中的Blockly库，只需将这些位置的副本替换为较新版本即可。

你可以添加调试和发布版本.aar文件，如果你想只有你的应用程序的调试生成完全调试信息。如果这样做，请确保应用程序模块依赖关系中的范围分别是“Debug compile”和“Release compile”

实现活动基类

***开发Android Blockly活动的最简单的方法是继承AbstractBlocklyActivity.我们强烈建议您将其用于您的第一个Blockly应用程序。该类有几个抽象方法，你需要重写，详细如下。下面的方法实现了SimpleActivity中的方法实现，您可以使用它作为参考

getToolboxContentsXmlPath()

getBlockDefinitionsJsonPaths（）将assets /目录中的路径返回到块定义.json文件.

@Override protected String getToolboxContentsXmlPath() {
    return "default/toolbox.xml";
}

getBlockDefinitionsJsonPaths()

getBlockDefinitionsJsonPaths（）将assets /目录中的路径返回到块定义.json文件。下面的实现导入由Blockly库提供的默认块

@Override protected List < String > getBlockDefinitionsJsonPaths() {
    return Arrays.asList(
      "default/list_blocks.json", 
      "default/logic_blocks.json", 
      "default/loop_blocks.json",
      "default/math_blocks.json", 
      "default/text_blocks.json", 
      "default/variable_blocks.json", 
      "default/colour_blocks.json"
  );
}

注意：有关创建新块的详细信息，请参阅Add Custom Blocks。

getGeneratorsJsPaths()

getGeneratorsJsPaths（）将assets /目录中的路径返回到定义块实现的生成器.js文件。当前的实现包括Blockly的默认块的所有JavaScript实现。

private static final List < String > JAVASCRIPT_GENERATORS = Arrays.asList(
// Custom block generators go here. Default blocks are already included.
);

@Override protected List < String > getGeneratorsJsPaths() {
    return JAVASCRIPT_GENERATORS;
}

注意：详细了解使用Use Custom Generators中的生成器。

getCodeGenerationCallback()

getCodeGenerationCallback（）返回用于将生成的代码返回到应用程序的回调。这在用户点击操作栏中的运行/播放按钮后调用。

CodeGenerationRequest.CodeGeneratorCallback mCodeGeneratorCallback = new LoggingCodeGeneratorCallback(this, "LoggingTag");

@Override protected CodeGenerationRequest.CodeGeneratorCallback getCodeGenerationCallback() {
    // Uses the same callback for every generation call.
    return mCodeGeneratorCallback;
}

onInitBlankWorkspace()

虽然不是一个抽象的方法，onInitBlankWorkspace（）是目前需要定义可用的变量，如果你的应用程序包括default / variable_blocks.json。可变支持目前正在开发中。

@Override protected void onInitBlankWorkspace() {
    // Initialize available variable names.
    getController().addVariable("item");
}

下一步

在这一点上，应用程序应该编译和运行类似于SimpleActivity
。从这里，发展可以在几个不同的方向前进。您可以…

1. Customize the activity layout，为应用程序的导航和/或可视化留出空间。
2. 在新块.json文件中定义和添加自定义块。Define and add custom blocks
3. 自定义工具箱类别和块Customize the toolbox categories and blocks