首先说明,本篇文章仅针对已有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.bat是编译器的启动器
Compiler.jar是编译器的主体
其中runtime-library是所有扩展组件编译时所需要的运行时环境(当前V0版本包含了Android API 28的SDK,v4,v7的support包,最新的AppInventor内置组件及源码,kawa包)
双击运行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文件中
如下图可以发现组件项目开始迅速编译起来了,我这个机器由于年代很久远了,所以编译时间可能比你们的要长。
再进项目文件夹,可以在其中找到一个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编译器路径,
然后在Path环境变量的末尾处追加如下变量值
%AIXC_HOME%;
如图
现在打开你的cmd,在任何地方输入aixc,如果出现下图,则说明配置成功,
若提示
'aixc' 不是内部或外部命令,也不是可运行的程序或批处理文件
请重新按照上述流程重新配置环境变量。
此时,我们可以在任意目录下去构建aix项目了。
如下图,我桌面上有一个叫做Test的aix项目,我输入命令
aixc Test
就可以正常编译,如果当前目录已经处在aix项目目录中,那么仅仅只需要输入
aixc .
即可开始编译
以上便是一般用来构建aix的方法
下面介绍方法2:
方法2是使用
未完待续。。。