当前环境为
weex 1.3.13-beta.7
,vue2.0用法
本文总体根据官网链接https://weex.apache.org/cn/guide/integrate-to-your-app.html 进行集成,同时记录下遇到的问题和解决方法。
引入gradle
// ============= weex start =============
compile 'com.android.support:recyclerview-v7:23.1.1'
compile 'com.android.support:support-v4:23.1.1'
compile 'com.android.support:appcompat-v7:23.1.1'
compile 'com.alibaba:fastjson:1.1.46.android'
compile 'com.taobao.android:weex_sdk:0.16.0@aar'
// ============= weex end =============
// 图片库框架
compile 'com.github.bumptech.glide:glide:3.7.0'
ps: 版本可以高不可以低。官网文档weex_sdk:0.5.1
会报错误E/jsengine: ReportException :undefined:5: ReferenceError: Vue is not defined
改成当前最新版即可,这里用的是weex_sdk:0.16.0
。
ImageAdapter配置
public class ImageAdapter implements IWXImgLoaderAdapter {
@Override
public void setImage(final String url, final ImageView view, WXImageQuality quality, WXImageStrategy strategy) {
//实现你自己的图片下载,否则图片无法显示。
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);
}
}
application初始化
public class WXApplication extends Application {
@Override
public void onCreate() {
super.onCreate();
InitConfig config = new InitConfig.Builder().setImgAdapter(new ImageAdapter()).build();
WXSDKEngine.initialize(this, config);
}
}
开始渲染Weex View
public class WeexActivity extends AppCompatActivity implements IWXRenderListener {
WXSDKInstance mWXSDKInstance;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_weex);
mWXSDKInstance = new WXSDKInstance(this);
mWXSDKInstance.registerRenderListener(this);
/**
* WXSample 可以替换成自定义的字符串,针对埋点有效。
* template 是.we transform 后的 js文件。
* option 可以为空,或者通过option传入 js需要的参数。例如bundle js的地址等。
* jsonInitData 可以为空。
* width 为-1 默认全屏,可以自己定制。
* height =-1 默认全屏,可以自己定制。
*/
mWXSDKInstance.render("WXSample", WXFileUtils.loadAsset("index.js", this), null, null, -1, -1, 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) {
Toast.makeText(this, "onException: " + errCode + ", " + msg, Toast.LENGTH_SHORT).show();
}
@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();
}
}
}
主要是mWXSDKInstance.render("WXSample", WXFileUtils.loadAsset("index.js", this), null, null, -1, -1, WXRenderStrategy.APPEND_ASYNC);
这一句, mWXSDKInstance.render
加载本地目录js文件, mWXSDKInstance.renderByUrl
可加载远程js文件,实现热更新。
jsbundle资源生成
android加载weex和加载RN类似也是要提供个jsbundle
文件。weex生成jsbundle
也很简单,在weex项目下运行npm run build
, 编译完成后会在dist目录下生成文件。每个vue
文件会生成对应的js
。
把dist目录下js文件拷贝到android assets
目录。至此,集成完成。
源码
https://github.com/huazhiyuan2008/WeexHotFixDemo
思考与总结
-
weex_sdk
版本最好要最新,遇到莫名其妙的问题,可以考虑升级此版本 - 每个vue生成单独的jsbundle,这样做到页面文件独立,size很小,有利于热更新加载速度。
- 热更新整体方案和细节进一步思考