号外&＃xff1a;推荐使用HBuilderX插件https://ext.dcloud.net.cn/plugin?id&＃61;2656&＃xff0c;直接转换小程序到uni-app
本文首先分享转换步骤和原理&＃xff0c;文末会分享三方开发者制作的 小程序转uni-app的转换器 和 wepy转uni-app转换器 。
小程序转换uni-app的步骤
微信小程序的语法&＃xff0c;其实是vue.js语法的裁剪定制版&＃xff0c;在数据绑定、自定义组件等很多方面都有相似之处。
以下是一个小程序源码转换步骤指南&＃xff1a;
客户端代码转换
新建一个uni-app项目&＃xff0c;把之前的app.js、app.wxss的代码&＃xff0c;挪到app.vue里&＃xff0c;分别放到script和style节点下面
如果其中有globalData等全局变量或方法&＃xff0c;也直接放到app.vue的script下
export default {
globalData: {
text: &＃39;text&＃39;
},
onLaunch: function() {
console.log(&＃39;App Launch&＃39;)
}
}
读取globalData或赋值的方法是getApp().globalData.text &＃61; &＃39;test&＃39;
转换app.json为pages.json&＃xff0c;把每个小程序page目录下的index.json(或页面名称对应的json)里的配置取出来&＃xff0c;放到pages.json的style下
pages下每个页面目录放一个vue空文件模板
把之前页面的wxss内容复制到vue文件的style中&＃xff0c;无需改动
把之前页面的js内容复制到vue文件的script中&＃xff0c;然后执行如下改动
5.1 之前js里面的data&＃xff0c;放到新的data return下
之前
Page({
data: {
show1: false
}
})
现在
export default {
data() {
return {
show1: false
}
}
}
5.2 之前js里面的自定义方法&＃xff0c;放到新的method下
之前
Page({
toggleActionSheet1() {
this.setData({show1: true});
}
})
现在
export default {
methods: {
toggleActionSheet1() {
this.show1 &＃61; true
}
}
}
5.3 之前js里面的生命周期函数onLoad、onShow等&＃xff0c;直接放到export default下
之前
Page({
onLoad() {
console.log("page load");
}
})
现在
export default {
onLoad() {
console.log("page load");
}
}
5.4 setdata的处理方式
方式一&＃xff1a;从 this.setData({loading: false,areaList: response.data.data}) 改为 this.loading &＃61; false;this.areaList &＃61; response.data.data。
方式二&＃xff1a;重写setdata方法&＃xff0c;如下
setData:function(obj){
let that &＃61; this;
let keys &＃61; [];
let val,data;
Object.keys(obj).forEach(function(key){
keys &＃61; key.split(&＃39;.&＃39;);
val &＃61; obj[key];
data &＃61; that.$data;
keys.forEach(function(key2,index){
if(index&＃43;1 &＃61;&＃61; keys.length){
that.$set(data,key2,val);
}else{
if(!data[key2]){
that.$set(data,key2,{});
}
}
data &＃61; data[key2];
})
});
}
以上代码出处&＃xff1a;https://ask.dcloud.net.cn/article/35020
把之前页面的wxml内容复制到vue文件的template下的view下&＃xff0c;然后执行如下改动
属性绑定从
attr&＃61;”{{ a }}”&＃xff0c;改为 :attr&＃61;”a”
title&＃61;”复选框{{ item }}” 改为 :title&＃61;”‘复选框’ &＃43; item”
事件绑定从 bind:click&＃61;”toggleActionSheet1″ 改为 &＃64;click&＃61;”toggleActionSheet1″
阻止事件冒泡 从 catch:tap&＃61;”xx” 改为 &＃64;tap.native.stop&＃61;”xx”
wx:if 改为 v-if
wx:for&＃61;”{{ list }}” wx:key&＃61;”{{ index }}” 改为&＃96;v-for&＃61;”(item,index) in list”
微信小程序自定义组件处理
之前引入的自定义组件&＃xff0c;需要放到wxcomponents下&＃xff0c;并在pages.json里注册。如果这里有js&＃xff0c;并且被其他代码引入&＃xff0c;要注意修改引用代码的路径指向。如下&＃xff1a;
{
"pages": [ //pages数组中第一项表示应用启动页&＃xff0c;参考&＃xff1a;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"
}
}
}
微信自定义组件虽然可以这样转换。但转换后只能用于微信和App。如果想用于支付宝百度头条&＃xff0c;则需要新建swancomponents等目录&＃xff0c;将微信自定义组件复制到这些目录&＃xff0c;改造测试。虽然各小程序平台均支持自定义组件&＃xff0c;但细节有差异&＃xff0c;仍需自己测试。无论如何&＃xff0c;H5端不支持这些自定义组件。
比较妥善的跨端做法&＃xff0c;是在uni-app插件市场寻找类似功能的vue组件&＃xff0c;废弃之前的小程序自定义组件。比如把wx-charts换成ucharts、把wx-parser换成uparser。
辅助工具
贡献几个替换用的正则
str &＃61; str.replace(/bindtap/g, &＃39;&＃64;onclick&＃39;);
str &＃61; str.replace(/wx:if/g, &＃39;v-show&＃39;);
str &＃61; str.replace(/src&＃61;\&＃39;\{\{/g, ":src&＃61;&＃39;");
str &＃61; str.replace(/wx\:key&＃61;\"\*this\"/g, &＃39; &＃39;);
str &＃61; str.replace(/wx\:key\&＃61;\"index\"/g, &＃39; &＃39;);
str &＃61; str.replace(/wx:for&＃61;"{{/g, v-for&＃61; "(item,index) in &＃39;);
str &＃61; str.replace(/bindinput/g, &＃39;&＃64;input&＃39;);
wx.是否要替换为uni.&＃xff1f;
关于js api中的wx.&＃xff0c;不要全局替换为uni.。因为有的wx的api是微信独有的&＃xff0c;替换为uni后&＃xff0c;反而在微信下没法用了。
同时uni-app编译器提供了把wx.编译为不同平台的机制&＃xff0c;所以直接使用wx.的api完全可以正常在各端运行。
所以对于老代码&＃xff0c;替不替换不重要&＃xff0c;不影响运行&＃xff0c;只影响语法提示和转到定义。
但是新写的代码&＃xff0c;还是要用uni.的api&＃xff0c;在代码提示、转到定义方面更强大。
App端迁移&＃xff0c;还需处理服务端相关代码
如果把微信小程序转换为uni-app&＃xff0c;仍然用于发布微信小程序&＃xff0c;那服务器端代码不变。
但如果要发布到App、其他小程序等平台&＃xff0c;服务器也需要调整部分代码。比如登陆、支付、推送、定位、地图等联网服务。
uni-app在客户端侧提供了统一的代码&＃xff0c;比如uni.login、uni.requestPayment&＃xff0c;在不同端均可以实现登陆、支付。
但服务器端的接口不一样&＃xff0c;比如微信的App支付和小程序支付的申请开通、服务器接口都不一样&＃xff0c;所以配置和服务器接口仍需单独处理。
比如把小程序转换uni-app后&＃xff0c;需要打包发布为app&＃xff0c;则需要向微信申请app支付的资质&＃xff0c;拿到appkey等信息&＃xff0c;填写到uni-app工程的 manifest-app -> sdk配置 -> 微信支付 下面&＃xff0c;然后打包才能成效(如果是离线打包&＃xff0c;参考离线打包的文件)。同时服务器需要按照微信的App支付的接口再开发对接。
同样微信小程序里内置的定位、地图&＃xff0c;在app上&＃xff0c;需要单独向高德等三方服务商申请&＃xff0c;否则无法在app里使用这些服务。
这些sdk申请方式在 manifest -> app sdk配置 下有教程链接。
其他注意
参考&＃xff1a;这里有一个转换示例&＃xff0c;把vant weapp的小程序演示demo&＃xff0c;转换为uni-app工程&＃xff0c;里面的pages下同时保留了wxml和vue&＃xff0c;可用于对比参考。http://ext.dcloud.net.cn/plugin?id&＃61;302
如果是mpvue的小程序&＃xff0c;转换uni-app很方面&＃xff0c;参考文档&＃xff1a;https://ask.dcloud.net.cn/article/34945
感谢zhangdaren开源了小程序到uni-app的转换器
普通wxml小程序转uni-app&＃xff1a;https://github.com/zhangdaren/miniprogram-to-uniapp
对应的教程&＃xff1a;https://ask.dcloud.net.cn/article/36037
这个转换工具的案例&＃xff1a;https://ext.dcloud.net.cn/plugin?id&＃61;666
wepy转uni-app转换器&＃xff1a;https://github.com/zhangdaren/wepy-to-uniapp
回答
京公网安备 11010802041100号