小程序转换器,基于支付宝/微信小程序转换为多端小程序,让小程序跨平台开发变得简单。


Keywords
miniprogram, wechat-mini-program, alipay-programm, miniprogram-frame, tool, components, baidu-miniprogram, alipay-miniapp, framework, toutiao-miniprogram, wechat
License
GPL-3.0
Install
npm install antmove@0.2.26

Documentation

蚂蚁搬家工具

antmove logo

蚂蚁搬家工具,让小程序跨平台开发变得简单。

一键实现微信小程序项目到支付宝小程序的迁徙,不再为重复开发而烦恼。

特性

  • 简单易使用,无学习成本,直接上手
  • 转换覆盖率全面,及时跟进各小程序平台更新情况
  • 配套详细的编译时日志/运行时日志工具
  • 编译生成代码可读性强,可二次编程
  • 二次编译支持

文档

安装

使用 npm 或 yarn 安装

我们推荐使用 npm 或 yarn 的方式进行开发,不仅可在开发环境轻松调试,也可放心地在生产环境打包部署使用,享受整个生态圈和工具链带来的诸多好处。

  • 全局安装
$ npm install antmove -g
  • 本地安装
$ npm install antmove --save

如果你的网络环境不佳,推荐使用 cnpm

快速开始

命令行使用

通过 npm 或 yarn 全局安装才能使用如下命令行

提供两种可用的命令行调用方式

  • antmove wx-alipay(使用前请将终端切换到需转换编译的微信小程序项目路径)
antmove wx-alipay ./dist/alipay-app
  • antmove - 该命令更加灵活,可配置输出输出目录/编译模式等
antmove -i ./wechat-mini/project -o ./dist/alipay-mini/project --env development

如上的命令表示将 ./wechat-mini/project 微信小程序项目转换为支付宝小程序项目,转换到 ./dist/alipay-mini/project 目录

命令行参数说明

  • --input,-i
    • 可选,编译源码目录,如果不传则是当前目录
  • --output,-o
    • 必传,编译输出目录
  • --env,-e
    • 可选,编译模式,生产模式代码会压缩,无编译日志及运行时日志

Node.js 使用方式

示例

const path = require('path');
const transformFramework = require('antmove');
const WechatPlugin = require('@antmove/wx-alipay');

let outputPath = path.join(__dirname, '../../dist');
let inputDirPath = path.join(__dirname, '../../examples/miniprogram-demo/miniprogram');

const App = transformFramework();

App.use(
    WechatPlugin, 
    {
        entry: inputDirPath,
        dist: outputPath + '/alipaymini-demo',
        env: 'development'
    })
    .start();

API

transformFramework

工具实例生成函数。

const transformFramework = require('antmove');
const App = transformFramework();   // 得到的 app 实例即可进行转换处理操作

App

  • use | Function - App.use(plugin, pluginOptions) - 挂载插件到实例上,可挂载多个,按挂载顺序执行
    • plugin: 转换插件
    • pluginOptions: 转换插件配置项
      • entry | String - 转换源码目录
      • dist | String - 转换后代码输出目录
      • env | String - 编译环境设置(env/prod)
        • 默认值为生产环境
      • remote | Boolean - 是否拉去远程拉取 polyfill 代码
        • 默认开启
  • start | Function - 开始编译操作

计划(即将推出)

  • 支付宝转百度能力支持
  • 支付宝转微信能力支持
  • 支付宝转头条能力支持
  • 页面/组件维度转换能力支持

谁在使用

如果你的公司和产品使用了 Ant move,欢迎到这里留言。

贡献

欢迎参与蚂蚁搬家项目的开发建设和讨论。

提交 pull request 之前请先提 Issue 讨论.

协议

GPL

联系

如果您在使用的过程中碰到问题,可以通过下面几个途径寻求帮助。