Antmove

Antmove（中文：蚂蚁搬家），是一个小程序平台开发的统一解决方案，通过编写一次代码，编译成不同平台的小程序代码，如现如今使用比较多的微信小程序、支付宝小程序、百度智能小程序、头条小程序以及更多小程序平台。现Antmove已支持微信小程序和支付宝小程序的转换，其中百度智能小程序、头条小程序以及更多的支持也即将推出。

antmove 的初衷是提供一种小程序跨平台开发的解决方案，帮助开发者底层本实现小程序的跨平台开发（微信小程序、支付宝小程序、百度智能小程序、头条小程序），做到一套代码开发、多小程序平台运行的目的。

目前 antmove 已经帮助了多款微信小程序到支付宝小程序的迁徙，代码转换率高达 90%+，极大的降低了小程序开发企业的人力成本。工具不仅能做到运行时 diff 的抹平，也能部分做到一个 API 从无到有的过程以及缺失组件的支持。

1、特性

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

2、安装

vscode 转换插件，可以在VSCode的扩展中搜索Antmove下载安装转换插件来实现一键转换。

3、编译步骤

• 安装扩展（Antmove - antmove-vscode-plugin）
• 在 VsCode 中打开要转换的项目
• 打开 VsCode 命令面板
• Mac: command + shift + p
• Windows: ctrl + shift + p
• 输入 Antmove
• 运行 Antmove: Run antmove 命令
• 运行如上命令后会给出一个弹窗，选择转换后生成代码存储目录
• 转换完成

4、使用 npm 或 yarn 安装

推荐使用 npm 或 yarn 的方式进行开发，不仅可在开发环境轻松调试，也可放心地在生产环境打包部署使用

• 全局安装

$ npm install antmove -g

• 本地安装

$ npm install antmove --save

由于网络环境原因可以使用cnpm来进行安装

5、命令行使用

通过 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
• 可选（development/production），编译模式，生产模式代码会压缩，无编译日志及运行时日志

6、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();

7、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 - 开始编译操作

8、高级用法

• 支付宝代码与微信代码混合编写
• 微信小程序到支付宝小程序登录迁徙