美文网首页
Get Started - Android

Get Started - Android

作者: mimimomo | 来源:发表于2018-02-07 10:06 被阅读121次

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

相关文章

网友评论

      本文标题:Get Started - Android

      本文链接:https://www.haomeiwen.com/subject/qejxmttx.html