文章来源于网络收集而来,版权归原创者所有,如有侵权请及时联系!
集成到 Android 应用
TIP
目前,Weex 支持以下 ABI:
- x86
- armeabi-v7a
- arm64-v8a
在执行以下步骤之前,请先确认您的Android开发环境是ok的。
- JAVA环境, jdk7+
- Android Studio
- NDK r18、Cmake 3.9.0+ (可选项:如果需要编译WEEX源码,需要NDK环境支持)
1. 设置gradle依赖
TIP
从 0.28.0 开始,Weex 每次 Release 都将会发布两个二进制版本,请阅读文档了解它们的区别
dependencies {
...
// 以下两个 weex_sdk 版本二选一
//implementation 'org.apache.weex:sdk:0.28.0'
//implementation 'org.apache.weex:sdk_legacy:0.28.0'
// fastjson
implementation 'com.alibaba:fastjson:1.1.46.android'
//support library dependencies
implementation 'com.android.support:recyclerview-v7:23.1.1'
implementation 'com.android.support:support-v4:23.1.1'
implementation 'com.android.support:appcompat-v7:23.1.1'
}
2. 配置混淆规则
混淆规则如下,建议参考最新的源码配置
-keep class com.taobao.weex.bridge.** { *; }
-keep class com.taobao.weex.layout.** { *; }
-keep class com.taobao.weex.WXSDKEngine { *; }
-keep class com.taobao.weex.base.SystemMessageHandler { *; }
-dontwarn com.taobao.weex.bridge.**
3. 声明权限
在AndroidManifest.xml
中声明权限
//网络
<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
//sd卡读写
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
4. 初始化sdk
InitConfig config = new InitConfig.Builder()
//图片库接口
.setImgAdapter(new FrescoImageAdapter())
//网络库接口
.setHttpAdapter(new InterceptWXHttpAdapter())
.build();
WXSDKEngine.initialize(applicationContext,config);
5. 创建WXSDKInstance
WXSDKInstance
是weex渲染页面的基本单元,
- 通过
instance.render(url)
拉取bundle, - 在回调
IWXRenderListener
的onViewCreated
返回创建的view, - 将返回的view 添加到Activity的view上(rootView)
参见源码: WXPageActivity
public class MainActivity extends AppCompatActivity implements IWXRenderListener {
WXSDKInstance mWXSDKInstance;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
mWXSDKInstance = new WXSDKInstance(this);
mWXSDKInstance.registerRenderListener(this);
/**
* bundleUrl source http://dotwe.org/vue/38e202c16bdfefbdb88a8754f975454c
*/
String pageName = "WXSample";
String bundleUrl = "http://dotwe.org/raw/dist/38e202c16bdfefbdb88a8754f975454c.bundle.wx";
mWXSDKInstance.renderByUrl(pageName, bundleUrl, null, null,WXRenderStrategy.APPEND_ASYNC);
}
@Override
public void onViewCreated(WXSDKInstance instance, View view) {
setContentView(view);
}
@Override
public void onRenderSuccess(WXSDKInstance instance, int width, int height) {
}
@Override
public void onRefreshSuccess(WXSDKInstance instance, int width, int height) {
}
@Override
public void onException(WXSDKInstance instance, String errCode, String msg) {
}
@Override
protected void onResume() {
super.onResume();
if(mWXSDKInstance!=null){
mWXSDKInstance.onActivityResume();
}
}
@Override
protected void onPause() {
super.onPause();
if(mWXSDKInstance!=null){
mWXSDKInstance.onActivityPause();
}
}
@Override
protected void onStop() {
super.onStop();
if(mWXSDKInstance!=null){
mWXSDKInstance.onActivityStop();
}
}
@Override
protected void onDestroy() {
super.onDestroy();
if(mWXSDKInstance!=null){
mWXSDKInstance.onActivityDestroy();
}
}
}
6. 运行app
运行app,您将会看到一个 hello world
页面。
- Hello World Demo 源码
- 提示: 点击二维码, 可以看到最终编译的代码产物。
7. 扩展Android能力
Weex 提供了能力扩展机制,可以根据自己的业务进行定制自己的功能。 主要分为:
- Module 扩展, 非 UI 的特定功能。例如 sendHttp、openURL 等。
- Component 扩展, 实现特别功能的 Native 控件。例如:RichTextview,RefreshListview 等。
- Adapter 扩展, Weex 对一些基础功能实现了统一的接口,可实现这些接口来定制自己的业务。例如:图片下载等。
如果你对这篇内容有疑问,欢迎到本站社区发帖提问 参与讨论,获取更多帮助,或者扫码二维码加入 Web 技术交流群。
绑定邮箱获取回复消息
由于您还没有绑定你的真实邮箱,如果其他用户或者作者回复了您的评论,将不能在第一时间通知您!
发布评论