介绍一下使用Titanium的Module功能来制作自定义的View。
这里只是想整理一下最低限度的步骤和方法,所以自定义的内容只是简单地给普通的View类添加颜色。
Porject做成
根据 Titanium中Android模块开发指南(中文) 的内容,大家应该能很容易的创建一个Module的模板工程。
引用
titanium create --platform=android --type=module --name=ColoredView --id=net.siso9to.coloredview --android=$HOME/devel/android-sdk-mac_x86
将做成好的模板工程导入到Eclipse中,Module的准备工作就算完成了。
Module做成
导入的模板工程的包目录下,有两个类文件:
ColoredviewModule.java
ExampleProxy.java
这样原封不动的也是没有问题的,但是我们看到类名中view的第一字母小写了,不是很符合规范,所以我们使用重构功能将类名修改为:ColoredViewModule.java。使用Eclipse的重构功能的话,注解位置部分
@Kroll.module(name="Coloredview", id="net.siso9to.coloredview")
的name参数没有给重命名,所以这里需要手动修改。
还有就是类中不用的方法,注释等都删去,ExampleProxy.java也要重写做一个,所以也一并删去。
修改之后的ColoredViewModule.java的内容是一下这个样子的:
package net.siso9to.coloredview;import org.appcelerator.kroll.KrollModule;import org.appcelerator.kroll.annotations.Kroll;import org.appcelerator.titanium.TiContext;@Kroll.module(name="ColoredView", id="net.siso9to.coloredview")public class ColoredViewModule extends KrollModule{ public ColoredViewModule(TiContext tiContext) { super(tiContext); }}
这样就留下来了最低限度代码的Module。
自定义View做成
要做成自定义View,需要创建一个继承了TiUIView的类。
然后,自定义View的时候,还需要再TiUIView的子类中生成View实例,调用setNativeView()方法将该子类保存。
package net.siso9to.coloredview;import org.appcelerator.titanium.proxy.TiViewProxy;import org.appcelerator.titanium.view.TiUIView;import android.content.Context;import android.graphics.Color;import android.view.View;public class ColoredView extends TiUIView { public class CostomView extends View { public CostomView(Context c) { super(c); this.setBackgroundColor(Color.GREEN); } } public ColoredView(TiViewProxy proxy) { super(proxy); CostomView costomView = new CostomView(proxy.getContext()); setNativeView(costomView); }}
Proxy做成
最后,要做成一个能偶再Module中调用刚才做成的自定义View的Proxy类。
调用刚才做成的自定义View的Proxy类在做成的时候,需要继承TiViewProxy,然后,实现createView(Activity activity)方法,将自定义View的实例类返回。
package net.siso9to.coloredview;import org.appcelerator.kroll.annotations.Kroll;import org.appcelerator.titanium.TiContext;import org.appcelerator.titanium.proxy.TiViewProxy;import org.appcelerator.titanium.view.TiUIView;import android.app.Activity;@Kroll.proxy(creatableInModule=ColoredViewModule.class)public class ColoredViewProxy extends TiViewProxy{ private ColoredView coloredView; public ColoredViewProxy(TiContext tiContext) { super(tiContext); } @Override public TiUIView createView(Activity activity) { coloredView = new ColoredView(this); return coloredView; } }
在构造函数中,通过setBackgroundColor(Color.GREEN)的设置,View的背景色就被设置上了。
需要注意的地方是,再做成Proxy类的时候,需要像以下这个样子将注解的creatableInModule值设置成和Module名一样。
@Kroll.proxy(creatableInModule=ColoredViewModule.class)
确认动作的Script做成
做好了Module之后,我们需要确认以下该Module是否能正常的运行,是否能达到我们需要的效果。
在确认Module的效果前,我们需要将Module集成到我们的Titanium当中来,使用example文件夹下的app.js就能确认Module的效果。
稍微修改一下通过Titanium命令生成的example/app.js:
var window = Ti.UI.createWindow({ backgroundColor:'white'});var label = Ti.UI.createLabel();window.add(label);window.open();var module = require('net.siso9to.coloredview');Ti.API.info("module is => " + module);var view = module.createColoredView({ top: '100dp', width : '100dp', height : '100dp', color: '#000',});window.add(view);
从Module经由Proxy调用自定义View时,并不是直接的调用Proxy的createView方法,而是向上面代码这样:
create + Proxy名(去除Proxy)
确认动作的Script的运行
修改完app.js之后,通过ant我们来运行这个script。
在build.xml文件上点击右键,选择「Debug As」 > 「2 Ant Build...」
在表示出来的Ant的Task一览中,我们选择「clean」和「run」。
※如果只是选择ruan的话,可能会残留一些不必要的文件,从而引起编译失败,所以这里也先选上clean
然后按下「Debug」之后运行,成功启动模拟器之后,就能看到一下的页面了,绿色部分就是这回自定义的View。
这里只是说明了如果自定义一个View,其中最大限度的省略了一些其他的代码,如果大家要自定义View的话,应该不会这个简单,但是过程基本上是这样的。