miniprogram-to-uniapp使⽤指南(⼩程序项⽬转换为uni-
app项⽬)
⼀、它是谁?
【miniprogram-to-uniapp】 ,有点后悔取这么长的名字,打得来⿇烦,最新版本为【 v1.0.19 】。
⼆、它能做什么?
⽬前能转换“⼩程序” 和“⼩程序带云函数”项⽬ ==> uni-app项⽬。
三、它的原理是什么?(过段时间会有⼀篇关于此⼯具的⽂章,敬请期待)
最初是学了半节课堆和栈,觉得词法分析挺有意思的,再加上转换⼩程序插件时,发现这些繁琐的操作完全可以使⽤程序来完成。
核⼼是使⽤Babel获取AST(词法分析),然后或使⽤Babel⾃带函数增删,或正则分析替换等等操作。
可能有的朋友觉得,这种为啥不是纯正则分析? 纯正则可以解决⼀部分问题,对于标签与标签内容,其实正则是很难进⾏区分的哈。
四、它做了什么?
1. 解析并合并 [xx.js, xx.wxml, xx.wxss] 为 xx.vue ⽂件,并对⼩程序模板语法进⾏转换,调整⽣命周期函数,this.setData()转换等;
2. 将所有素材资源移⼊到static⽬录,并修复路径
3. 转换<template/>标签和语法import *.wxml的转换
4. ⽀持workers⽬录转换
5. ⽀持wxs⽂件转换
6. 解析⼩程序的json配置⽂件,并组装好uni-app需要的配置⽂件,⽣成项⽬。
五、怎么使⽤?
第⼀步:在命令⾏⾥,运⾏【 npm install miniprogram-to-uniapp -g 】进⾏安装,因为这个包是⼯具,要求全局都能使⽤,所以需要-g 进⾏全局安装。
第⼆步:继续在命令⾏⾥,运⾏【 wtu -V 】,执⾏结果如下:
显⽰1.01,说明已经安装成功了。(wtu -> 取⾃wx to uni之意,后⾯都⽤这个全局命令)
第三步:在命令⾏⾥,输⼊【wtu -i "你的⼩程序项⽬路径"】,注意参数-i后⾯有⼀个空格如:【wtu -i
"E:\zpWork\Project_self\miniprogram-to-uniapp\test\test-wx-to-uni"】 ,回车后即可以在源项⽬同及⽬录得到⼀个后缀为_uni的⽬录,即转换成功。见下图:
转换前:
代码转换转换后:
转换后的项⽬⽂件对⽐(左边是⼩程序项⽬,右边是Uni-app项⽬⽬录):
⼯具升级
因为⼯具更新⽐较频繁,安装后,可以使⽤如下命令进⾏升级:
npm update miniprogram-to-uniapp -g
注意:
1. 已知问题已经附于README⾥,请详细阅读。
2. github上⾯的只是源代码。 ⽇常使⽤,需要运⾏【 npm install miniprogram-to-uniapp -g 】进⾏安装才⾏。
3. 每次转换时都会将输出⽬录清空,请注意代码保存。
4. ⽬前转换后的项⽬并不完美,⽬前成功的是⼩程序的默认新建项⽬和云函数项⽬。
5. 后续会有版本更新,请及时关注并更新~~
如有遇到bug或问题,欢迎评论、给出改进建议,感谢~~
版权声明:本站内容均来自互联网,仅供演示用,请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198,我们将在24小时内删除。
发表评论