微信小程序转uni-app过程记录及心得

这是一篇使用开源小工具miniprogram-to-uniapp 的使用心得记录,因为工作需要,自己尝试过手动搬页面,但觉得重复性搬运实在繁琐,而且耗费时间,所以在网上找了找有没有现成的工具,终于看见这么个小工具,感谢开源的作者。

转换工具文档:miniprogram-to-uniapp使用指南

推荐一下源码:https://github.com/zhangdaren/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);
        });
    });

}

这个函数主要的作用如下:

  1. 读取需要转换的文件路径,如果没有指定输出目录,就在同级目录下新建一个以_uni为后缀的文件夹
  2. 读取小程序项目配置,也就是project.config.json,package.json
  3. 遍历目录:(遇到文件夹则继续向下遍历)
    • 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文件,会直接复制到根目录下
  4. 处理文件组,即上面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文件处理,图片路径区分(本地资源、网络资源)
    • 写入文件,上面步骤返回的最后都是字符串
  5. 处理配置文件,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

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 151,688评论 1 330
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 64,559评论 1 273
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 101,749评论 0 226
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 42,581评论 0 191
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 50,741评论 3 271
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 39,684评论 1 192
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,122评论 2 292
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 29,847评论 0 182
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 33,441评论 0 228
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 29,939评论 2 232
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 31,333评论 1 242
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 27,783评论 2 236
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 32,275评论 3 220
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 25,830评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,444评论 0 180
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 34,553评论 2 249
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 34,618评论 2 249

推荐阅读更多精彩内容