/wto

WeChat mini-program to other mini-program.

Primary LanguageJavaScript

wto

wto: wechat mini-program to other mini-program

简介

wto是一款支持将原生微信小程序转换成其他小程序的工具集合。
使用wto，几乎不需要对已有的微信小程序做任何改动，可以接近零成本获得百度小城、阿里小程序、头条小程序。

安装

 npm i wto-cli -g
 # or
 yarn global add wto-cli

使用

命令行

  # 转换成百度小程序
  wto build -p baidu -s src -t dist/baidu
  
  # 转换成阿里小程序
  wto build -p alibaba -s src -t dist/alibaba
  
  # 转换成头条小程序
  wto build -p alibaba -s src -t dist/alibaba
  
  # 转换成百度&&阿里&&头条小程序
  wto build -s src -t dist

打包工具

const gulp = require('gulp');
const wto = require('wto-cli');

// 转换成百度小程序
gulp.task('baidu', function(cb) {
    wto.toBaidu({
      source: './miniprogram-demo',
      target: './baidu-miniprogram-demo'
    });
});

// 转换成阿里小程序
gulp.task('alibaba', function(cb) {
    wto.toBaidu({
      source: './miniprogram-demo',
      target: './alibaba-miniprogram-demo'
    });
});

// 转换成头条小程序
gulp.task('alibaba', function(cb) {
    wto.toBaidu({
      source: './miniprogram-demo',
      target: './toutiao-miniprogram-demo'
    });
});

// 转换成百度/阿里/头条小程序
gulp.task('all', function(cb) {
    converter.toAll({
      source: './miniprogram-demo',
      baiduTarget: './baidu-miniprogram-demo',
      alibaTarget: './alibaba-miniprogram-demo',
      toutiaoTarget: './toutiao-miniprogram-demo',
    });
});

使用案例

wto已经投入了我们的生产环境中使用，包括58微聊和神奇江湖

注意事项

注意事项是各平台不支持且无法通过本工具转换完成的一些点，如果要开发跨平台的应用需要规避或者降级处理。

百度小程序

  • bind*={{str}} str只能是字面量，不能包含运算（如：bindtap="flag ? 'fn1' : 'fn2'"）
  • wx:for={{arr}} arr只能是字面量，不不能包含运算（如：wx:for="{{flag ? arr1 : arr2}}"）
  • 文件名必须与组件目录一致（custom-com/custom-com.(js|json|wxml|wxss)）
  • 不要使用setData保存视图不需要的变量（如原生变量：Animation），继承字段会被丢弃
  • 图片的src属性不能用数组赋值（如：<image src="{{arr}}"></image>）

头条小程序

  • 不支持组件（如：movable-area、movable-view、cover-view、cover-image、map、audio、canmera等）
  • websocket不能使用全局事件（如：wx.onSocketOpen）
  • 录音功能没有全局方法（wx.startRecord, wx.stopRecord）
  • 不支持背景音频
  • 不支持实时音视频通话
  • 条件/循环渲染，不能进行函数调用运算（如：wx:if="{{['aa', 'bb'].indexOf('aa')===-1}}"）
  • 图片的src属性不能用数组赋值（如：<image src="{{arr}}"></image>）
  • wx:for不支持对象
  • 不支持selectComponent
  • 所有页面必须在pages目录下

阿里小程序

  • TODO