我的书签
添加书签
移除书签Android 扩展
Weex 提供了扩展机制，可以根据自己的业务进行定制自己的功能。
主要分为两类扩展：
* Module 扩展 非 UI 的特定功能。例如 sendHttp、openURL 等。
* Component 扩展 实现特别功能的 Native 控件。例如：RichTextview，RefreshListview 等。
* Adapter 扩展 Weex 对一些基础功能实现了统一的接口，可实现这些接口来定制自己的业务。例如：图片下载等。
Module 扩展
- Module 扩展必须继承 WXModule 类。
- 扩展方法必须加上
@JSMethod (uiThread = false or true)注解。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'
示例如下： 1. public class MyModule extends WXModule{ 2. 3. //run ui thread 4. @JSMethod (uiThread = true) 5. public void printLog(String msg) { 6. Toast.makeText(mWXSDKInstance.getContext(),msg,Toast.LENGTH_SHORT).show(); 7. } 8. 9. //run JS thread 10. @JSMethod (uiThread = false) 11. public void fireEventSyncCall(){ 12. //implement your module logic here 13. } 14. }
Register the module 1. WXSDKEngine.registerModule("MyModule", WXEventModule.class);
JS 调用如下：
1.
2.
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);
示例如下: 1. public class RichText extends WXComponent { 2. 3. public RichText(WXSDKInstance instance, WXDomObject dom, WXVContainer parent, boolean isLazy) { 4. super(instance, dom, parent, isLazy); 5. } 6. 7. @Override 8. protected void initView() { 9. mHost=new TextView(mContext); 10. ((TextView)mHost).setMovementMethod(LinkMovementMethod.getInstance()); 11. } 12. 13. @WXComponentProp(name = "tel") 14. public void setTelLink(String tel){ 15. SpannableString spannable=new SpannableString(tel); 16. spannable.setSpan(new URLSpan("tel:"+tel),0,tel.length(), Spanned.SPAN_EXCLUSIVE_EXCLUSIVE); 17. ((TextView)mHost).setText(spannable); 18. } 19. }
注册你的组件： 1. WXSDKEngine.registerComponent("MyView",MyViewComponent.class);
JS 调用如下：
1.
2.
组件方法支持
从WeexSDK 0.9.5开始，你可以定义组件方法
* 在组件中如下声明一个组件方法
1. @JSMethod
2. public void focus(){
3. //method implementation
4. }
* 注册组之后，你可以在weex 文件中调用
1.
2.
注:工程要添加依赖 compile 'com.squareup.picasso:picasso:2.5.2'
Adapter扩展
图片下载： 需要时集成接口 IWXImgLoaderAdapter，实现 setImage 方法。 示例如下： 1. public class ImageAdapter implements IWXImgLoaderAdapter { 2. 3. public ImageAdapter() { 4. } 5. 6. @Override 7. public void setImage(final String url, final ImageView view, 8. WXImageQuality quality, WXImageStrategy strategy) { 9. 10. WXSDKManager.getInstance().postOnUiThread(new Runnable() { 11. 12. @Override 13. public void run() { 14. if(view==null||view.getLayoutParams()==null){ 15. return; 16. } 17. if (TextUtils.isEmpty(url)) { 18. view.setImageBitmap(null); 19. return; 20. } 21. String temp = url; 22. if (url.startsWith("//")) { 23. temp = "http:" + url; 24. } 25. if (view.getLayoutParams().width <= 0 || view.getLayoutParams().height <= 0) { 26. return; 27. } 28. Picasso.with(WXEnvironment.getApplication()) 29. .load(temp) 30. .into(view); 31. } 32. },0); 33. } 34. }
SDK混淆规则
若要在APP中使用混淆，请在相应的配置文件中添加如下规则：
1. -keep class com.taobao.weex.WXDebugTool{;}
2. -keep class com.taobao.weex.devtools.common.LogUtil{;}
3. -keepclassmembers class ** {
4. @com.taobao.weex.ui.component.WXComponentProp public *;
5. }
6. -keep class com.taobao.weex.bridge.**{*;}
7. -keep class com.taobao.weex.dom.{;}
8. -keep class com.taobao.weex.adapter.{;}
9. -keep class com.taobao.weex.common.{;}
10. -keep class * implements com.taobao.weex.IWXObject{;}
11. -keep class com.taobao.weex.ui.{;}
12. -keep class com.taobao.weex.ui.component.{;}
13. -keep class com.taobao.weex.utils.{
14. public
