官方Android擴(kuò)展文檔

Weex 提供了擴(kuò)展機(jī)制，可以根據(jù)自己的業(yè)務(wù)進(jìn)行定制自己的功能。
主要分為兩類擴(kuò)展：

• Module 擴(kuò)展 非 UI 的特定功能。例如 sendHttp、openURL 等。
• Component 擴(kuò)展 實(shí)現(xiàn)特別功能的 Native 控件。例如：RichTextview，RefreshListview 等。
• Adapter 擴(kuò)展 Weex 對(duì)一些基礎(chǔ)功能實(shí)現(xiàn)了統(tǒng)一的接口，可實(shí)現(xiàn)這些接口來(lái)定制自己的業(yè)務(wù)。例如：圖片下載等。

Module 擴(kuò)展

• Module 擴(kuò)展必須繼承 WXModule 類。
• 擴(kuò)展方法必須加上 @WXModuleAnno 注解。Weex 會(huì)根據(jù)注解來(lái)判斷當(dāng)前方法是否要運(yùn)行在 UI 線程，和當(dāng)前方法是否是擴(kuò)展方法。
• Weex是根據(jù)反射來(lái)進(jìn)行調(diào)用 Module 擴(kuò)展方法，所以Module中的擴(kuò)展方法必須是 public 類型。
  同樣因?yàn)槭峭ㄟ^(guò)反射調(diào)用，Module 不能被混淆。請(qǐng)?jiān)诨煜募刑砑哟a：-keep public class * extends com.taobao.weex.common.WXModule{*;}
• Module 擴(kuò)展的方法可以使用 int, double, float, String, Map, List 類型的參數(shù)
• 完成 Module 后一定要在初始化時(shí)注冊(cè) WXSDKEngine.registerModule("myModule", MyModule.class); 否則會(huì)報(bào)類似錯(cuò)誤：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 調(diào)用如下：

<template>
  <div>
    <text onclick="click">點(diǎn)擊我測(cè)試</text>
  </div>
</template>
<script>
  module.exports = {
    methods: {
      click: function() {
        weex.requireModule('myModule').printLog("我是一個(gè)測(cè)試!");
      }
    }
  }
</script>

Component 擴(kuò)展

• Component 擴(kuò)展類必須集成 WXComponent.
• Component 對(duì)應(yīng)的設(shè)置屬性的方法必須添加注解 @WXComponentProp(name=value(value is attr or style of dsl))
• Weex sdk 通過(guò)反射調(diào)用對(duì)應(yīng)的方法，所以 Component 對(duì)應(yīng)的屬性方法必須是 public，并且不能被混淆。請(qǐng)?jiān)诨煜募刑砑哟a -keep public class * extends com.taobao.weex.ui.component.WXComponent{*;}
• Component 擴(kuò)展的方法可以使用 int, double, float, String, Map, List 類型的參數(shù)
• 完成 Component 后一定要在初始化時(shí)注冊(cè) 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擴(kuò)展

public class ImageAdapter implements IWXImgLoaderAdapter {
    @Override
    public void setImage(final String url, final ImageView view, WXImageQuality quality, WXImageStrategy strategy) {
        //實(shí)現(xiàn)你自己的圖片下載，否則圖片無(wú)法顯示。

        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擴(kuò)展文檔