zhangdaren
zhangdaren
  • 发布:2019-06-20 15:23
  • 更新:2024-03-29 21:03
  • 阅读:79437

miniprogram-to-uniapp使用指南(各种小程序项目转换为uni-app项目)

分类:uni-app

工具现在支持npm全局库、HBuilderX插件两种方式使用,任君选择,HBuilderX插件地址:https://ext.dcloud.net.cn/plugin?id=2656

一、它是谁?

【miniprogram-to-uniapp】转换微信小程序”项目为uni-app项目(新版本工具已经支持各种小程序转换)。

二、它的原理是什么?

最初是学了半节课堆和栈,觉得词法分析挺有意思的,再加上转换小程序插件时,发现这些繁琐的操作完全可以使用程序来完成。
核心是使用Babel获取AST(词法分析),然后或使用Babel自带函数增删,或正则分析替换等等操作。
可能有的朋友觉得,这种为啥不是纯正则分析? 纯正则可以解决一部分问题,对于标签与标签内容,其实正则是很难进行区分的哈。

三、它能做哪些事情?

  • 支持微信、QQ、头条/抖音、支付宝/钉钉和百度等小程序转换到 uni-app 项目
  • 支持有/无云开发的小程序项目转换为 uni-app 项目(cloudfunctions 目录将被忽略,uni-app 结合小程序云开发见:使用 uni-app 进行微信小程序云开发经验分享)
  • 支持解析 TypeScript 小程序项目
  • 支持解析使用 npm 模块的小程序项目
  • 支持解析 include 标签
  • 支持解析 template 标签
  • 支持解析 Behavior 文件为 mixins 文件
  • 支持.js', .wxml 和*.wxss 文件进行相应转换,并做了大量的优化
  • 支持识别 App、Page、Component、VantComponent、Behavior 和纯 Javascript 文件的转换
  • 修复变量名与函数重名的情况
  • 合并使用 require 导入的 wxs 文件
  • setData() polyfill
  • 搜索未在 data 声明,而直接在 setData()里使用的变量,并修复
  • 使用jyf-parser替换 wxParse(感谢网友 “爱瑞巴勒康忙北鼻” 的建议)
  • 因 uni-app 会将所有非 static 目录的资源文件删除,因此将所有资源文件移入 static 目录,并修复所有能修复到的路径(目前 uni 编译时会将非 static 目录的文件复制一份到 static 目录,但并不完全,因此本功能仍保留)

四、它还有哪些不支持转换?

  • 不支持转换反编译后的小程序项目
  • 不支持转换使用 uni-app 编译的小程序项目
  • 不支持转换使用 redux 开发的小程序(代表为:网易云信小程序 DEMO)
  • 不支持转换使用 wxpage 开发的小程序(https://github.com/tvfe/wxpage)
  • 不支持转换使用腾讯 omi 开发的小程序(https://github.com/Tencent/omi)
  • 不支持转换小程序抽象节点 componentGenerics
  • 不支持 component 里的 pageLifetimes 生命周期,请手动绕过
  • 不支持使用 js 系统关键字作为函数或变量名(如 default、import、return、switch 等)
  • 不支持以\$开头的变量名称,如 Page({data:{$data:{name:"hello"}}}) ,刚好\$data 是 vue 内置变量,so 不支持,需手动修复
  • 不支持以动态绑定的函数<input @input="test{{index+1}}">,需手动修复
  • 更多,请参照miniprogram to uniapp 工具答疑

五、怎么使用?

第一步

在命令行里,运行【 npm install miniprogram-to-uniapp -g 】进行安装,因为这个包是工具,要求全局都能使用,所以需要-g进行全局安装。
如果运行npm报错,请先安装Node.js,下载地址:https://nodejs.org/zh-cn/

第二步

继续在命令行里,运行【 wtu -V 】,执行结果如下:

显示版本号,说明已经安装成功了。(wtu -> 取自wx to uni之意,后面都用这个全局命令)

第三步

在命令行里,输入【wtu -i "你的小程序项目路径"】
注意 -i 前面和后面都有空格!!!
注意 -i 前面和后面都有空格!!!
注意 -i 前面和后面都有空格!!!
如:【wtu -i "E:\zpWork\Project_self\miniprogram-to-uniapp\test\test-wx-to-uni"】 ,回车后即可以在源项目同及目录得到一个后缀为_uni的目录,即转换成功。

转换前:

转换后:

转换后的项目文件对比(左边是小程序项目,右边是Uni-app项目目录):

第四步

将转换后的xxx_uni项目导入到hbuilder X,
点击菜单 运行--> 运行到小程序模拟器-->微信开发者工具!(如果是使用了vant的项目,请运行到H5,vant项目转换后仅支持H5和app)
点击菜单 运行--> 运行到小程序模拟器-->微信开发者工具!(如果是使用了vant的项目,请运行到H5,vant项目转换后仅支持H5和app)
点击菜单 运行--> 运行到小程序模拟器-->微信开发者工具!(如果是使用了vant的项目,请运行到H5,vant项目转换后仅支持H5和app)
重要的话说三遍!
然后查看转换后的项目运行到小程序,是否可以正常运行无报错!
(因为这种转换非100%,所以至少需要保证 小程序-->uniapp-->小程序仍然能正常运行,再考虑运行到其他小程序或app),
如有报错,请根据miniprogram to uniapp 工具答疑 进行修改,保证无报错,然后再运行到其他平台。

工具升级

因为工具更新比较频繁,安装后,可以使用如下命令进行升级:
npm update miniprogram-to-uniapp -g

注意:

  1. 遇到问题请参考文档:miniprogram to uniapp 工具答疑
  2. github上面的只是源代码。 日常使用,"仅"需要运行【 npm install miniprogram-to-uniapp -g 】进行安装才行,无需下载工具源码。
  3. 每次转换时都会将输出目录清空,请注意代码保存。
  4. 后续会有版本更新,请及时关注并更新~~,可以关注QQ群:780359397 获取最新信息

对于使用有疑问或建议,可以加入QQ群:780359397 进行讨论。

<a target="_blank" href="http://shang.qq.com/wpa/qunwpa?idkey=6cccd111e447ed70ee0c17672a452bf71e7e62cfa6b427bbd746df2d32297b64"><img border="0" src="http://pub.idqqimg.com/wpa/images/group.png" alt="小程序转uni-app讨论群" title="小程序转uni-app讨论群"></a>

因为有朋友使用本工具导致自己文件被删,在此表示抱歉!

this.setData()代码出处:https://ask.dcloud.net.cn/article/35020,在些表示感谢~

转换工具源码:https://github.com/zhangdaren/miniprogram-to-uniapp ,欢迎star和建议~

如有遇到bug或问题,欢迎评论、给出改进建议,感谢~~

21 关注 分享
z***@qq.com m***@gmail.com 7***@qq.com orageBeardApe 邓琪昌 bzliukai 我要 撇横横 8***@qq.com g***@126.com DigitalYu jinjidecj ai666 9***@qq.com heck b***@126.com 2***@qq.com Dlog_帅 灯下等雪 aliang888 876

要回复文章请先登录注册

zhangdaren

zhangdaren (作者)

回复 9***@qq.com :
template里data属性包含...扩展运算符时,不支持转换(因uni-app还不支持v-bind=""),请预先手动修改: data--> {{...cropperOpt}} file--> pages\writeStory\pages\tailorImg\tailorImg.wxml

是指的这个吧这个目前感觉没法好办法,只能手动改了。
2019-11-07 15:44
9***@qq.com

9***@qq.com

回复 zhangdaren :
转换出来没有app.vue 然后自己手动添加修改了下后需要用HBuilder X 重新识别文件类型,就可以了。
转换后大部分功能正常,花了两天时间解决报错,,基本上可以正常运行 感谢大佬。。。 目前发现的问题只有template 转换成component 后不正常,还在找处理方法。。


---日志信息---
image漏网之鱼: src--> "{{item.avatar}}" file--> components\chatroom\chatroom.wxml
image漏网之鱼: src--> "{{item.tempFilePath || item.imgFileID}}" file--> components\chatroom\chatroom.wxml
image漏网之鱼: src--> "cloud://yishishuo-rp7ci.7969-yishishuo-rp7ci/errorTemp/error2.png" file--> pages\errorTemp\errorTemp.wxml
image漏网之鱼: src--> "cloud://yishishuo-rp7ci.7969-yishishuo-rp7ci/menuTemp/suspension-look.png" file--> pages\menuTemp\menuTemp.wxml
image漏网之鱼: src--> "cloud://yishishuo-rp7ci.7969-yishishuo-rp7ci/menuTemp/suspension-write.png" file--> pages\menuTemp\menuTemp.wxml
image漏网之鱼: src--> "cloud://yishishuo-rp7ci.7969-yishishuo-rp7ci-1300215594/menuTemp/suspension-chat.png" file--> pages\menuTemp\menuTemp.wxml
image漏网之鱼: src--> "cloud://yishishuo-rp7ci.7969-yishishuo-rp7ci/menuTemp/suspension-my.png" file--> pages\menuTemp\menuTemp.wxml
image漏网之鱼: src--> "cloud://yishishuo-rp7ci.7969-yishishuo-rp7ci/menuTemp/suspension-menu.png" file--> pages\menuTemp\menuTemp.wxml
image漏网之鱼: src--> "{{item.pic_path}}" file--> pages\toClass\toClass.wxml
image漏网之鱼: src--> "{{item.pic_path}}" file--> pages\toClass\toClass.wxml
image漏网之鱼: src--> "{{item.like?'../../images/detail-icon1.png':'../../images/like.png'}}" file--> pages\toClass\toClass.wxml
image漏网之鱼: src--> "cloud://yishishuo-rp7ci.7969-yishishuo-rp7ci-1300215594/images/welcome-01.png" file--> pages\welcome\welcome.wxml
image漏网之鱼: src--> "cloud://yishishuo-rp7ci.7969-yishishuo-rp7ci-1300215594/images/welcome-02.png" file--> pages\welcome\welcome.wxml
image漏网之鱼: src--> "cloud://yishishuo-rp7ci.7969-yishishuo-rp7ci-1300215594/images/welcome-03.png" file--> pages\welcome\welcome.wxml
image漏网之鱼: src--> "{{item.head_pic}}" file--> pages\tabBar\chat\index.wxml
image漏网之鱼: src--> "cloud://yishishuo-rp7ci.7969-yishishuo-rp7ci-1300215594/images/banner.jpg" file--> pages\tabBar\index\index.wxml
image漏网之鱼: src--> "cloud://yishishuo-rp7ci.7969-yishishuo-rp7ci-1300215594/images/banner2.png" file--> pages\tabBar\index\index.wxml
image漏网之鱼: src--> "cloud://yishishuo-rp7ci.7969-yishishuo-rp7ci-1300215594/images/banner3.png" file--> pages\tabBar\index\index.wxml
image漏网之鱼: src--> "{{item.imgurl}}" file--> pages\tabBar\index\index.wxml
image漏网之鱼: src--> "{{item.pic_path}}" file--> pages\tabBar\index\index.wxml
image漏网之鱼: src--> "{{item.pic_path}}" file--> pages\tabBar\index\index.wxml
image漏网之鱼: src--> "{{item.like?'../../../images/detail-icon1.png':'../../../images/like.png'}}" file--> pages\tabBar\index\index.wxml
image漏网之鱼: src--> "{{user.head_pic}}" file--> pages\tabBar\myself\index.wxml
image漏网之鱼: src--> "cloud://yishishuo-rp7ci.7969-yishishuo-rp7ci-1300215594/images/my-lsxd.gif" file--> pages\tabBar\myself\index.wxml
image漏网之鱼: src--> "{{item.pic}}" file--> pages\tabBar\write\index.wxml
image漏网之鱼: src--> "cloud://yishishuo-rp7ci.7969-yishishuo-rp7ci/errorTemp/errorChapter.png" file--> pages\tabBar\write\index.wxml
image漏网之鱼: src--> "{{item.head_pic}}" file--> pages\chatStory\pages\joinChat\joinChat.wxml
image漏网之鱼: src--> "{{likes?'../../../../images/detail-icon1.png':'../../../../images/detail-icon4.png'}}" file--> pages\chatStory\pages\postDetails\postDetails.wxml
image漏网之鱼: src--> "{{current.head_pic}}" file--> pages\chatStory\pages\secondComment\secondComment.wxml
image漏网之鱼: src--> "{{item.head_pic}}" file--> pages\chatStory\pages\secondComment\secondComment.wxml
image漏网之鱼: src--> "cloud://yishishuo-rp7ci.7969-yishishuo-rp7ci/errorTemp/errorChapter.png" file--> pages\chatStory\pages\secondComment\secondComment.wxml
image漏网之鱼: src--> "{{item.head_pic}}" file--> pages\chatStory\pages\talkComment\talkComment.wxml
image漏网之鱼: src--> "{{current.head_pic}}" file--> pages\chatStory\pages\talkDetail\talkDetail.wxml
image漏网之鱼: src--> "{{item.head_pic}}" file--> pages\chatStory\pages\talkDetail\talkDetail.wxml
image漏网之鱼: src--> "cloud://yishishuo-rp7ci.7969-yishishuo-rp7ci/errorTemp/errorChapter.png" file--> pages\chatStory\pages\talkDetail\talkDetail.wxml
image漏网之鱼: src--> "{{item.head_pic}}" file--> pages\indexStory\pages\articleComment\articleComment.wxml
image漏网之鱼: src--> "{{article.head_pic?article.head_pic:'../../../../images/chat-pic1.png'}}" file--> pages\indexStory\pages\storyDetail\storyDetail.wxml
image漏网之鱼: src--> "{{item.head_pic}}" file--> pages\indexStory\pages\storyDetail\storyDetail.wxml
image漏网之鱼: src--> "cloud://yishishuo-rp7ci.7969-yishishuo-rp7ci/contribute_code.png" file--> pages\myIndex\pages\contribute\contribute.wxml
image漏网之鱼: src--> "cloud://yishishuo-rp7ci.7969-yishishuo-rp7ci-1300215594/my-points2.png" file--> pages\myIndex\pages\goodsDetail\goodsDetail.wxml
image漏网之鱼: src--> "cloud://yishishuo-rp7ci.7969-yishishuo-rp7ci-1300215594/my-points3.png" file--> pages\myIndex\pages\goodsDetail\goodsDetail.wxml
image漏网之鱼: src--> "{{item.head_pic}}" file--> pages\myIndex\pages\myFans\myFans.wxml
image漏网之鱼: src--> "{{item.head_pic}}" file--> pages\myIndex\pages\myFocus\myFocus.wxml
image漏网之鱼: src--> "{{user.head_pic}}" file--> pages\myIndex\pages\myHome\myHome.wxml
image漏网之鱼: src--> "{{user.head_pic}}" file--> pages\myIndex\pages\userInfo\userInfo.wxml
image漏网之鱼: src--> "cloud://yishishuo-rp7ci.7969-yishishuo-rp7ci/errorTemp/errorChapter.png" file--> pages\writeStory\pages\branchList\branchList.wxml
image漏网之鱼: src--> "{{item.head_pic}}" file--> pages\writeStory\pages\chapterComment\chapterComment.wxml
image漏网之鱼: src--> "{{item.head_pic}}" file--> pages\writeStory\pages\chapterDetail\chapterDetail.wxml
image漏网之鱼: src--> "{{img}}" file--> pages\writeStory\pages\editStory\editStory.wxml
image漏网之鱼: src--> "{{item.pic}}" file--> pages\writeStory\pages\myJoin\myJoin.wxml
image漏网之鱼: src--> "{{item.pic}}" file--> pages\writeStory\pages\myStart\myStart.wxml
image漏网之鱼: src--> "{{item.pic}}" file--> pages\writeStory\pages\mySubscribe\mySubscribe.wxml
image漏网之鱼: src--> "cloud://yishishuo-rp7ci.7969-yishishuo-rp7ci/errorTemp/errorChapter.png" file--> pages\writeStory\pages\otherBrList\otherBrList.wxml
image漏网之鱼: src--> "{{item.head_pic}}" file--> pages\writeStory\pages\otherDeatil\otherDeatil.wxml
image漏网之鱼: src--> "{{prev_list.pic}}" file--> pages\writeStory\pages\readStory\readStory.wxml
image漏网之鱼: src--> "{{item.head_pic}}" file--> pages\writeStory\pages\readStory\readStory.wxml
image漏网之鱼: src--> "{{item.pic}}" file--> pages\writeStory\pages\startDrafts\startDrafts.wxml
image漏网之鱼: src--> "{{img}}" file--> pages\writeStory\pages\startStory2\startStory2.wxml
image漏网之鱼: src--> "{{img}}" file--> pages\writeStory\pages\startStory2\startStory2.wxml
image漏网之鱼: src--> "{{item.head_pic}}" file--> pages\writeStory\pages\storyComment\storyComment.wxml
image漏网之鱼: src--> "cloud://yishishuo-rp7ci.7969-yishishuo-rp7ci/errorTemp/errorChapter.png" file--> pages\writeStory\pages\storyComment\storyComment.wxml
template里data属性包含...扩展运算符时,不支持转换(因uni-app还不支持v-bind=""),请预先手动修改: data--> {{...cropperOpt}} file--> pages\writeStory\pages\tailorImg\tailorImg.wxml
2019-11-05 11:27
zhangdaren

zhangdaren (作者)

回复 ff不押i :
这个不是完整的日志吧? 运行时有什么错误呢?
2019-11-05 11:09
ff不押i

ff不押i

微信小程序的代码编译后。不能运行到小程序调试终端了~~这个要怎么做才可以呢?还需要配置什么?
日志如下:
---日志信息---
Convert wxs file E:\demoList\airTheater用户端_uni\src\components\vant\wxs\object.js success!
Convert wxs file E:\demoList\airTheater用户端_uni\src\components\vant\wxs\utils.js success!
Convert wxs file E:\demoList\airTheater用户端_uni\src\components\vant\wxs\array.js success!
Convert wxs file E:\demoList\airTheater用户端_uni\src\components\vant\wxs\bem.js success!
Convert wxs file E:\demoList\airTheater用户端_uni\src\components\vant\wxs\memoize.js success!
Convert wxs file E:\demoList\airTheater用户端_uni\src\components\node_modules\vant-weapp\dist\wxs\array.js success!
Convert wxs file E:\demoList\airTheater用户端_uni\src\components\node_modules\vant-weapp\dist\progress\index.js success!
Convert wxs file E:\demoList\airTheater用户端_uni\src\components\node_modules\vant-weapp\dist\wxs\bem.js success!
Convert wxs file E:\demoList\airTheater用户端_uni\src\components\node_modules\vant-weapp\dist\wxs\utils.js success!
Convert wxs file E:\demoList\airTheater用户端_uni\src\components\node_modules\vant-weapp\dist\wxs\memoize.js success!
Convert wxs file E:\demoList\airTheater用户端_uni\src\components\node_modules\vant-weapp\dist\wxs\object.js success!
Convert wxs file E:\demoList\airTheater用户端_uni\src\components\node_modules\vant-weapp\lib\progress\index.js success!
Convert wxs file E:\demoList\airTheater用户端_uni\src\components\node_modules\vant-weapp\lib\wxs\array.js success!
Convert wxs file E:\demoList\airTheater用户端_uni\src\components\node_modules\vant-weapp\lib\wxs\utils.js success!
Convert wxs file E:\demoList\airTheater用户端_uni\src\components\node_modules\vant-weapp\lib\wxs\bem.js success!
Convert wxs file E:\demoList\airTheater用户端_uni\src\components\node_modules\vant-weapp\lib\wxs\memoize.js success!
Convert wxs file E:\demoList\airTheater用户端_uni\src\components\node_modules\vant-weapp\dist\picker-column\index.js success!
Convert wxs file E:\demoList\airTheater用户端_uni\src\components\node_modules\vant-weapp\lib\picker-column\index.js success!
Convert wxs file E:\demoList\airTheater用户端_uni\src\components\node_modules\vant-weapp\lib\wxs\object.js success!
2019-11-05 11:00
zhangdaren

zhangdaren (作者)

回复 9***@qq.com :
转换出来没有app.vue文件是吗? 日志可以贴一下嘛?
云开发的文件放进去也没用,因为编译后也会被删除,云开发的只能单独在小程序开发工具里编写。
2019-11-05 10:37
9***@qq.com

9***@qq.com

用最新版转换,在HB里运行的时候无法识别为小程序项目,是app.js 未转换成app.vue 的原因吗。。。我尝试了手动修改。也不行。。另外 转换的时候云开发文件好像没有包含进去的吧,是要另外在做处理吗。
2019-11-04 15:16
zhangdaren

zhangdaren (作者)

回复 2***@qq.com :
那用回默认模式试试吧,vue模式就是多了一个可以自定义路径的功能。
2019-11-02 18:38
2***@qq.com

2***@qq.com

回复 zhangdaren :
日志也没看到报错啊,就提示手动替换include而已
2019-11-02 10:29
zhangdaren

zhangdaren (作者)

回复 2***@qq.com :
是不是日志里报错了?
2019-11-02 10:22
2***@qq.com

2***@qq.com

回复 zhangdaren :
转换完不见package.json文件,安装不到依赖,自己先init再install也不行
2019-11-01 22:30