摘要：
使用Weex开发Android程序的参考：开发HelloWorld程序（Weex开发）1.创建Android项目2.集成WeexSDK。请参阅[WEEXSDK集成到Android项目]（https://weex-project.io/cn/doc/advanced/integrate-to-android.html）3.开发。我们的源代码4.编译。我们将源代码作为js文件，并将js文件复制到Android项目的as
用Weex开发Android程序
1、创建Android工程
2、集成WeexSDK，参考[WEEX SDK 集成到 Android 工程](https://weex-project.io/cn/doc/advanced/integrate-to-android.html)
3、开发.we源码
4、编译.we源码为js文件，将js文件复制到Android工程的asset目录下
5、初始化sdk
6、实现渲染
WXSample地址 https://github.com/xkli/WXSample.git
Weex扩展到Android（自定义组件）
自定义组件（Android）
1.自定义组件必须继承自 WXComponent 或者 WXContainer ；
2.weex SDK 可以识别 @WXComponentProp (name = value(value 是 attr 或者 dsl style))；
3.方法必须是 public 的；
4.组件类不能是一个内部类；
5.自定义组件不能被 ProGuard 之类的工具混淆；
6.组件方法在 UI 线程被调用，因此不要在里面进行耗时的操作；
7.Weex 的参数类型可以是 int, double, float, String, Map, List 和实现了 WXObject 接口的自定义类；
参考以下例子：
package com.taobao.weex.ui.component;
// ……
public class MyViewComponent extends WXComponent{
public MyViewComponent(WXSDKInstance instance, WXDomObject node,
WXVContainer parent, String instanceId, boolean lazy) {
super(instance, node, parent, instanceId, lazy);
}
@Override
protected void initView() {
//TODO:your own code ……
}
@Override
public WXFrameLayout getView() {
//TODO:your own code ………
}
@WXComponentProp(name=WXDomPropConstant.WX_ATTR_VALUE)
public void setMyViewValue(String value) {
((TextView)mHost).setText(value);
}
}
必须注册组件：
WXSDKEngine.registerComponent("MyView", MyViewComponent.class);
自定义原生API
Weex 的 SDK 只提供了页面渲染的能力，但是一些其它操作，比如网络请求、图片加载、重定向等功能需要你自己去实现，这个例子讲述了如何用原生代码去扩展 Weex 的功能。
关于 URLHelper 的例子
新建一个 WXModule
public class URLHelperModule extends WXModule{
private static final String WEEX_CATEGORY="com.taobao.android.intent.category.WEEX";
@JsMethod
public void openURL(String url){
if (TextUtils.isEmpty(url)) {
return;
}
StringBuilder builder=new StringBuilder("http:");
builder.append(url);
Uri uri = Uri.parse(builder.toString());
Intent intent = new Intent(Intent.ACTION_VIEW, uri);
intent.addCategory(WEEX_CATEGORY);
mWXSDKInstance.getContext().startActivity(intent);
}
}
这里要注意 @JsMethod 这个注解，它表示了你把这个方法暴露给 JavaScript。
public class URLHelperModule extends WXModule{
@JsMethod
public void openURL(String url,String callbackId){
//...
//callback to javascript
Map<String, Object> result = new HashMap<String, Object>();
result.put("ts", System.currentTimeMillis());
WXBridgeManager.getInstance().callback(mWXSDKInstance.getInstanceId(), callbackId, result);
}
}
把module注册到WXSDKEngine：
try {
WXSDKEngine.registerModule("myURL", URLHelperModule.class);
//'myURL' is the name you'll use in javascript
} catch (WXException e) {
WXLogUtils.e(e.getMessage());
}
在 JavaScript 中使用 eventModule：
let URLHelper = require('@weex-module/myURL');//same as you registered
URLHelper.openURL("http://www.taobao.com",function(ts){
console.log("url is open at "+ts);
});
一些注意事项：
定义一个 components 需要继承 WXModule
不要忘记添加 @WXModuleAnno 注解，不然 Weex 没法识别这个方法
定义的方法必须是 `public 的
module 类一定不能是内部类
你定义的 components 不能被混淆，不然会找不到
Module 中的方法会在 UI 线程中被调用，所以一定不要做一些耗时操作
Moudle 中的方法参数类型可以为 int，double，float，String，Map，List，以及实现 WXObject 接口的类。