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、高级用法
- 支付宝代码与微信代码混合编写
- 微信小程序到支付宝小程序登录迁徙
评论