VirtualView Android 实现详解(三)—— 添加一个自定义控件

本系列文章

前文介绍了模板的基本格式、虚拟控件与原生控件混合使用的方式。本文重点在把这两块内容串起来介绍一下,如何实现从模板生成一个运行时的控件,并如何注册一个自定义控件使用。

相关开源库

Android

iOS

名词解释

从 XML 到运行时实例

举个简单的例子,在 XML 模板里,可能会有这么一块控件的使用:

<NText
    id="1"
    text="title"
    textSize="12"
    textColor="#333333"
    layoutWidth="wrap_content"
    layoutHeight="wrap_content"
    lineSpaceMultiplier="1.1"
    lines="2"
    flag="flag_event|flag_exposure|flag_clickable"
 />

这在 VirtualView 表示引用一个文本控件(VirtualView 内置支持的所有控件见文档),在《VirtualView Android实现详解(一)—— 文件格式与模板编译》里曾讲过会将 XML 里的字符串等编译成整型数值或者索引来降低解析成本。因此从在 XML 里使用一个控件到运行时渲染它,就要经过一系列的转换过程,其中有一半的过程是事先离线执行的,另一半的过程才是在客户端里运行时执行。以下这张图概括了整个流程:

image

说明一下每个步骤:

  • 先编写 XML 文件,如图所示引用了一个 NText 控件;
  • 在 Config 文件里配置 NText 的标签名及属性的映射关系;像这种内置控件都已经配置好了,如果是自定义属性和控件,才要操作自己添加配置;配置文件含义参考这篇文章:VirtualView 工具大更新啦。在这个示例中,NText 标签被编译工具编译成数字 7,属性名 id、text、textSize、textColor 都被编译成一个 hashcode 索引,真正的字符串值会存储到字符串资源区;属性值 title 也是被编译成一个 hashcode 索引,真正的字符串值会存储到字符串资源区;属性值 12 被直接编译成数字 12; 属性值 #333333 被编译成颜色值 -13421773;
  • 编译工具根据 XML 文件和 Config 文件编译出一份二进制文件,交给客户端使用;
  • 客户端初始化框架的时候会根据 id 注册控件,在这个示例中 7 代表了 NativeText 类控件,它就用来实例化 XML 里的 NText 标签;
  • 最后将 XML 里 NText 下的属性传给 NativeText 实例进一步用于渲染;

创建控件实例的过程

以创建一个 PicassoImage 为例(虽然内置了 VImage 和 NImage 两个控件,但在实际业务场景中,还是使用一个自定义的图片控件比较合适,这样可以更好利用起结合图片库的内存管理、性能优化等 feature)。

目标

  • 实现一个原生 Image 控件,使用 Picasso 加载图片
  • 支持绑定 url 属性用来加载网络图片
  • 支持绑定 degree 属性用来旋转图片

1. 定义标签名及其 id,属性名及类型

在编译工具里配置文件里定义:

  • VIEW_ID_PicassoImage=1014,其中 PicassoImage 就是 XML 里的标签名,id 值为 1014,这个是自定义的,建议从 1001开始,前 1000 保留给系统使用
  • degree=Float,表示属性名是 degree ,属性值按 Float 类型编译解析;
  • url=String,表示属性名是 url,属性值按 String 类型编译,不过未在配置文件里声明的属性都是按 String 类型编译的,所以可以省略

2. 定义控件的载体 View

取名 PicassoImageView,继承 ImageView,实现 IView 接口,因为 demo 比较简单,除此之外不做其他逻辑,主要实现 IView 的接口调用对应的系统 measure、layout 方法,因为这些方法是不能在外部调用的,只能通过 IView 的接口封装一下暴露出去。

详细代码:PicassoImageView.java

3. 定义控件 model

取名 PicassoImage,继承 ViewBase,在构造函数里实例化 PicassoImageView,并获取自定义属性的 id;

public PicassoImage(VafContext context,
        ViewCache viewCache) {
        super(context, viewCache);
        mPicassoImageView = new PicassoImageView(context.getContext());
        StringSupport mStringSupport = context.getStringLoader();
        // 这里会取加载的模板数据里取获取对应的 id,第一个参数是属性名,第二个参数应当为 false;
        urlId = mStringSupport.getStringId("url", false);
        degreeId = mStringSupport.getStringId("degree", false);
    }

由于 ViewBase 本身也是实现 IView 接口的,所以复写几个 IView 的 measure、layout 接口,去调用对应的 PicassoImageView 里的接口。在 VirtualView 体系内部,都是通过 ViewBase 对象来驱动布局计算的,因此必须通过 IView 接口调用系统 View 真正的计算接口。

@Override
public void onComMeasure(int widthMeasureSpec, int heightMeasureSpec) {
    mPicassoImageView.onComMeasure(widthMeasureSpec, heightMeasureSpec);
}

@Override
public void onComLayout(boolean changed, int l, int t, int r, int b) {
    mPicassoImageView.onComLayout(changed, l, t, r, b);
}

@Override
public void comLayout(int l, int t, int r, int b) {
    super.comLayout(l, t, r, b);
    //这一步很关键,否则 view 不显示。
    mPicassoImageView.comLayout(l, t, r, b);
}

剩下的主要逻辑是处理自定义属性,有几个 setAttributesetRPAttribute 重载的方法,它们用于接收不同类型的属性值:

  • boolean setAttribute(int key, int value) 处理编译成整数类型的属性;
  • boolean setAttribute(int key, float value) 处理编译成浮点数类型的属性;
  • boolean setAttribute(int key, String stringValue) 处理编译成字符串类型的属性,包括那些本该编译成整数或者浮点数但因为写了表达式被编译成字符串类型的;
  • boolean setRPAttribute(int key, int value) 处理编译成整数类型的尺寸属性,单位是 rp(介绍在此);
  • boolean setRPAttribute(int key, float value) 处理编译成浮点数类型的尺寸属性,单位是 rp;

基础 ViewBase 里解析处理了大量基础属性,所以自定义控件只要处理新增的自定义属性就行了。以上这些重载方法都有一个 Boolean 返回值,它遵循冒泡逻辑,当你返回 true 的时候,当前层级处理了这个属性,否则表示当前层级处理不了这个属性,需要进一步交给子类解析;在本文的示例里,是这么处理的:

@Override
protected boolean setAttribute(int key, float value) {
    boolean ret = true;
    if (key == degreeId) {
        //从模板里直接获取到旋转角度属性值
        degrees = value;
    } else {
        ret = super.setAttribute(key, value);
    }
    return ret;
}

@Override
protected boolean setAttribute(int key, String stringValue) {
    boolean ret = true;
    if (key == degreeId) {
        //从模板里直接获取到旋转角度属性值是一个表达式,暂存到 viewCache 里,等传入数据的时候再次解析,然后回调到上述 setAttribute(int key, float value) 方法里获取最终值
        if (Utils.isEL(stringValue)) {
            mViewCache.put(this, degreeId, stringValue, Item.TYPE_FLOAT);
        }
    } else if (key == urlId) {
        //从模板里直接获取到url属性值可能是一个表达式,也可能是个直接的 url,如果是表达式,暂存到 viewCache 里,等传入数据的时候再次解析,然后回调本方法里获取最终值
        if (Utils.isEL(stringValue)) {
            mViewCache.put(this, urlId, stringValue, Item.TYPE_STRING);
        } else {
            url = stringValue;
        }
    } else {
        ret = super.setAttribute(key, stringValue);
    }
    return ret;
}

最后就是使用这些属性值,在 onParseValueFinised() 里一次性应用属性:

@Override
public void onParseValueFinished() {
    super.onParseValueFinished();
    Picasso.with(mContext.getContext()).load(url).rotate(degrees).into(mPicassoImageView);
}

详细代码:PicassoImage.java

4. 注册控件

通过 ViewManager 里的 ViewFactory 注册,如下:

sViewManager.getViewFactory().registerBuilder(1014,new PicassoImage.Builder());

5. 使用与运行效果

XML 里这么写:

<VHLayout
    flag="flag_exposure|flag_clickable"
    orientation="V"
    layoutWidth="match_parent"
    layoutHeight="match_parent"
>
<VText
        text="Title: Loading Image with Picasso"
        textSize="12"
        textColor="#333333"
        background="#008899"
        layoutWidth="match_parent"
        layoutHeight="20" />

<PicassoImage
        url="${url}"
        degree="90"
        layoutWidth="match_parent"
        layoutHeight="300" />
</VHLayout>

绑定的数据:

{
  "url": "https://gw.alicdn.com/tfs/TB1l0HSgvxNTKJjy0FjXXX6yVXa-200-200.png"
}

运行的结果:

image

图片原图是这样的:

image

可以看到,通过添加自定义的 degree 属性,并调用 Picasso 的 ratate 方法,最终加载了图片,也旋转了图片,可以根据此思路继续为 PicassImage 添加更多 Picasso 支持的属性。

本文里用到的例子也上传到了 demo 里,从上午的源码链接里可以获取到完整的 demo。

体验一下

还是那句话,讲得再多,不如亲自上手体验一下,可以参考《天猫客户端组件动态化的方案——VirtualView 上手体验》《提升开发体验,预览 VirtualView》来体验。

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

推荐阅读更多精彩内容

  • 温和。温和。温和。 目录【怎么洗】1.RoX - 给干性及所有皮肤的清洁建议2.RoX - 脸是怎么烂掉的3.针线...
    易烊千玺的老公阅读 972评论 0 0
  • 一.什么是积极主动? 每一个人都应该积极地创造有利于自己发展的外部环境,并通过自我意识(理性我)来主动做出选择,对...
    许楷模阅读 184评论 1 2
  • 2017年12月16日下午,在正安聚友會蘇州分會譚會長的組織下,有緣樁友滙集恕閣,由張石山老師帶領,学習交流了形意...
    如心1976阅读 440评论 2 4
  • 清晨起,睁着迷迷糊糊的眼睛,爬起床来,揣着手就悠悠的去上早读了。 走出宿舍大门,“呼”一阵冷嗖嗖的风吹来,脖子缩的...
    卷腹小猪猪阅读 275评论 0 1
  • 故地重游 作者:一抹诗痕小窗枫雨烟波色,往事经年入纸堆。日暮寒秋身寄客,风霜草木岁痕摧。重游故地秋时景,落叶伤怀忆...
    随意诗社阅读 1,428评论 0 1