在执行以下步骤之前,请先确认您的Android开发环境是ok的。
NDK r16、Cmake 3.9.0+ (可选项:如果需要编译WEEX源码,需要NDK环境支持)
1. 设置gradle依赖
1 | dependencies { |
2. 配置混淆规则
混淆规则如下,建议参考最新的源码配置
1 | -keep class com.taobao.weex.bridge.** { *; } |
3. 声明权限
在AndroidManifest.xml
中声明权限
1 | //网络 |
4. 初始化sdk
1 | InitConfig config = new InitConfig.Builder() |
5. 创建WXSDKInstance
WXSDKInstance
是weex渲染页面的基本单元,
- 通过
instance.render(url)
拉取bundle, - 在回调
IWXRenderListener
的onViewCreated
返回创建的view, - 将返回的view 添加到Activity的view上(rootView)
参见源码: WXPageActivity
1 | public class MainActivity extends AppCompatActivity implements IWXRenderListener { |
6. 运行app
运行app,您将会看到一个 hello world
页面。
- Hello World Demo 源码
- 提示: 点击二维码, 可以看到最终编译的代码产物。
7. 扩展Android能力
Weex 提供了能力扩展机制,可以根据自己的业务进行定制自己的功能。 主要分为:
- Module 扩展, 非 UI 的特定功能。例如 sendHttp、openURL 等。
- Component 扩展, 实现特别功能的 Native 控件。例如:RichTextview,RefreshListview 等。
- Adapter 扩展, Weex 对一些基础功能实现了统一的接口,可实现这些接口来定制自己的业务。例如:图片下载等。