title: Get Started - Android
原文地址：https://developers.google.com/blockly/guides/get-started/android
开始
本指南面向希望创建自己的应用程序并将Blockly作为代码编辑器的Android开发人员。假设他们熟悉Blockly的使用，并且基本了解使用Android Studio的Java和应用程序开发。
主要步骤是：
- 下载并构建库.Download and build the library
- 创建项目并配置ActivityCreate the project and configure the activity
- 配置项目的依赖项Configure the project's dependencies
- 扩展AbstractBlocklyActivity并实现必要的方法Extend AbstractBlocklyActivity
结果将是你自己的应用程序，看起来像Blockly Simple演示，一个工具箱充满块和一个大工作空间。
Get the Code
首先，从GitHub下载源代码。如果您知道如何使用Git或Subversion，我们强烈建议从我们的存储库同步，以便您的代码保持最新
ZIPfile
TAR Ball
GitHub
一旦你有代码，通过导入项目的根目录在Android Studio中打开它。你应该看到四个模块，第一个是blocklydemo。构建并运行blocklydemo以验证您的安装。
一旦构建，您会发现以下库文件
blockly-android/blocklylib-core/build/outputs/aar/blocklylib-core-release.aarblockly-android/blocklylib-core/build/outputs/aar/blocklylib-core-debug.aarblockly-android/blocklylib-vertical/build/outputs/aar/blocklylib-vertical-release.aarblockly-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-v4com.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.aarMyBlocklyApp/blocklylib-core-release/blocklylib-core-release.aarMyBlocklyApp/blocklylib-vertical-debug/blocklylib-vertical-debug.aarMyBlocklyApp/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
。从这里，发展可以在几个不同的方向前进。您可以...
- Customize the activity layout，为应用程序的导航和/或可视化留出空间。
- 在新块.json文件中定义和添加自定义块。Define and add custom blocks
- 自定义工具箱类别和块Customize the toolbox categories and blocks
