A Weex and Vue.js project,你可以参考它来完善你的Weex应用架构或者直接使用它。
这个项目为钉钉开发者准备了从构建,调试,到打包一系列的流程以及编写weex应用的最佳实践,我们使用Webpack
来打包源代码,Babel
帮助我们处理ES6的转译。
注意
⚠️ 此刻,我们移除掉了很多不是必须的项目,比如flow静态类型检查,jasmine单元测试等。
关于转场,你可以选择使用vue-router
的方式,也可以使用钉钉的js-api openLink
来跳转页面。如果你使用钉钉的js-api,那么你的应用更像一个传统的Native App转场,比如iOS的NavigationController的push,pop等有animation效果转场。
你可以在 weex-generator-package 访问并下载使用它。
- components 可以共享的组件放在这里
- container 如果你使用了vue-router,那么需要使用这里的共用容器
- lib 可以共享的函数.js文件放在这里
- mock 模拟数据
- pages 真正的页面放在这里
- platforms 平台相关的入口放在这里
# install dependencies
npm install
# 启动 vue web dev 环境,自启服务器 at localhost:8080
npm run dev:web
# build vue web release 环境
npm run build:web
# 启动 weex dev 环境,自启服务器 at localhost:8089
npm run dev:weex
# 启动 weex release 环境
npm run build:weex
# 编译weex和Web环境下所需要的资源,这是可以正式部署的静态资源
npm run build
我们可以先看一个很传统的方式来创建一个新页面,一个页面就是一个bundle.js
,你应该在Webpack
配置中去处理这些bundle.js
。
当你选择创建一个新的页面时,需要经过下列几个步骤:
- 在platforms/weex目录下创建你的入口文件(icepy-entry.js)
import Home from '../../pages/icepy/index.vue';
Home.el = '#app';
new Vue(Home);
- 在pages/目录下创建一个
icepy
目录并且创建一个index.vue文件,你可以写一个很简单的Hello Your Name
<template>
<div>
<text class="hello">Hello Your Name</text>
</div>
</template>
<script>
export default {
name: 'your name'
data: {}
}
</script>
<style>
.hello{
}
</style>
- 在build目录下的webpack.weex.conf.js文件中的entry里填上一个新的入口
// webpack 配置
entry:{
'weex-icepy-bundle': './src/platforms/weex/icepy-entry.js'
}
最后,在你的终端里输入 npm run dev:weex
,感受一下吧。
有时候类似一个UIViewController式的bundle.js
并不是你想要的,很多事情不是很好处理,那么你可以选择vue-router来处理转场,为什么它可以运行weex环境帮你处理转场?因为vue-router本意上是可以运行在任意的JavaScript环境中,你可以设置mode为abstract
,而且weex是需要上层框架的render来进行计算渲染Native页面的,这也意味着当我们的路由进行转换时,vue-router会去处理一个Vue Component,而这个Vue Component 正是你需要渲染的页面。
在pages
目录下创建一个组件(页面),比如dingtalk/index.vue
:
<template>
<div class="wrapper">
<div class="bind-vue-container" @click="bindForvue">
<text class="bind-vue">确定</text>
</div>
</div>
</template>
<script>
import dingtalk from 'weex-dingtalk';
export default {
name: 'bind-vue',
data: function(){
return {};
},
mounted: function(){
//resume
dingtalk.on('resume',function(){
console.log('resume weex generator-package')
});
//pause
dingtalk.on('pause',function(){
console.log('pause weex generator-package');
});
},
methods: {
bindForvue: function(){
this.$router.back();
}
}
}
</script>
<style>
</style>
访问router.js
,参考 https://router.vuejs.org/zh-cn/essentials/getting-started.html 来配置路由。
import VueRouter from 'vue-router';
import Home from '../pages/home/index.vue';
import Dingtalk from '../pages/dingtalk/index.vue';
const routes = [
{
path:'/',
name: 'home',
component: Home
},
{
path: '/dingtalk',
name: 'dingtalk',
component: Dingtalk
}
];
export default function Router(Vue){
Vue.use(VueRouter);
const router = new VueRouter({
routes: routes
});
return {
router
}
}