指南

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

一键实现小程序转换迁徙,不再为重复开发而烦恼。

antmove structure

特性

  • 简单易使用,一键转换
  • 配套详细的编译时日志/运行时日志工具
  • 编译生成代码可读性强,可二次编程
  • 二次编译支持
  • 组件转换支持

文档

安装

VsCode 扩展安装

在 vscode 扩展中搜索 Antmove 下载安装 Antmove vscode 转换插件实现一键转换。

命令行安装

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

  • 全局安装
  1. $ npm install antmove -g

  1. $ yarn global add antmove
  • 本地安装
  1. $ npm install antmove --save

  1. $ yarn add antmove

如果你的网络环境不佳,推荐使用 cnpm指南 - 图2

快速开始

VsCode 扩展使用

  • 安装扩展(Antmove - antmove-vscode-plugin)

  • 在 VsCode 中打开要转换的项目

  • 打开 VsCode 命令面板

    • Mac: command + shift + p
    • Windows: ctrl + shift + p
  • 输入 Antmove

  • 运行 Antmove: Run antmove 命令

  • 运行如上命令后会给出一个弹窗,选择转换后生成代码存储目录

  • 转换完成

  • antmove-vscode-plugin指南 - 图3

本插件依赖于 vscode 代码编辑器,安装了 vscode 的用户才能使用。

命令行使用

  1. npm i -g antmove

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

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

如上的命令表示将 ./wechat-mini/project 微信小程序项目转换为支付宝小程序项目,转换到 ./dist/alipay-mini/project 目录 如果你不想输入参数,可以体验交互式的命令方式,执行 antmove 即可。

配置参数

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

更多配置项可参考配置参数详情

Node.js 使用方式

示例

  1. const path = require('path');
  2. const transformFramework = require('antmove');
  3. const WechatPlugin = require('@antmove/wx-alipay');
  4. let outputPath = path.join(__dirname, '../../dist');
  5. let inputDirPath = path.join(__dirname, '../../examples/miniprogram-demo/miniprogram');
  6. const App = transformFramework();
  7. App.use(
  8. WechatPlugin,
  9. {
  10. entry: inputDirPath,
  11. dist: outputPath + '/alipaymini-demo',
  12. env: 'development'
  13. })
  14. .start();

谁在使用

微信小程序

这里展示的微信小程序为原小程序应用,下面的其它平台小程序为基于这些微信小程序转换得到。

指南 - 图4指南 - 图5指南 - 图6指南 - 图7

支付宝小程序

指南 - 图8指南 - 图9指南 - 图10指南 - 图11指南 - 图12

高德小程序

指南 - 图13指南 - 图14指南 - 图15指南 - 图16

如果你的公司和产品使用了 Antmove指南 - 图17,欢迎到这里指南 - 图18留言。

贡献

欢迎参与 Antmove 项目的开发建设和讨论。

提交 pull request 之前请先提 Issue 讨论指南 - 图19.

协议

GPL指南 - 图20

联系

  • Email:amap-appx@service.autonavi.com