---

title: Get Started - Android

原文地址：https://developers.google.com/blockly/guides/get-started/android

开始

本指南面向希望创建自己的应用程序并将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。然后，在应用程序模块依赖项中，将新模块添加为模块依赖项。
  

  实现活动基类

  ***开发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