wgq4812 / miniprogram-to-uniapp

Try to transform Weixin miniprogram project to Uni-app project

转换各种小程序为 uni-app 项目

支持转换微信、QQ、头条/抖音、支付宝/钉钉和百度等小程序转换到 uni-app 项目

输入小程序项目路径，即可输出 uni-app 项目。

PS: 目前工具转换支持度最好的为：微信小程序和QQ小程序。

同时支持 Npm 安装 和 HbuilderX 插件(不依赖环境) 两种形式安装，安装方式如下：

Npm 安装

$ npm install miniprogram-to-uniapp -g

使用方法

Usage: wtu [options]

Options:

  -V, --version          output the version number [版本信息]
  -i, --input <target>   the input path for weixin miniprogram project [输入目录]
  -h, --help             output usage information [帮助信息]
  -c, --cli              the type of output project is vue-cli, which default value is false [是否转换为vue-cli项目，默认false]
  -w, --wxs              transform wxs file to js file, which default value is false [是否将wxs文件转换为js文件，默认false]
  -z, --vant             transform vant-weapp project to uni-app, automatic check [是否支持转换vant项目，默认为false]
  -r, --rename           rename wx.xxx() to uni.xxx(), which default value is true [是否转换wx.xxx()为uni.xxx()，默认true]
  -m, --merge            merge wxss file into vue file, which default value is false [是否合并wxss到vue文件，默认false]
  -f, --repair           repair javascript, which default value is false [是否对混淆过的js进行尽可能还原，默认false]

示例:

默认转换:

$ wtu -i ./miniprogram-project

vant 小程序转换为 uni-app 项目:

$ wtu -i ./miniprogram-project -z

将 wxss 合并入 vue 文件:

$ wtu -i ./miniprogram-project -m

转换项目为vue-cli项目:

$ wtu -i ./miniprogram-project -c

尽可能修复压缩混淆代码(实验阶段):

$ wtu -i ./miniprogram-project -f

HbuilderX 插件安装

请参考项目：【HBuilder X 插件】 转换各种小程序为 uni-app 项目 进行食用。

目前这种方式，不支持转换 vant 项目，如需转换 vant 项目，请使用 Npm 安装 方式。

使用指南

本插件详细使用教程，请参照：miniprogram-to-uniapp 使用指南。

使用时遇到问题，请仔细阅读： miniprogram to uniapp 工具答疑文档.md

对于使用有疑问或建议，欢迎加入 QQ 群进行指导和反馈。

交流 QQ 群： 1 群：780359397 (已满) 2 群：361784059

已完成

• 支持微信、QQ、头条/抖音、支付宝/钉钉和百度等小程序转换到 uni-app 项目
• 支持有/无云开发的小程序项目转换为 uni-app 项目
• 支持解析 TypeScript 小程序项目
• 支持解析使用 npm 模块的小程序项目
• 支持解析 include 标签
• 支持解析 template 标签
• 支持解析 Behavior 文件为 mixins 文件
• 合并使用 require 导入的 wxs 文件
• setData() polyfill， setData 函数无须另外处理！
• 支持识别 App、Page、Component、VantComponent、Behavior 和纯 Javascript 文件的转换
• 使用mp-html替换 wxParse(感谢网友 “爱瑞巴勒康忙北鼻” 的建议)
• 将所有非 static 目录下资源文件移入 static 目录，并修复所有能修复到的路径
• 对代码语法做了大量的兼容，如修复变量名与函数重名的情况等
• 对混淆代码进行语义化分析，并作反混淆处理
• 搜索template和setData里未声明的变量，智能识别变量类型，并在data里面进行声明！

不支持转换的功能及组件

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

更新记录

v1.1.5(20210703)

• [优化] 过滤ts文件
• [修复] app.js里data原样移入globalData
• [修复] 将整个表达式在data里创建变量的bug(<view wx:if='(plugins_coupon_data || null) != null'></view>) ...等等

历史更新记录

感谢

• 感谢转转大佬的文章：[AST 实战]从零开始写一个 wepy 转 VUE 的工具， 本项目基于此文章里面的代码开发，在此表示感谢~
• 感谢网友[没有好名字了]给予帮助。
• 感谢 DCloud 官方大佬[安静]给予帮助。
• 感谢网友[☆_☆]给予帮助。
• 感谢网友[☆_☆]提供增强版 setData。
• 感谢官方大佬 DCloud_heavensoft 的文章：微信小程序转换 uni-app 详细指南，补充了我一些未考虑到的规则。
• 工具使用mp-html替换 wxParse，表示感谢~
• 工具使用全兼容官方 picker mode=region 城市选择器替换 <picker mode="region"></picker>，表示感谢~
• 感谢为本项目给予赞助及提供建议的网友们~~

参考资料

0. [AST 实战]从零开始写一个 wepy 转 VUE 的工具 此文获益良多
1. https://astexplorer.net/ AST 可视化工具
2. Babylon-AST 初探-代码生成(Create) 系列文章(作者还是个程序媛噢~)
3. Babel 插件手册 中文版 Babel 插件手册
4. Babel 官网 有问题直接阅读官方文档哈
5. 微信小程序转换 uni-app 详细指南 补充了我一些未考虑到的规则。
6. 更新 babel 版本，命令：npx babel-upgrade --write

最后

如果觉得帮助到你的话，可以支持一下作者，请作者喝杯咖啡哈~ 这样会更有动力更新哈~~ 非常感谢~~

LICENSE

This repo is released under the MIT.