小程序转换uni-app的步骤
微信小程序的语法,其实是vue.js语法的裁剪定制版,在数据绑定、自定义组件等很多方面都有相似之处。
以下是一个小程序源码转换步骤指南:
客户端代码转换
新建一个uni-app项目,把之前的app.js、app.wxss的代码,挪到app.vue里,分别放到script和style节点下面
转换app.json为pages.json,把每个小程序page目录下的index.json(或页面名称对应的json)里的配置取出来,放到pages.json的style下
pages下每个页面目录放一个vue空文件模板
把之前页面的wxss内容复制到vue文件的style中,无需改动
把之前页面的js内容复制到vue文件的script中,然后执行如下改动
5.1 之前js里面的data,放到新的data return
下
之前
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
|
Page({
data: {
show1: false
}
})
|
现在
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
|
<script>
export default {
data() {
return {
show1: false
}
}
}
</script>
|
- 5.2 之前js里面的自定义方法,放到新的method下
之前
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
|
Page({
toggleActionSheet1() {
this.setData({show1: true});
}
})
|
现在
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
|
<script>
export default {
methods: {
toggleActionSheet1() {
this.show1 = true
}
}
}
</script>
|
- 5.3 之前js里面的生命周期函数onLoad、onShow等,直接放到export default下
之前
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
|
Page({
onLoad() {
console.log("page load");
}
})
|
现在
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
|
<script>
export default {
onLoad() {
console.log("page load");
}
}
</script>
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
|
setData:function(obj){
let that = this;
let keys = [];
let val,data;
Object.keys(obj).forEach(function(key){
keys = key.split('.');
val = obj[key];
data = that.$data;
keys.forEach(function(key2,index){
if(index+1 == keys.length){
that.$set(data,key2,val);
}else{
if(!data[key2]){
that.$set(data,key2,{});
}
}
data = data[key2];
})
});
}
|
以上代码出处:https://ask.dcloud.net.cn/article/35020
把之前页面的wxml内容复制到vue文件的template下的view下,然后执行如下改动
属性绑定从
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
|
attr="{{ a }}",改为 :attr="a"
title="复选框{{ item }}" 改为 :title="'复选框' + item"
事件绑定从 bind:click="toggleActionSheet1" 改为 @click="toggleActionSheet1"
阻止事件冒泡 从 catch:tap="xx" 改为 @tap.native.stop="xx"
wx:if 改为 v-if
wx:for="{{ list }}" wx:key="{{ index }}" 改为`v-for="(item,index) in list"
|
微信小程序自定义组件处理
之前引入的自定义组件,需要放到wxcomponents下,并在pages.json里注册。如果这里有js,并且被其他代码引入,要注意修改引用代码的路径指向。如下:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
|
{
"pages": [ //pages数组中第一项表示应用启动页,参考:https://uniapp.dcloud.io/collocation/pages
{"path": "pages/dashboard/dashboard"},
{
"path": "pages/action-sheet/action-sheet",
"style":{
"navigationBarTitleText":"ActionSheet 上拉菜单",
"usingComponents":{ //这里单页面引入action-sheet组件
"van-action-sheet": "/wxcomponents/vant/action-sheet/index"
}
}
}
],
"globalStyle": {
"navigationBarTitleText": "Vant For Uni-app",
"usingComponents": { //这里给所有页面全局引入了如下组件
"demo-block": "/wxcomponents/vant/demo-block/index",
"van-button": "/wxcomponents/vant/button/index",
"van-cell": "/wxcomponents/vant/cell/index",
"van-cell-group": "/wxcomponents/vant/cell-group/index",
"van-icon": "/wxcomponents/vant/icon/index",
"van-loading": "/wxcomponents/vant/loading/index",
"van-toast": "/wxcomponents/vant/toast/index"
}
}
}
|
辅助工具
贡献几个替换用的正则
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
|
str = str.replace(/bindtap/g, '@onclick');
str = str.replace(/wx:if/g, 'v-show');
str = str.replace(/src=\'\{\{/g, ":src='");
str = str.replace(/wx\:key=\"\*this\"/g, ' ');
str = str.replace(/wx\:key\=\"index\"/g, ' ');
str = str.replace(/wx:for="{{/g, v-for= "(item,index) in ');
str = str.replace(/bindinput/g, '@input');
|
wx.是否要替换为uni.?
关于js api中的wx.,不要全局替换为uni.。因为有的wx的api是微信独有的,替换为uni后,反而在微信下没法用了。
同时uni-app编译器提供了把wx.编译为不同平台的机制,所以直接使用wx.的api完全可以正常在各端运行。
所以对于老代码,替不替换不重要,不影响运行,只影响语法提示和转到定义。
但是新写的代码,还是要用uni.的api,在代码提示、转到定义方面更强大。
服务相关代码转换
登陆、支付、推送、定位、地图等服务都是联网服务,它们不止是客户端代码转换就可以直接运行的。涉及服务器接口和配置两方面的工作。
uni-app在客户端侧提供了统一的代码,比如uni.login、uni.requestPayment,在不同端均可以实现登陆、支付。
但服务器端的接口不一样,比如微信的App支付和小程序支付的申请开通、服务器接口都不一样,所以配置和服务器接口仍需单独处理。
比如把小程序转换uni-app后,需要打包发布为app,则需要向微信申请app支付的资质,拿到appkey等信息,填写到uni-app工程的 manifest-app -> sdk配置 -> 微信支付 下面,然后打包才能成效(如果是离线打包,参考离线打包的文件)。同时服务器需要按照微信的App支付的接口再开发对接。
同样微信小程序里内置的定位、地图,在app上,需要单独向高德等三方服务商申请,否则无法在app里使用这些服务。
这些sdk申请方式在 manifest -> app sdk配置 下有教程链接。
其他注意
参考:这里有一个转换示例,把vant weapp的小程序演示demo,转换为uni-app工程,里面的pages下同时保留了wxml和vue,可用于对比参考。http://ext.dcloud.net.cn/plugin?id=302
HBuilderX 1.8.8版本对小程序自定义组件的兼容性更高,请在社区首页右侧下载HBuilderX alpha版的最新版。
最后,其实写的这么细,已经是一个小程序转uni-app转换器的实现步骤了。欢迎有兴趣的同学开发转换器:)