自打出生的那一天起,Weex 就免不了被拿来同 React Native「一决高下」的命运。React Native 宣称「Learn Once, Write Anywhere」,而 Weex 宣称「Write Once, Run Everywhere」。在我看来,并无谁更好,只有谁更合适。下面我将围绕 Weex 入门进行讲解。
(若是你尚不了解 React Native,并想简单入门,能够阅读 【整理】React Native 快速入门笔记)
什么都不说,先给你感觉下 Weex 的效果。如下就是我使用 Weex,4*8h(不连续)作出来的 demo,其中还包括素材收集,踩坑总结等时间。javascript
此处是 demo 源码:
https://github.com/zwwill/yanxuan-weex-demo
不得不说,使用 Weex 开发 app 对于咱们纯前端人员来讲,是件「很爽」的事情,只要你熟悉了他的语法,基本能够作到一周上手写 app。极其适合交互要求不高,时间紧迫,人手不足的同构开发需求。css
可是,固然有可是,若是你想写出一个完美的 app,你就须要在性能优化上下很大的功夫,包括动画的优化,过场的优化,图片的优化,细节的打磨等等,再者,就是你须要掌握或者「能写」一些原生的代码,否则有些功能你是实现不了的,好比 status bar 的属性更改,开场动画的制做,内存的回收,webview 的监听等等。html
下面咱们具体讲讲入门知识前端
Weex 提供了多端一致的技术方案。vue
在同构这条路上,Weex 比 React Native作得更完全,他「几乎」作到了,「你来使用 vue 写一个webapp,我顺便给你编译成了 ios 和 android 的原生 app」html5
至于为何要造这个轮子,官方给了如下说法java
一、今天在技术社区有大量的 web 开发者,Weex 能够赋能更多的 web 开发者构建高性能和高体验的移动应用。
二、Web 开发自己具备很是强的高效率和灵活性,这和 Weex 想解决的移动端动态性问题不谋而合。
三、Web 标准和开发体验是不少顶尖而优秀的科技公司共同讨论和建设的结果,自己的设计和理念都有极高的品质保障
四、同时 Weex 也但愿能够借此机会努力为标准贡献一点本身的微薄之力。
五、Web 是一种标准化的技术,标准自己就是一种力量,基于标准、尊重标准、贴近标准都意味着拥有更多的可能性。
六、Web 今天的生态和社区是很是繁荣的,有不少成熟的工具、库、工程体系、最佳实践可使用、引入和借鉴。
在我看来,Weex 实际上是 Alibaba 团队提升生产效率的产物,在淘宝这类要求多端统一迭代快速的部门,三端约定一种便于统一的规范,在加上时间的发酵,渐渐的就有了此类脚手架的雏形,同时在脸书 React Native 开源带来的极大轰动后,本身也坐不住了吧^_^node
好了,闲话就说到这,下面就来让咱们解剖一下WEEX的优劣良莠。android
入门 Weex 前须要了解如下知识,这样能帮助你更快的掌握
Node:《Node.js 教程》
Vue:《Vue.js官方教程》
ES6:《ECMAScript 6 入门》
再者就是 ios 和 android 开发语法的入门和编辑器的使用webpack
IOS : MacOS
, 黑苹果
Android :MacOS
, Linux
, Windows
你能够参考官方文档安装必须的依赖环境 http://weex.apache.org/cn/guide/set-up-env.html,
也能够直接安装如下环境
安装 Xcode IDE 和 Xcode 的命令行工具(IOS 开发依赖)
下载必须的插件:
a) JDK1.8+
b) Show Package Details
c) Android SDK Build Tools
d) Android Support Repository
配置基础环境:
a) ANDROID_HOME (如运行是遇到问题可参考此文 http://www.jianshu.com/p/a77396301b22)
b) JAVA_HOME
官方文档上的入门 Hello world 是 web 端的,紧接着介绍了如何「集成 Weex 到已有应用」
可是,身为一个 web 前端开发者,若是你不懂原生语音的话,介绍这些并不能起到很好的引导做用,由于web前端开发者都有「一统前端界」的野心(Web+Android+IOS),「寄人篱下」只能是暂时的。
快速建立并运行一个纯 Weex App 对于「纯」前端同窗来讲,才是有意思的事儿。
但:
为何文档要这么设计也是跟Weex的定位有关的,读完下文后续你就慢慢懂了,后面我将作总结解释
若是你在官方教程里没有找到建立工程的教程,能够阅读此文《Weex 快速建立工程 Hello World》
Weex 在迭代的过程当中选择了于 Vue 2.0 握手,由于该版本的 Vue 加入了 Virtual-DOM 和预编译器的设计,使得该框架在运行时可以脱离 HTML 和 CSS 解析,只依赖 JavaScript,如此,Vue 在和 Weex 合做后,便得到了使用 JS 预编译原生的组件 UI 的能力。
同 React Native 同样,有人也将 Weex 叫作 Vue Native。
若是你对 Vue 还不了解,能够先学习【预科】部分推荐的《Vue.js 官方教程》。
那么接下来咱们讲讲,Vue 在 Weex 中的不一样
虽然说 Weex 使用 Vue 语言写的,但毕竟是须要在不一样平台间运行的,虽然大部分语法都有支持,可是依然有部分语法是不一样的
目前 Weex 支持了基本的容器 (div)、文本 (text)、图片 (image)、视频 (video) 等组件,注意是组件,而不是标签,虽然使用起来跟 html 标签很像,至于其余标签基本可使用以上组件组合而成。
由于 Weex 解析 vue 获得的并非 dom,而是原生布局树
并不支持 Web 中全部的事件类型,详情请参考《通用事件》
在 Weex 中可以调用移动设备原生 API,使用方法是经过注册、调用模块来实现。其中有一些模块是 Weex 内置的,如 clipboard 、 navigator 、storage 等。
《clipboard 剪切板》
《navigator 导航控制》
《storage 本地存储 》
为了保持框架的通用性,Weex 内置的原生模块有限,不过 Weex 提供了横向扩展的能力,能够扩展原生模块,具体的扩展方法请参考《iOS 扩展》 和《Android 扩展》。
Weex 中的样式是由原生渲染器解析的,出于性能和功能复杂度的考虑,Weex 对 CSS 的特性作了一些取舍
一、Weex 中只支持单个类名选择器,不支持关系选择器,也不支持属性选择器。
二、组件级别的做用域,为了保持 web 和 Native 的一致性,须要<style scoped>
写法
三、支持了基本的盒模型和 flexbox 布局,详情可参考Weex 通用样式文档。可是须要注意的是,
display: none;
可用opacity: 0;
代替,(opacity<=0.01时,元素可点透)举个栗子,如下是严选App Demo首页的简化代码
<template> <div class="wrapper"> <text class="iconfont"></text> <home-header></home-header> <scroller class="main-list" offset-accuracy="300px"> <refresher></refresher> <div class="cell-button" @click="jumpWeb('https://m.you.163.com')"> <yx-slider :imageList="YXBanners" ></yx-slider> </div> <div class="cell-button"> <block-1 :title="block1.title" :items="block1.items"></block-1> </div> </scroller> </div> </template> <style scoped> .iconfont { font-family:iconfont; } .main-list{ position: fixed; top: 168px; bottom: 90px; left: 0; right: 0; } </style> <script> var navigator = weex.requireModule('navigator'); import util from '../../src/assets/util'; import Header from '../components/Header.vue'; import refresher from '../components/refresh.vue'; import YXSlider from '../components/YXSlider.vue'; import Block1 from '../components/Block1.vue'; export default { components: { 'home-header': Header, 'refresher': refresher, 'yx-slider': YXSlider, 'block-1': Block1 }, data () { return { YXBanners: [ { title: '', src: 'http://doc.zwwill.com/yanxuan/imgs/banner-1.jpg'}, { title: '', src: 'http://doc.zwwill.com/yanxuan/imgs/banner-2.jpg'}, { title: '', src: 'http://doc.zwwill.com/yanxuan/imgs/banner-3.jpg'} ] } }, methods: { jumpWeb (_url) { const url = this.$getConfig().bundleUrl; navigator.push({ url: util.setBundleUrl(url, 'page/web.js?weburl='+_url) , animated: "true" }); } } } </script>
若是以上代码脱离工程单独出现,基本上是没法得知他是 Weex 工程。此处可切实感觉到 Weex 的 web 开发体验
<template> <div> <text v-for="(v, i) in list" class="text">{{v}}</text> <image style="" src=""></image> <video class="video" :src="src" autoplay controls @start="onstart" @pause="onpause" @finish="onfinish" @fail="onfail"></video> </div> </template>
Weex 工程中经常使用的标签有<div />
,<text />
,<image />
,<video />
(组件另算),由此四种标签基本能够知足绝大多数场景的需求,虽然说此标签同 web 工程下的标签用法一致,但此处的标签已再也不是咱们前端口中常提的 html 标签,并且名不副实的 Weex 标签,确切讲是 Weex 组件。
经过weex-loader、vue-loader、weex-vue-render的解析最终转换输出的即是实际的组件,有此设计只是为了完成「web开发体验」的目标。可是咱们身为上层的开发人员要清楚本身天天「把玩」的究竟是个什么「鬼」。
其实用阉割版来形容 Weex 的 css 支持度并不合适,但若是从「web开发体验」的角度来衡量,那么这个形容词也是能够理解的。(此处对 Weex 寄有厚望^_^)
Weex 中的全部 css 属性值的单位均为 px
,也可省略不写,系统会默认为 px
单位。
Weex 中只支持单个类名选择器,不支持关系选择器,也不支持属性选择器。
/* 支持单个类名选择器 */ .one-class { font-size: 36px; } /* 不支持关系选择器 */ .parent > .child { padding-top: 10px; } /* 不支持属性选择器,不支持 `v-cloak` 指令 */ [v-cloak] { color: #FF6600; }
这个只是对样式定义的限制,不影响样式类名的使用,在标签中能够添加多个样式类名,如:
<template> <div class="one two three"><div> </template>
weex支持css基本的盒模型结构,但须要注意的是
box-sizing
属性值默认为 border-box
margin
,padding
,border
等属性暂不支持合并简写Weex 中对 flexbox 布局支持度很高,但依然有部分属性并不支持,如 align-items:baseline;
、align-content:space-around;
、align-self:wrap_reverse;
等。
具体 Weex 对 flexbox 的支持和布局算法,可经过此文进行了解由 FlexBox 算法强力驱动的 Weex 布局引擎,此处便再也不赘述。
在 Weex 的 ios 和 android 端,并不支持 display
属性。
所以,不能使用 display:none;
来控制元素的显隐性,因此 vue 语法中的 v-show
条件渲染是不生效的。
咱们可使用 v-if
代替,或者用 opacity:0;
来模拟。
须要注意的是,ios和android端并不能使用 opacity:0;
来彻底模拟 visibility: hidden;
,由于,当
opacity 的只小于等于 0.01 时,native 控件便会消失,占位空间还在,但用户没法进行交互操做,点击时会发生点透效果。
Weex 支持 css3 属性,虽然支持并不够,但相较 React Native 的「不能用」已是强大不少了。
如下几种属性咱们在开发前须要知道她的支持度
animation
实现动画交互因为使用了加强版的 webpak 打包工具 weexpack,支持第三方框架也是件天然而然的事情。
经常使用的有 vuex
、vue-router
等,可根据项目实际状况引入须要的第三方工具库
npm 包管理是前端开发朋友们再熟悉不过的包管理方式了。这也是为何 React Native 和 Weex 都选择这种管理方式的缘由。
如下是本工程的 package.json 文件,这里就不作讲解了,不熟悉的朋友点这里->NPM 使用介绍
{ "name": "yanxuan-weex", "version": "1.0.0", "description": "a weex project", "main": "index.js", "scripts": { "build": "webpack", "build_plugin": "webpack --config ./tools/webpack.config.plugin.js --color", "dev": "weex-builder src dist -w", "serve": "webpack-dev-server --config webpack.dev.js -p --open" }, "keywords": ["weex"], "author": "zwwill", "license": "MIT", "dependencies": { "vue": "^2.4.2", "vue-router": "^2.7.0", "vuex": "^2.1.1", "vuex-router-sync": "^4.3.0", "weex-html5": "^0.4.1", "weex-vue-render": "^0.11.2" }, "devDependencies": { "babel-core": "^6.21.0", "babel-loader": "^6.2.4", "babel-plugin-add-module-exports": "^0.2.1", "babel-plugin-transform-runtime": "^6.9.0", "babel-preset-es2015": "^6.9.0", "babel-runtime": "^6.9.2", "css-loader": "^0.26.1", "history": "^4.7.2", "quick-local-ip": "^1.0.7", "vue-loader": "^13.0.4", "vue-template-compiler": "^2.4.2", "webpack": "^2.7.0", "webpack-dev-server": "^2.4.2", "weex-builder": "^0.2.7", "weex-loader": "^0.4.5", "weex-router": "0.0.1" } }
Weex 容器默认的显示宽度 (viewport) 是 750px,页面中的全部组件都会以 750px 做为满屏宽度。
这很像移动设备的逻辑像,好比 iPhone 6 的物理像素宽为 750,逻辑像素
Type | iPhone 3G | iPhone 4 | iPhone 6 | iPhone 6Plus | |
---|---|---|---|---|---|
物理像素 | 320x480 | 640x960 | 750x1134 | 1080x1920 | |
逻辑像素 | 320x480 | 320x480 | 375x667 | 414x736 | |
像素比 | @1x | @2x | @2x | @3x |
类比在 Weex 中,若是全部的显示宽度都是用默认值 750,那么显示出来的实际像素信息为
Type | iPhone 3G | iPhone 4 | iPhone 6 | iPhone 6Plus | |
---|---|---|---|---|---|
物理像素 | 320x480 | 640x960 | 750x1134 | 1080x1920 | |
显示像素 | 750x1125 | 750x1125 | 750x1134 | 750x1333 | |
像素比 | @0.427x | @0.85x | @1x | @1.44x |
因此咱们在使用 Weex 作 UI 适配时就没有所谓的 @2x 图和 @3x 图,全部的尺寸都是Weex帮咱们根据
750 做为基数宽作的缩放。
固然,Weex 提供了改变此显示宽度的 API,setViewport
,经过此方法能够改变页面的显示宽度,能够实现每一个页面根据本身的需求改变基数逻辑尺寸
所以对于一些固定的 icon,不建议使用普通的静态图片或者雪碧图,这里建议使用矢量的字体图片,有如下优势:
Weex 的调试方式有多种,若是说RN的调试模式是解放了原生开发的调试,那么 Weex 的调试方式能够说是赋予了 web 模式调试原生应用的能力。
此方法多用于解决 bug,检测控件的布局问题
# 调试单个页面 $ weex debug your_weex.vue # 调试整个工程 $weex debug your/path -e App.vue
执行调试命令后,会将指定的文件打包成 JSBundle,并启动一个 weex Devtool 服务(http://localhost:8088可访问,以下图),同时将 JSBundle 文件传递至该服务跟路径下的weex文件夹内(http://localhost:8088/weex/App.js,实际是下图右边二维码的的内容)。
使用 Weex Playground App 扫下左二维码进入调试模,见下图
再次扫码右方二维码,点击【inspector】便可进入调试模式。
每个控件都是相同的数据结构
<view class="WXText" frame="{{0,0},{414,736}}" hidden="NO" alpha="1" opaque="YES"></view>
此方法多用于开发调试,试试观察结果
$ weex your_weex.vue
若是出现 access 权限报错,使用管理员指令
$ sudo weex your_weex.vue
此时本地同时启动一个watch的服务器用于检查代码变动,自动从新构建 JSBundle,视觉同步刷新。
上图看到的效果即为H5页面的效果,咱们通常在整个单页编写完成后在使用 Weex Playground App 扫码查看真机效果,或者你也能够在编写的同时使用真机观察代码的运行效果,每次从新构建包到重绘的速度仍是很快的。
但前提是你要保证,你的手机和电脑的连在同一个局域网下,而且使用IP访问。
虽说,Weex 能够抹平三端开发的差别,可是知其然也应知其因此然使用起来才能游刃有余。
熟悉 React Native 的人都知道, React Native 的发布实际上就是发布一个 JSBundle,Weex 也是这样,但不一样的是,Weex 将工程进行分包,发布多个 JSBundle。由于 Weex 是单页独立开发的,每一个页面都将经过 Weex 打包器将 vue/we 页面打包成一个单独的 JSBundle,这样的好处在于减小单个 bundle 包的大小,使其变的足够小巧轻量,提升增量更新的效率。
# 仅打包 $ npm run build # 打包+构建 $ weex build ios # 打包+构建+安装执行 $ weex run ios
以上三种均会触发 Weex 对工程进行打包。
在咱们执行了以上打包命令后,全部的工程文件将被单独打成一个独立的 JSBundle,以下:
打包后的 JSBundle 有两种格式
# 由.vue文件打包出来的包格式(简写),使用 vue 2.0 语法编写 // { "framework": "Vue"} /******/ (function(modules) { ....... /******/ })
# 由.we文件打包出来的包格式(简写),使用 weex 语法编写 // { "framework": "Weex" } /******/ (function(modules) { ....... /******/ })
不一样的头部是要告诉使用什么语法解析此JSBundle。
至此,咱们准备「热更新的包」就已经准备完毕了,接下就是发包执行了。
打包后的 JSBundle 通常发布到发包服务器上,客户端从服务器更新包后便可在下次启动执行新的版本,而无需从新下载 app,由于运行依赖的 WeexSDK 已经存在于客户端了,除非新包依赖于新的 SDK,这也是热更新的基本原理。
【WeexSDK】包括
- 【JS Framework】JSBundle 的执行环境
- 【JS-Native Bridge】中间件或者叫通信桥梁,也叫【Weex Runtime】
- 【Native Render Engine】解析 js 端发出的指令作原生控件布局渲染
Weex 的 iOS 和 Android 客户端的【JSFramework】中都会运行一个 JavaScript 引擎,来执行 JS bundle,同时向各端的渲染层发送规范化的指令,调度客户端的渲染和其它各类能力。iOS 下选择了 JavaScriptCore 内核,而在 Android 下选择了 UC 提供的 v8 内核(RN两端都是JavaScriptCore 内核)。
JSBundle 被 push 到客户端后就会在 JSFramework 中执行,最终输出三端可读性的 VNode 节点,数据结构简化以下:
{ tag: 'div', data: { staticStyle: { justifyContent: 'center' } }, children: [{ tag: 'text', data: { staticClass: 'txt' }, context: { $options: { style: { freestyle: { textAlign: 'center', fontSize: 200 } } } }, children: [{ tag: '', text: '文字' }] }] }
有了统一的 VNode 节点,各端便可根据本身的方法解析渲染原生UI了,以前的全部操做都是一致的,包括文件格式、打包编译过程、模板指令、组件的生命周期、数据绑定等。
然而因为目标执行环境不一样(浏览器和 Weex 容器),在渲染真实原生 UI 的时候调用的接口也不一样。
此过程发生在【Weex SDK】的【Weex Runtime】中。
最总【Weex Runtime】发起渲染指令callNative({...})
有RenderEngine完成渲染
官方配图:
扩充配图:
目前支持单页使用或整个 App 使用 Weex 开发(还不完善,须要开发 Router 和生命周期管理)。
本文先行的严选 demo 即是使用第二种全屏模式,使用 Weex 开发整个 App,期间触碰到 Weex 的在此模式下诸多不足,如 StatusBar 控制、Tab 切换、开场动画自定义、3DTouch、 Widget 等等原生的特点功能没有现成的 API,须要咱们本身扩展,甚至扩展不了。所以并不能彻底“灭掉”原生。
因此,目前在阿里内部使用较多的是此模式中的单页模式,这也是为何官方文档在介绍原理后就直接奔入集成到原生应用的主题上去了。
把 Weex 看成一个 iOS/Android 组件来使用,类比 ImageView。这类需求遍及手淘主链路,如首页、主搜结果、交易组件化等,这类 Native 页面主体已经很稳定,可是局部动态化需求旺盛致使频繁发版,解决这类问题也是 Weex 的重点。
在 H5 种使用 Weex,类比 WVC。一些较复杂或特殊的 H5 页面短时间内没法彻底转为 Weex 全页模式(或RN),好比互动类页面、一些复杂频道页等。这个痛点的解决办法是:在现有的H5页面上作微调,引入Native 解决长列表内存暴增、滚动不流畅、动画/手势体验差等问题。
另外,WVC 将会融入到 Weex 中,成为 Weex 的 H5 Components 模式。
因为 Weex 没有封装 Tab 的组件,所以笔者使用了不少方法来实现Tab切换的功能。
一、vue-router:router 思想方便管理,可是每次切换都是新的实例,没有tab模式
二、opacity、visablity:此处须要注意,Weex的渲染机制和web是有区别的,对夫层设置 opacity 或者visiablity隐藏是没法同时隐藏定位为position:fixed;
的子元素。
三、position、transform:改变 tab 层的位置,此方法在定位为 position:fixed;
的子元素上依然无效。
Weex 中全部的静态资源基本都是网络资源,包括图片、字体图片等,因此使用 iconfont 图标是再合适不过的了。
此 demo 中全部的 icon 均使用 的iconfont。
此处强烈推荐一个站点 www.iconfont.cn。
在此平台你能够找到几乎全部你须要的 icon,你也能够上传本身的 icon 到本身建立的项目中。同时该系统还提供生成ttf、woff 资源,而且作了 cdn 加速和 gzip 压缩,是否是跟 Weex很配呢?
不过也有风险,就是,若是哪天阿里不在维护并回收该平台的资源了,你的 app 可能就会变成这样,全是方框,或者 padding 掉你 H5 的页面
固然,这种及状况出现的概率很小,若是你是一个大公司,你手上有更好的资源急速方案,那就本身保存吧。
UIWebView是咱们开发App经常使用的一个控件,不过Weex帮咱们封装好的API明显时不够用的,目前只有pagestart
、pagefinish
、error
,并无封装像RN那样的onShouldStartLoadWithRequest
拦截地址请求的API,在我看来,这有些不合理,并不清楚轮子的制造者是什么意图。
性能是一个大课题,在此就不作展开了,只稍微说起一些咱们开发须要注意的几点
脚本语言天生自带“热更新”,Weex 针对 React Native 的热更新策略作了优化,将 WeexSDK 事先绑到了客户端上,而且对 JSBundle 进行分包增量更新,大大提升了热更新的效率。
但优势也是缺点,若是新包依赖于心的 SDK,此状况下,咱们须要发布还有新 SDK 的 app 到应用市场,用户也须从市场更新此 app。不够随着 WeexSDK 版本的稳定后,相信此策略的优点就会凸显出来。
Weex 是一种轻量级、可扩展、高性能框架。集成也很方便,能够直接在 HTML5 页面嵌入,也可嵌在原生UI中。因为和 React Native 同样,都会调用 Native 端的原生控件,因此在性能上比 Hybrid 高出一个层次。
虽然说这是一个大胆的实践,但对于大前端社区的统一有着推进做用,显然阿里在这一方面已经迈出了第一步。基本解决了三端同等需求致使资源浪费的痛点。
但后期可能会出现这种现象,开发一个三端的 App 会从原来的我的变成四我的,多出来的那一我的负责开发 Weex 单页。
意思就是,三端统一的不够完全,但就目前的环境下,这一句是最优方案了,倒是提升了开发效率。大前端未来将如何一统三国咱们且行且观望吧。
对于一些交互视觉统一且没有很大的性能需求的游戏,Weex 仍是能够胜任的。
近期笔者将尝试发布一款纯Weex构建的益智小游戏,敬请期待。
朋友们能够用这个demo体验下 Weex 版扫雷游戏开发
虽说大一统事件百利的事,但并不是无一害。
对于一些有差别化完美体验追求的项目就只能收敛或者放弃了。
对于三端同时上线,一端存在 bug 的状况,Weex 并不能保证作到牵一发而不动全身。
好比安卓的波纹按钮、3DTouch、 Widget、iWatch版本等,目前这些功能仍是没有的,不知道之后 Weex
是否将其加入到官方文档中。
以上均为我的看法,不表明官方。若有不当之处还望指正。
[ 1 ] Weex官方文档 - http://weex.apache.org/cn/references/
[ 2 ] 场景研读 - Native 性能稳定性极致优化 - https://yq.aliyun.com/articles/69005
[ 3 ] 门柳 - 详解 Weex JS Framework 的编译过程 - https://yq.aliyun.com/articles/59935?spm=5176.8067842.tagmain.66.1QA1fL
[ 4 ] 阿里百川 - 深度揭秘阿里移动端高性能动态化方案Weex - https://segmentfault.com/a/1190000005031818
[ 5 ] 一缕殇流化隐半边冰霜 - Weex 是如何在 iOS 客户端上跑起来的 - http://www.jianshu.com/p/41cde2c62b81
转载请标明出处
做者: 木羽 zwwill
首发地址: https://github.com/zwwill/blo...