Weex技术在苏宁移动办公开发中的实践

未分类

一、 什么是weex

Weex是一套简单易用的跨平台开发方案，能以web的开发体验构建高性能、可扩展的native应用，为了做到这些，Weex与 Vue合作，使用 Vue 作为上层框架，并遵循 W3C 标准实现了统一的 JSEngine 和 DOM API，打造三端一致的 native 应用。其架构如下所示：

将weex工程文件编译成JS bundle，发布到云端，由客户端下载后，通过浏览器里的 JavaScript 引擎或 Weex SDK 运行起来的。

为了能掌握weex编程技术，开发人员需要熟悉以下几个概念（拷贝自官网http://weex.apache.org）：

Weex 页面结构

界面展示、逻辑处理、设备能力使用、生命周期管理等部分。

Dom模型

Weex 页面通过类似 HTML DOM 的方式管理界面，首先页面会被分解为一个 DOM 树，每个 DOM 结点都代表了一个相对独立的 native 视图的单元。然后不同的视图单元之间通过树形结构组合在了一起，构成一个完整的页面。

组件

Weex 支持文字text、图片image、视频video等内容型组件，也支持 div、list、scroller 等容器型组件，还包括 slider、input、textarea、switch 等多种特殊的组件。Weex 的界面就是由这些组件以 DOM 树的方式构建出来的。

布局系统

Weex 页面中的组件会按照一定的布局规范来进行排布，我们这里提供了 CSS 中的盒模型、flexbox 和 绝对/相对/固定/吸附布局这三大块布局模型。

功能

Weex 提供了非常丰富的系统功能 API，包括弹出存储、网络、导航、弹对话框和 toast 等，开发者可以在 Weex 页面通过获取一个 native module 的方式引入并调用这些客户端功能 API。

生命周期

每个 Weex 页面都有其自身的生命周期，页面从开始被创建到最后被销毁，会经历到整个过程。这是通过对 Weex 页面的创建和销毁，在路由中通过 SDK 自行定义并实现的。

在移动办公开发中的实践

注：涉及代码均以Android端为例

（一）前端遵循weex移动应用的设计理念

weex认为一个具有高并行研发能力、动态化和标准化规范化的移动应用应该由以下几个方面构成：

• 页面：首先移动应用应该可以被拆解成若干个页面，每个页面相对解耦独立，同时每个页面都有一个 URL 进行唯一标识。

• 路由：这些页面将会通过路由机制有机的串联起来，页面之间的关系是通过路由来进行调度的。常见的移动应用路由包括导航栏、tab 切换等。

• 设备能力：以各种 API 或服务的方式提供出来，供页面自由使用。

这样的话，在构建一个完整的移动应用之前，先确定你的应用有多少页面，每个页面分别是什么 URL，页面之间的路由逻辑是怎样的，然后梳理整个移动应用需要的所有 API 和服务。最后通过 Weex 创建不同的页面，并分别进行开发、调试。

（二）构建自己的标杆工程

我们基于github上的Playground项目，构建了自己的标杆工程。

将不同的js文件用做常量、工具方法的定义。常量诸如url、版本开关、路由表。工具方法诸如Http get、post方法的封装、时间转换函数、加解密方法。

除了用vue封装页面，还封装了公用的样式，构建了常用的控件库。

（三）整合weex引擎，完善移动办公微应用的接入方案

挂接glide用于替换默认的picasso图库的实现，因为目前picasso的版本没法支持gif动图。另一个好处是，可以定制图库缓冲区的大小。

挂接自己的http适配器，适度复用Native的http实现并定制到weex中，同时这也是打通native登陆凭证和weex登陆凭证的必要一环。

在项目迭代中，扩展自定义控件。这块自定义控件特指通过WXSDKEngine.registerComponent()注册的Native控件。需要严格控制这部分控件的实现。基于以下几个方面考虑：

1.Native控件需要IOS、Android同时实现，增加了开发工作量。
2.页面使用了这种控件，老版本的应用就没法进行兼容，会需要提示用户升级。
3.开发者需要充分考虑纯vue的方式是否能实现，一般都是有方法的。

即使实现了Native控件，在后续weex引擎升级过程中，也需要持续关注，可能日后标准控件库会提供支持。

定义一套开放接口，通过WXSDKEngine.registerModule()注册，weex可以适度复用H5的开放接口实现。

注册自己的webview实现替换默认的webview。实现自己的文件下载器，文件选择器，支持电话号码、邮箱等链接的点击跳转。

（四）静态资源的缓冲和缓冲更新策略配置

静态资源（js、css、图片）默认不支持缓冲策略，导致使用微应用页面总是打开较慢，且浪费流量，没能达到离线web应用的顺滑操作体验。针对此问题，移动端和服务端均需做出调整。

前面我们讲到了，在客户端一侧，针对图片适配器我们设置了glide图库，且修改了缓冲配置。而针对静态页面的加载，weex的支撑模块是WXHttpManager和WXOkHttpDispatcher。如下图所示：

对defaultOkHttpClient进行缓冲路径和大小的配置。
在服务端一侧，配上Etag策略，如果不支持则配置较老的Last-Modified+If-Modified-Since策略。其实现效果如下：

第一次请求:

1.客户端发起 HTTP GET 请求一个文件。

2.服务器处理请求，返回文件内容和Headers，当然包括Etag(如"2e681a-6-5d044840")，状态码200。

第二次请求：

1.客户端发起 HTTP GET 请求同一个文件，这个时候客户端会附带一个If-None-Match头，这个头的内容就是第一次请求时服务器返回的Etag：2e681a-6-5d044840。

2.服务器判断发送过来的Etag和按云端文件计算出来的Etag匹配，说明静态资源未变更，直接返回304，通知客户端继续使用本地缓存。

需要补充的是，对于网络请求失败或是缓冲加载失败的情况，本地需要挂接回调方法处理，并定制加载失败页面，让用户在失败页面有机会点击刷新按钮进行重试。

（五）开放接口和接口权限控制

weex引擎加载的页面包括weex和H5两种，针对H5页面，通过Javascript Interface我们挂接与其他H5应用相同的一套开发接口。

这些是一部分我们给H5提供的开放接口，通过WXSDKEngine.registerModule()我们还另行包装了一份给weex调用。考虑到部分接口涉及用户隐私，如果应用内有要使用这部分接口，在应用启动时需要像微信一样有用户授权。

（六）打通Native、weex、H5的登陆凭证

我们应用的登陆凭证是保存在Cookie当中的，所以在Native、weex、H5中打通登陆凭证，实现单点登录（Single SignOn）我们做了以下几件事：

1.包装一个CookieManager，实现cookie的读写接口以兼容新老版本。

2.进程初始化时，初始化CookieManager；账号登出时，移除Cookies。

3.在WebView页面加载成功的回调，增加Cookie强制持久化写入的逻辑。Weex WebView也增加相同逻辑。

4.在Http请求、文件传输接口处增加Cookie的读写逻辑，特别要注意的是对重定向请求的处理，需要挂接自己的回调方法，读写Cookie。Weex对应的HttpAdapter和文件传输接口也需做相同修改。

（七）升级策略

无论是通过WXSDKEngine.registerModule() 注册的接口还是通过WXSDKEngine.registerComponent()注册的组件，都是在迭代版本中逐步添加进去的。考虑到兼容性，就存在一部分老版本客户端无法使用当前weex页面部分功能的问题，所以在weex页面需要增加平台最小版本号的控制逻辑，当客户端版本低于接口所需的最小版本时，要提示用户升级。

因为用户是可以选择忽略升级的，在每个组件和开放接口的使用点，也需要增加保护，无法使用时应提示是版本过低不支持的原因。

（八）错误的云监测

在Native可以通过接口 IWXRenderListener 中的 onException 回调方法监测render error、js exception、network error等。在Weex页面，则需要通过开放接口上报错误错误。这些错误最后都通过Native接口上报到云端，做到对用户问题的实时监控。

（九）屏幕适配

Weex是固定以750px作为虚拟屏幕宽度的，所有控件的实际大小要根据设备的屏幕大小进行等比缩放。例如，当一个按钮的尺寸在页面中设定为60x100px，而屏幕实际宽度为1080px，那么按钮的显示宽度则为60x1080/750 = 86px，高度则为100x1080/750 = 144px。

（十）引擎升级和平台兼容性的坑

作为一款需要商用的应用，在集成了weex引擎后，面临引擎升级的问题，尤其在阿里官方迭代版本较密集的现状下。强烈建议慎重升级！在引擎升级后要对已上线的应用做回归测试，我们遭遇到的实际状况是引擎升级支持了一些新功能，却把部分老控件、老接口、老页面给搞坏了。例如：

1.引擎升级到16版本Android端取系统时间接口，未携带当前时区偏移，到了18版本又好了。

2.18版本 IOS 横向翻页的页面切换效果会有垂直方向偏移。

3.vue本身是支持v-model给Input来赋值的，Android端的引擎升级到18之后这块功能突然又不支持了。

Weex引擎还存在一些平台兼容性的坑，例如：

1.页面恢复的广播事件，IOS和Android不一致，Android的事件名叫WXApplicationDidBecomeActiveEvent，IOS的叫viewWillAppear。

2.在做自定义组件的时候，需要页面上盖了一个蒙板控件，如果蒙板里没有内容，在Android端，蒙板不会消耗Touch事件，在IOS端，蒙板会消耗touch事件。为了解决这个问题，当蒙板上无内容的时候，需要把IOS端蒙板的透明度改成全透明。

3.http://weex.apache.org/cn/guide/use-vue.html中列举了一些vue支持，而weex暂不支持的情况，这个一开始我们也没注意到。

结语

Weex是一个新的开发框架，在技术革新的浪潮中，我们一方面要勇于尝试这样的新技术。另一方面，也要通过软件过程控制的方法来确保应用交付的稳定，实事求是、因地制宜的解决使用中面临的具体问题和挑战。软件工程学本身就是实践者的研究方法，唯有边实践边总结，才能在技术变革中始终不落下风。

作者简介

陈思佳，苏宁易购 IT 总部移动端高级架构师，主要负责苏宁移动通讯、IoT 、移动办公等项目研发工作。在移动端架构方面拥有十多年的实践经验，先后就职于华为无线产品线、Motorola GSG（Global Software Group）。精通移动端各类应用软件的编程架构、开发工具，喜欢钻研、持续改进各产品 Android、iOS 设备兼容性问题。