weex旨在“一次撰写,多端使用”,意思是,用weex写的页面,不论是Android还是iOS甚至web端都可以使用,这样的话就可以极大的降低开发成本, weex其实就是写的一个类似于h5的页面(js编写),写完之后将vue文件编译、部署到Nginx服务器上(Nginx服务器后面会讲到),这时候在你的Nginx服务器下的html文件夹内会生成一个.js的文件,这个.js文件就是你要嵌入到Android项目内的文件,如果一个项目内有很多个weex页面,就需要编译部署很多个vue文件,也就是说会在html这个文件夹下生成很多个.js文件,然后你可能会问,那我们要怎么管理和维护这么多个.js文件呢?这就需要我们将这些个.js压缩成一个zip包,把这个压缩后的zip包个后台,后台会生成一个json文件,将这个.json放在Nginx服务器的html文件夹内,我们需要做的就只是管理和维护这个.json文件就可以了,最后在你的Android项目内,访问这个Nginx服务器(服务器的地址就是你电脑的ip地址),获取到服务器上的weex页面(其实这也能做到预加载的作用)然后进行各种处理和操作;
最近为了项目需要(实际上是为了年底KPI),领导要求用3天时间,学习并使用weex开发一个页面,说实话,压力山大。在这之前压根儿就没听说过啊,一脸懵逼
无奈之余只能Google了,惊喜的发现weex的官网上面是什么都有啊,环境搭建、weex集成开发、js教程等等还有好多,双手奉上官网地址:http://weex.apache.org/cn/
既然官网讲的这么全面,我就只说一下我的操作流程;
1、weex环境搭建
首先下载安装node.js,node.js是weex编译、打包用的基础工具,javascript和node.js关系,类似于java与jvm,nodejs去官方网站下载最新稳定版6.xx就可以
安装好了之后,用以下命令检查是否安装成功
node -v
npm -v
出现上图就说明node.js安装成功了
npm是nodejs的包管理工具,相当于android中的gradle或者iOS中的cocoapods,但是npm在国内访问速度较慢,建议大家安装cnpm,是淘宝的一个npm国内镜像
安装完cnpm后执行cnpm install -g weex-toolkit安装weex-toolkit
$ npm install -g cnpm --registry=https://registry.npm.taobao.org
$ cnpm install -g weex-toolkit
命令行敲weex,出现上图就说明weex-toolkit安装成功了。
至此weex的安装就告一段落了,官网上的环境搭建到这里之后还有几步,不过我都没有用上,这里先记一下,后续需要用到了再补充!!!!!!
2、集成到 Android
接下来就是将weex项目集成到Android项目中去,这块真是没有什么好讲的,这块就和集成第三方sdk一毛一样的
直接上官网的集成方式:http://weex.apache.org/cn/guide/integrate-to-your-app.html
2-1、个人对weex开发的理解
说一下我对在Android中集成weex的理解吧,可能理解的很浅显,不喜勿喷!
weex旨在“一次撰写,多端使用”,意思是,用weex写的页面,不论是Android还是iOS甚至web端都可以使用,这样的话就可以极大的降低开发成本,
weex其实就是写的一个类似于h5的页面(js编写),写完之后将vue文件编译、部署到Nginx服务器上(Nginx服务器后面会讲到),这时候在你的Nginx服务器下的html文件夹内会生成一个.js的文件,这个.js文件就是你要嵌入到Android项目内的文件,如果一个项目内有很多个weex页面,就需要编译部署很多个vue文件,也就是说会在html这个文件夹下生成很多个.js文件,然后你可能会问,那我们要怎么管理和维护这么多个.js文件呢?这就需要我们将这些个.js压缩成一个zip包,把这个压缩后的zip包个后台,后台会生成一个json文件,将这个.json放在Nginx服务器的html文件夹内,我们需要做的就只是管理和维护这个.json文件就可以了,最后在你的Android项目内,访问这个Nginx服务器(服务器的地址就是你电脑的ip地址),获取到服务器上的weex页面(其实这也能做到预加载的作用)然后进行各种处理和操作;
生成的.json文件就是这么个东西,在后文要讲的获取页面,完全靠这里面的url,非常的重要;
贴一些util代码吧:
//在mainActivity或者启动页获取weex相关json文件
WeexUtils.getPages();
public static void getPages() {
new Thread(new Runnable() {
@Override
public void run() {
String url = http://ip地址/后台生成的.json文件;
okhttp3.Request request = new okhttp3.Request.Builder()
.url(url)
.build();
try {
okhttp3.Response response = AlbatrossApplication.getInstance().getClient().newCall(request).execute();
String data = response.body().string();
//okhttp请求.json数据,最后将请求到的数据通过sharedprefer存储到本地
SharedPreferences pages = AlbatrossApplication.getInstance().getSharedPreferences("pages", MODE_PRIVATE);
pages.edit().putString("pages", data).commit();
downloadBundle();
} catch (IOException e) {
e.printStackTrace();
}
}
}).start();
}
下载weex bundle:
/**
* 下载weex bundle
*/
public static void downloadBundle() {
new Thread(new Runnable() {
@Override
public void run() {
try {
SharedPreferences pages = AlbatrossApplication.getInstance().getSharedPreferences("pages", MODE_PRIVATE);
String pagesData = pages.getString("pages", "");
com.alibaba.fastjson.JSONObject jsonObject = JSON.parseObject(pagesData);
String url = jsonObject.getJSONObject("zip").getString("url");
String path = AlbatrossApplication.getInstance().getCacheDir() + File.separator + "weex";
if (!new File(path).exists()) {
new File(path).mkdirs();
}
File downloadedFile = new File(path, "js_bundle.zip");
String localMd5 = WeexUtils.calculateMD5(downloadedFile);
if (jsonObject.getJSONObject("zip").getString("md5").equals(localMd5)) {
//本地zip和服务器zip一致,return
return;
}
okhttp3.Request request = new okhttp3.Request.Builder()
.url(url)
.build();
okhttp3.Response response = AlbatrossApplication.getInstance().getClient().newCall(request).execute();
BufferedSink sink = Okio.buffer(Okio.sink(downloadedFile));
sink.writeAll(response.body().source());
sink.close();
Log.e("bobo", downloadedFile.length() + " " + downloadedFile.getAbsolutePath());
WeexUtils.unzip(downloadedFile, new File(path));
Log.e("bobo 当前目录文件数", new File(path).listFiles().length + "");
// downloadPatch();//下载patch
} catch (Exception e) {
e.printStackTrace();
}
}
}).start();
}
以上的操作就可以获取到weex页面了,获取到了之后就可以开始操作了,这里我就简单的举一个点击跳转的例子好了,上代码
View view = findviewById(R.id.tv_consist);
view.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
WXSDKInstance mWXSDKInstance = new WXSDKInstance(getActivity());
Intent intent = new Intent(getActivity(), WeexActivity.class);
intent.putExtra("WX_URL", "/html文件夹下的js文件.js");
mWXSDKInstance.getContext().startActivity(intent);
}
});
跳转到WeexActivity后,在WeexActivity进行的处理就是将前文存储在本地的数据解析,根据解析后的数据获取到指定.js文件的路径,最后加载这个路径的页面,这块挺乱的,我说的只是一个大概方向,具体的还要看实际情况;
public class WeexActivity extends BaseMainActivity implements View.OnClickListener, IWXRenderListener {
private String TEST_URL = "http://172.16.36.232/dist/jump.js";
private WXSDKInstance mWXSDKInstance;
private FrameLayout mContainer;
private TextView mTv_title;
private HashMap<String, String> mLocalBundleBean;
private TextView mTv_right;
private boolean isFinish = true;
private View mTv_left;
@Override
protected void onCreate(@Nullable Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
// KYApplication.getInstance().addActivity(this);
setContentView(R.layout.activity_weex);
initView();
WXSDKEngine.setActivityNavBarSetter(new NavigatorAdapter());
mContainer = (FrameLayout) findViewById(R.id.container);
mWXSDKInstance = new WXSDKInstance(this);
mWXSDKInstance.registerRenderListener(this);
/**
* pageName:自定义,一个标示符号。
* url:远程bundle JS的下载地址
* options:初始化时传入WEEX的参数,比如 bundle JS地址
* flag:渲染策略。WXRenderStrategy.APPEND_ASYNC:异步策略先返回外层View,其他View渲染完成后调用onRenderSuccess。WXRenderStrategy.APPEND_ONCE 所有控件渲染完后后一次性返回。
*/
Map<String, Object> options = new HashMap<>();
String wx_url = getIntent().getStringExtra("WX_URL");
String title = getIntent().getStringExtra("title");
// mTv_title.setText(title);
TEST_URL = wx_url.substring(wx_url.lastIndexOf("/")+1);
options.put(WXSDKInstance.BUNDLE_URL, TEST_URL);
//获取集合,维护文件md5值以及文件对应路径
//从json文件里,取出md5对应的文件,有则加载文件,无则加载url
SharedPreferences pages = getSharedPreferences("pages", MODE_PRIVATE);
String pageData = pages.getString("pages", "");
JSONObject jsonObject = JSON.parseObject(pageData);
JSONArray jsonArray = jsonObject.getJSONArray("pages");
HashMap<String, PageBean> pageMap = new HashMap<>();//存储服务器最新页面信息
for (int i = 0; i < jsonArray.size(); i++) {
PageBean pageBean = JSON.parseObject(jsonArray.getString(i), PageBean.class);
pageMap.put(pageBean.getPage(), pageBean);
}
mLocalBundleBean = new HashMap<>();
try {
long time = System.currentTimeMillis();
getAllFiles(new File(Constant.WEEX_URL));//本地zip包解压文件md5
Log.e("bobo", "计算md5总耗时" + (System.currentTimeMillis() - time));
} catch (Exception e) {
e.printStackTrace();
}
PageBean pageBean = pageMap.get(TEST_URL);//获取login.js对应的md5、url
if(pageBean==null){
Toast.makeText(this,"页面不存在", Toast.LENGTH_SHORT).show();
return;
}
String localUrl = mLocalBundleBean.get(pageBean.getMd5());
TEST_URL=pageBean.getUrl();
if (null != localUrl) {
mWXSDKInstance.render(TEST_URL, WXFileUtils.loadFileOrAsset(localUrl, this), null, null, WXRenderStrategy.APPEND_ASYNC);
Log.e("bobo","从本地加载");
} else {
mWXSDKInstance.renderByUrl(TEST_URL, TEST_URL, options, null, WXRenderStrategy.APPEND_ONCE);
Log.e("bobo","从网络加载");
}
// mWXSDKInstance.renderByUrl("WXSample", TEST_URL, options, null, WXRenderStrategy.APPEND_ONCE);
}
public void initView() {
mTv_left = findViewById(R.id.tv_left);
mTv_title = (TextView) findViewById(R.id.tv_title);
mTv_right = (TextView) findViewById(R.id.tv_right);
mTv_left.setOnClickListener(this);
mTv_title.setOnClickListener(this);
mTv_right.setOnClickListener(this);
}
@Override
public void onClick(View view) {
if (view.getId() == R.id.tv_left) {
if(isFinish){
super.onBackPressed();
}else {
mWXSDKInstance.fireGlobalEventCallback("left_click", null);
}
} else if (view.getId() == R.id.tv_title) {
// Toast.makeText(this, "标题点击了", Toast.LENGTH_SHORT).show();
} else if (view.getId() == R.id.tv_right) {
mWXSDKInstance.fireGlobalEventCallback("clickrightitem", null);
}
}
@Override
protected void onStart() {
super.onStart();
if (mWXSDKInstance != null) {
mWXSDKInstance.onActivityStart();
}
}
@Override
protected void onResume() {
super.onResume();
WXStorageModule wxStorageModule = new WXStorageModule();
wxStorageModule.setItem("currentPage", WXUtils.getNameFromUrl(TEST_URL),null);
if (mWXSDKInstance != null) {
mWXSDKInstance.onActivityResume();
//发送页面出现广播
Map<String, Object> params = new HashMap<>();
params.put("page", WXUtils.getNameFromUrl(TEST_URL));
mWXSDKInstance.fireGlobalEventCallback("appear", params);
}
}
@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();
// KYApplication.getInstance().deleteActivity(this);
if (mWXSDKInstance != null) {
mWXSDKInstance.onActivityDestroy();
}
}
@Override
public void onViewCreated(WXSDKInstance instance, View view) {
if (view.getParent() != null) {
((ViewGroup) view.getParent()).removeView(view);
}
mContainer.addView(view);
//发送页面出现广播
Map<String, Object> params = new HashMap<>();
params.put("page", WXUtils.getNameFromUrl(TEST_URL));
mWXSDKInstance.fireGlobalEventCallback("appear", params);
}
@Override
public void onRenderSuccess(WXSDKInstance wxsdkInstance, int i, int i1) {
}
@Override
public void onRefreshSuccess(WXSDKInstance wxsdkInstance, int i, int i1) {
}
@Override
public void onException(WXSDKInstance wxsdkInstance, String s, String s1) {
}
private class NavigatorAdapter implements IActivityNavBarSetter {
@Override
public boolean push(String param) {
return false;
}
@Override
public boolean pop(String param) {
return false;
}
@Override
public boolean setNavBarRightItem(String param) {
String title = JSON.parseObject(param).getString("title");
if(!TextUtils.isEmpty(title) && ("添加报价".equals(title) || "返回首页".equals(title))){
mTv_right.setTextColor(getResources().getColor(R.color.color_5E8BF8));
}
mTv_right.setText(title);
return false;
}
@Override
public boolean clearNavBarRightItem(String param) {
return false;
}
@Override
public boolean setNavBarLeftItem(String param) {
return false;
}
@Override
public boolean clearNavBarLeftItem(String param) {
return false;
}
@Override
public boolean setNavBarMoreItem(String param) {
return false;
}
@Override
public boolean clearNavBarMoreItem(String param) {
return false;
}
@Override
public boolean setNavBarTitle(String param) {
String title = JSON.parseObject(param).getString("title");
mTv_title.setText(title);
return false;
}
}
public void getAllFiles(File file) throws Exception {
File[] files = file.listFiles();
// long time = System.currentTimeMillis();
for (int i = 0; i < files.length; i++) {
if (files[i].isDirectory()) {
getAllFiles(files[i]);
} else {
Log.e("bobo", "name" + files[i].getName() + " md5" + WeexUtils.calculateMD5(files[i]));
mLocalBundleBean.put(WeexUtils.calculateMD5(files[i]), files[i].getAbsolutePath());
}
}
}
/**
* @return get mWXSDKInstance
*/
public WXSDKInstance getWXSDKInstance() {
return mWXSDKInstance;
}
@Override
public void onBackPressed() {
if(isFinish){
super.onBackPressed();
}else {
mWXSDKInstance.fireGlobalEventCallback("back_click", null);
}
}
/**
* Sets the isFinish 设置是否直接返回上个页面
* You can use getFinish() to get the value of isFinish
*/
public void setFinish(boolean finish) {
isFinish = finish;
}
public void hideBackButton(){
mTv_left.setVisibility(View.GONE);
}
}
View Code
3、Nginx服务器
终于到最后一步了,Nginx服务器下载地址:http://nginx.org/en/download.html
我是下载的稳定版
下载完之后解压到文件夹下,双击nginx.exe启动服务,打开conf这个文件夹,打开nginx.conf这个文件,修改location下的root
3-1、编译、部署.vue文件
哦。对了,大家应该都是到用webstorm写vue页面吧??哈哈哈哈
(1)首次创建项目或者是首次导入项目的时候,需要在控制台执行:cnpm install,这个就类似于Android studio中的sync now。
我们需要通过这个命令将package.json中的所有依赖下载下来;
(2)同样的,控制台执行:weex compile src/vue文件名 D:\nginx\nginx-1.12.2\html
意思是将制定的vue文件编译到nginx服务器下的指定文件夹内,这时候就会生成一个前文所说到的.js文件。
终于全都结束了,这是我今天一天的调研学习的成果,可能有一些地方理解的有偏差或者不对的地方,非常欢迎大家批评指正
如果有任何疑问,欢迎留言~~~~
2017/12/6 21:05 晚安各位