AppInventor扩展组件编译器AIXC极速入门

首先说明,本篇文章仅针对已有AppInventor扩展组件开发经验的同学而写的,目的是使大家由原来的从AppInventor源码开发组件的方式转变为使用本编译器构建AppInventor扩展组件的方式。

本编译器名为AIXC,由本人开发,专门用于构建AppInventor扩展组件的一款编译器,它相比于官方的AppInventor中组件的构建方式拥有很多的特性,包括而不限于以下特性:

  • 1.体积小巧简单,官方ai源码完整下载就要4,500M,而本编译器打包为压缩包,体积仅30M+。
  • 2.配置简单,从官方ai源码编译aix组件需要配置ant,git,jdk(包含jre)环境,本编译器仅仅只需要jre环境(自带ecj编译器,无需安装jdk)。

  • 3.编译速度与官方ai源码相比提升了数十倍,尤其是在不引入jar包的情况下,编译一个aix可在数秒内完成。

  • 4.支持根据组件的Blocky的注解中的description全自动构建可视化Markdown组件说明文档(目前仅支持生成gitbook下的Markdown文档且需要安装ai2-blocks插件)。

  • 5.完美支持扩展组件中打包jni库(so文件),官方的编译目前有很多坑。

  • 6.更方便地打包组件依赖的assets资源文件夹,jni库文件夹,aiwebres网页资源文件夹(一般用于存放组件图标)。

  • 7.工程化aix项目,ai官方源码中编译aix,其代码放入components/src中,本质上和其自带组件属于同等级别的源代码,而本aix编译器,以类似Eclipse项目的文件结构管理一个aix组件。

  • 8.通过编写build.json编译信息来编译aix工程项目。

本编译器的下载地址在作者的个人网站上
点击下载

下载后是个zip压缩文件,解压后我们得到如图的文件夹


aixc

打开aixc后我们得到如下图的文件:

AIXC文件构成

aixc.bat是编译器的启动器
Compiler.jar是编译器的主体
其中runtime-library是所有扩展组件编译时所需要的运行时环境(当前V0版本包含了Android API 28的SDK,v4,v7的support包,最新的AppInventor内置组件及源码,kawa包)


runtime-library

双击运行aixc.bat可以看到如下图所示的界面:


启动界面

可以看到,本编译器很简单,有两种编译组件的方式,一种是使用默认的文件夹结构来组成aix项目结构,另一种是使用json文档来构建aix项目结构。

这里先介绍下用法1:
新建一个文件夹Test,其中建立子文件夹src用于存放组件源代码,其中可随意建立包名,随意放置java代码。
官方ai源码有一个缺点,就是必须把组件依赖的类放置在同一个包下,在aix打包时才会被一起打包进aix扩展包中,而本编译器则无此缺点。

下列案例中,我们在组件项目中新建一个文件夹src/cn/zzq/aix/test,其中新建一个类Test.java

代码如下:

package cn.zzq.aix.test;
import com.google.appinventor.components.annotations.DesignerComponent;
import com.google.appinventor.components.annotations.SimpleEvent;
import com.google.appinventor.components.annotations.SimpleFunction;
import com.google.appinventor.components.annotations.SimpleObject;
import com.google.appinventor.components.annotations.SimpleProperty;
import com.google.appinventor.components.runtime.AndroidNonvisibleComponent;
import com.google.appinventor.components.runtime.ComponentContainer;
import com.google.appinventor.components.runtime.EventDispatcher;
import com.google.appinventor.components.common.ComponentCategory;
@DesignerComponent(version = 0,     //指明当前组件的版本号
category=ComponentCategory.EXTENSION,//指明的当前组件所在的组件分类为扩展组件(EXTENSION)分类
iconName = "images/extension.png",//扩展组件的图标
nonVisible = true)//表明该组件为不可视组件
@SimpleObject(external = true)
public class Test extends AndroidNonvisibleComponent {
    public Test(ComponentContainer container){
        super(container.$form());
    }
    
    @SimpleEvent(description = "乘法计算结束后事件被调用")
    public void Multipled(double result){
        EventDispatcher.dispatchEvent(this, "Multipled", result);
    }

    @SimpleFunction(description = "异步乘法")
    public void multiply(double a,double b){
        Multipled(a*b);
    }
    
    @SimpleFunction(description = "第一个组件的函数块定义")
    public double add(double a,double b){
        return a+b;
    }

    private String a=null;
    @SimpleProperty(description = "设置属性A的值")
    public void A(String a){
        this.a=a;
    }

    @SimpleProperty(description = "获取属性A的值")
    public String A(){
        return this.a;
    }

}

如图,我们将整个项目文件夹拖入该bat文件中

开始编译

如下图可以发现组件项目开始迅速编译起来了,我这个机器由于年代很久远了,所以编译时间可能比你们的要长。

image.png

image.png

再进项目文件夹,可以在其中找到一个build目录,这个就是编译器的输出目录:


build目录

其中build.log文件为之前编译时控制台输出的所有编译信息,进output文件夹,可以找到编译出来的aix文件和自动生成的markdown文档,此markdown文档是根据组件的注解中的description自动生成的,目前仅支持导入到gitbook中解析(需要安装gitbook的ai2-blocks插件),它可以生成可视化的Blocky代码块的说明文档,比如
JavaReflector组件文档

除了手动将aix工程项目目录拖入aixc.bat文件外,我们还可以通过配置环境变量的方式,在任何目录都可以直接使用aixc命令来编译aix。
类似于配置Java环境变量需要一个JAVA_HOME,本编译器也需要创建一个环境变量,变量名为AIXC_HOME,变量值为你的aix编译器路径,


AIXC_HOME环境变量

然后在Path环境变量的末尾处追加如下变量值

%AIXC_HOME%;

如图


Path环境变量

现在打开你的cmd,在任何地方输入aixc,如果出现下图,则说明配置成功,

AIXC

若提示

'aixc' 不是内部或外部命令,也不是可运行的程序或批处理文件

请重新按照上述流程重新配置环境变量。

此时,我们可以在任意目录下去构建aix项目了。
如下图,我桌面上有一个叫做Test的aix项目,我输入命令

aixc Test

就可以正常编译,如果当前目录已经处在aix项目目录中,那么仅仅只需要输入

aixc .

即可开始编译


image.png

以上便是一般用来构建aix的方法

下面介绍方法2:
方法2是使用
未完待续。。。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 212,454评论 6 493
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,553评论 3 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 157,921评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,648评论 1 284
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,770评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,950评论 1 291
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,090评论 3 410
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,817评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,275评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,592评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,724评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,409评论 4 333
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,052评论 3 316
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,815评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,043评论 1 266
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,503评论 2 361
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,627评论 2 350

推荐阅读更多精彩内容