最近研究小程序、以及小程序转H5代码方案等,记录下发现的比较好的经验,转载以供参考:
这是一篇使用开源小工具miniprogram-to-uniapp 的使用心得记录,因为工作需要,自己尝试过手动搬页面,但觉得重复性搬运实在繁琐,而且耗费时间,所以在网上找了找有没有现成的工具,终于看见这么个小工具,感谢开源的作者。
转换工具文档:miniprogram-to-uniapp使用指南
源码粗略分析
主要命令: 【wtu -i “你的小程序项目路径” -o “输出目录,可不填”】
wtu这个命令是作者通过node的commander来实现了自己的全局命令,输入命令后执行了transform这个函数。
核心代码如下:
async function transform(sourceFolder, targetFolder) { fileData = {}; routerData = {}; imagesFolderArr = []; let miniprogramRoot = sourceFolder; if (!targetFolder) targetFolder = sourceFolder + "_uni"; //读取小程序项目配置 const configData = wxProjectParse(miniprogramRoot, sourceFolder); //小程序项目目录,不一定就等于输入目录,有无云开发的目录结构是不相同的。 miniprogramRoot = configData.miniprogramRoot; //定义全局变量,之前传来传去的,过于麻烦 global.miniprogramRoot = miniprogramRoot; global.sourceFolder = sourceFolder; global.targetFolder = targetFolder; global.globalUsingComponents = {}; //后面添加的全局组件 global.props = {}; //存储wxml组件页面里面,需要对外开放的参数(本想不做全局的,然而传参出现问题,还是全局一把梭) global.wxsInfo = {}; //存储页面里的wxs信息,数据格式如上所示 if (fs.existsSync(targetFolder)) { //清空output目录 fs.emptyDirSync(targetFolder); } else { //不存在就创建 fs.mkdirSync(targetFolder); } traverseFolder(miniprogramRoot, miniprogramRoot, targetFolder, () => { //处理文件组 filesHandle(fileData, miniprogramRoot).then(() => { //处理配置文件 configHandle(configData, routerData, miniprogramRoot, targetFolder); //输出提示 setTimeout(()=>{ log('注意:当看到"image漏网之鱼",意味着您需要手动调整对应代码,表示image标签的src属性是含变量或表达式,工具还无法做到100%转换,需要手动修改为相对/static目录的路径\r\n'+ '另外,代码<template is="abc" data=""/>里data参数仅支持键值对{key:value}的形式,望知悉!') }, 700); }); }); }
这个函数主要的作用如下:
- 读取需要转换的文件路径,如果没有指定输出目录,就在同级目录下新建一个以_uni为后缀的文件夹
- 读取小程序项目配置,也就是project.config.json,package.json
- 遍历目录:(遇到文件夹则继续向下遍历)
- images或者image文件夹复制到static目录里,(workers目录也复制到static目录中,不过不是很清楚workers目录是用来干什么的)
- 处理js,wxml,wxss,json这四种文件,并暂存到fileData对象中,这个对象包括js,wxml,wxss,folder,json,fileName,isAppFile作为key值,
- 如果是.wxs文件,需要先使用js解析器JavascriptParser转换一下,
- 如果是属于图片类的文件,判断当前文件的上层目录,如果存在同级文件属于js,wxml,wxss中的一种,就直接复制到static目录里;否则连同上一级目录复制到static目录里(这种情况处理的是比如取名为img文件夹,会被整个copy到static目录下资源整合)
- 其他情况下直接copy整个文件,例如README文件,会直接复制到根目录下
- 处理文件组,即上面traverseFolder函数返回的fileData对象,(js、wxml、wxss),使用该对象中的fileName组装vue文件名
- isAppFile判断是否是app.js,单独命名为App.vue,
- 解析json,判断有没有引用自定义组件
- 配置routerData对象,存储这个page的路由样式等信息,(注意,小程序每个page文件里的配置在uni-app里面都配置到了pages.json里,这样跳转小程序还是会报错,我之前使用uni-app时把”navigateToMiniProgramAppIdList”配置写在app.json里同样不生效,开发过程中需要在manifest.json文件对应的mp-weixin下配置)
- wxml文件处理,以及wxml里面的wxs信息需要提取并转换,涉及到词法分析(这个还没有进一步学习过,具体以后有时间可以研究研究)
- js文件处理,
- wxss文件处理,图片路径区分(本地资源、网络资源)
- 写入文件,上面步骤返回的最后都是字符串
- 处理配置文件,app.json(还需要检测里面有没有全局组件)
- 将pages节点里的数据,提取routerData对应的标题,写入到pages节点里
- 加上tabBar节点
- 写入pages.json
- 写入template/manifest.json,(这是uni-app特有的配置),通过之前存储的configData写入manifest.json模版中(工具中先定义好模版)
- 全局引入自定义组件
- 写入main.js
到这个地方,这个开源小工具也就完成了它的功能,但转换后还有不少bug是需要自己手动调试发现的。
需要手动调试部分(自己测验到的问题)
配置eslint文件并修复报错信息,使用HBuilderX运行,根据报错信息修正
- wx:for转v-for遗留的问题,wx:for=”{{ list }}”改为`v-for=”(item,index) in list”
- 文件路径问题(组件、资源文件),全局替换
- 动态class问题
- 小程序的方法和vue中的methods
- 事件绑定的方式
- 小程序使用setData设置数据,跟vue中的数据单向流不一样,需要注意一下,这个工具对setData进行了重写,所以使用setData不会报错,但在onLoad中使用会提示错误
- globalData,这个工具里已经转化过了,只是额外提一下这个坑,在uni-app的app.vue文件中不可以直接使用this.globalData,会报错找不到,而应该使用this.$options.globalData
- image、input标签需要手动转换成<img />和<input />
- 自定义组件使用的时候如果是驼峰式命名,由于js里面的驼峰式被转成了小写(不知道是不是bug或者遗漏的地方),所以在使用该组件时会看不到内容,把名称替换一下就好了
- 小程序中有部分bind:绑定的方法,需要手动换成@
- 例如bindinput,bindblur等事件,需要手动改为@的形式
- 有关
wx.
的API,哪些需要替换成uni.
还需要仔细核查一遍,因为有的wx的api是微信独有的,替换为uni后,反而在微信下没法用了。如果后续要转为h5,需要自己调研是否须平台编译 - 登陆、支付、推送、定位、地图等相关功能,需要视平台而定,可能需要单独处理
- 原有的编译模式condition被放到了project.config.json文件中,运行不生效,需要放到pages.json文件中
- “navigateToMiniProgramAppIdList”配置写在app.json里不生效,开发过程中需要在manifest.json文件对应的mp-weixin下配置,这里属于微信小程序特有配置
顺便推荐一篇小程序转uni-app的指南:
微信小程序转换uni-app详细指南、小程序转uni-app转换器、wepy转uni-app
作者:ArmorVon
链接:https://www.jianshu.com/p/118973d1ca0c
著作权归作者所有。商业转载请联系作者获得授权,非商业转载请注明出处。
转载请注明:拈花古佛 » 微信小程序转uni-app过程记录