Weex 提供了扩展机制，可以根据自己的业务进行定制自己的功能。
主要分为两类扩展：
- Module 扩展 非 UI 的特定功能。例如 sendHttp、openURL 等。
- Component 扩展 实现特别功能的 Native 控件。例如：RichTextview，RefreshListview 等。
- Adapter 扩展 Weex 对一些基础功能实现了统一的接口，可实现这些接口来定制自己的业务。例如：图片下载等。
Module 扩展
- Module 扩展必须继承
WXModule类。 - 扩展方法必须加上
@WXModuleAnno注解。Weex 会根据注解来判断当前方法是否要运行在 UI 线程，和当前方法是否是扩展方法。 - Weex是根据反射来进行调用
Module扩展方法，所以Module中的扩展方法必须是public类型。
同样因为是通过反射调用，Module 不能被混淆。请在混淆文件中添加代码：-keep public class * extends com.taobao.weex.common.WXModule{*;} - Module 扩展的方法可以使用
int, double, float, String, Map, List类型的参数 - 完成 Module 后一定要在初始化时注册
WXSDKEngine.registerModule("myModule", MyModule.class);否则会报类似错误：ReportException :undefined:9: TypeError: Object #<Object> has no method 'printLog'
public class MyModule extends WXModule {
@WXModuleAnno(runOnUIThread = true)
public void printLog(String msg) {
Toast.makeText(mWXSDKInstance.getContext(),msg,Toast.LENGTH_SHORT).show();
}
// as sync-callback mode
@JSMethod (uiThread = true)
public void testSyncCall(){
WXLogUtils.d("WXComponentSyncTest : Thread.currentThread().getName());
}
// as async-callback mode
@JSMethod (uiThread = false)
public void testAsyncCall(){
WXLogUtils.e("WXComponentASynTest : Thread.currentThread().getName() );
}
}
JS 调用如下：
<template>
<div>
<text onclick="click">点击我测试</text>
</div>
</template>
<script>
module.exports = {
methods: {
click: function() {
weex.requireModule('myModule').printLog("我是一个测试!");
}
}
}
</script>
Component 扩展
- Component 扩展类必须集成
WXComponent. - Component 对应的设置属性的方法必须添加注解
@WXComponentProp(name=value(value is attr or style of dsl)) - Weex sdk 通过反射调用对应的方法，所以 Component 对应的属性方法必须是 public，并且不能被混淆。请在混淆文件中添加代码
-keep public class * extends com.taobao.weex.ui.component.WXComponent{*;} - Component 扩展的方法可以使用
int, double, float, String, Map, List类型的参数 - 完成 Component 后一定要在初始化时注册
WXSDKEngine.registerComponent("richtext",RichText.class);
public class RichText extends WXComponent {
public RichText(WXSDKInstance instance, WXDomObject dom, WXVContainer parent, boolean isLazy) {
super(instance, dom, parent, isLazy);
}
@Override
protected void initView() {
mHost=new TextView(mContext);
((TextView)mHost).setMovementMethod(LinkMovementMethod.getInstance());
}
@WXComponentProp(name = "tel")
public void setTelLink(String tel){
SpannableString spannable=new SpannableString(tel);
spannable.setSpan(new URLSpan("tel:"+tel),0,tel.length(), Spanned.SPAN_EXCLUSIVE_EXCLUSIVE);
((TextView)mHost).setText(spannable);
}
}
Adapter扩展
public class ImageAdapter implements IWXImgLoaderAdapter {
@Override
public void setImage(final String url, final ImageView view, WXImageQuality quality, WXImageStrategy strategy) {
//实现你自己的图片下载，否则图片无法显示。
WXSDKManager.getInstance().postOnUiThread(new Runnable() {
@Override
public void run() {
Glide.with(WXEnvironment.getApplication()).load(url).placeholder(R.mipmap.ic_launcher).diskCacheStrategy(DiskCacheStrategy.SOURCE).crossFade().dontAnimate().into(view);
}
}, 0);
}
}
