# Weex应用Android扩展 module compontent

官方Android扩展文档

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 # 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 调用如下:

    
    
    
    

    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);
        }
    }
    

    Reference

    官方Android扩展文档

    你可能感兴趣的:(# Weex应用Android扩展 module compontent)