antmove
小程序转换器,基于支付宝/微信小程序转换为多端小程序,让小程序跨平台开发变得简单。
Last updated 2 days ago by amap-appx .
GPL-3.0 · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install antmove 
SYNC missed versions from official npm registry.

Antmove(蚂蚁搬家)

antmove logo

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

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

antmove structure

目录

特性

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

跨平台支持

# 编译命令 描述 文档 Npm
1 wx-alipay 微信小程序转支付宝小程序,支持阿里系其它平台小程序编译(如 钉钉小程序) README.md @antmove/wx-alipay - npm
2 wx-baidu 微信小程序转百度智能小程序 README.md @antmove/wx-baidu - npm
3 wx-tt (非正式版) 微信小程序转字节跳动小程序 README.md @antmove/wx-tt - npm
4 alipay-wx 支付宝小程序转微信小程序 README.md @antmove/alipay-wx - npm
5 alipay-baidu 支付宝小程序转百度智能小程序 README.md @antmove/alipay-baidu - npm
6 wx-compiler 对于有跨平台代码编写的,可以用该命令得到纯净的微信小程序代码 README.md @antmove/wx-wx - npm
7 alipay-compiler 原生支付宝小程序引用 Antmove 转换而来的组件库时,使用该命令对引用项目编译,以支持 relations 和 selectComponent 能力 README.md @antmove/alipay-polyfill - npm

文档

安装

vscode 转换插件

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

VsCode 编译步骤

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

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

  • 打开 VsCode 命令面板

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

  • 运行 Antmove: Run antmove 命令

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

  • 转换完成

  • antmove-vscode-plugin

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

使用 npm 或 yarn 安装

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

  • 全局安装
$ npm install antmove -g

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

$ yarn add antmove

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

快速开始

命令行使用

npm i -g antmove

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

提供两种可用的命令行调用方式(如下几个命令的参数是类似的)

  • 微信小程序转支付宝小程序命令 - wx-alipay
  • 支付宝小程序转微信小程序 - alipay-wx
  • 支付宝小程序转百度智能小程序 - alipay-baidu

你可以通过微信转支付宝转百度的链路实现百度小程序的支持哦,Antmove 已经做二次转换的特别处理。

  • antmove wx-alipay(使用前请将终端切换到需转换编译的微信小程序项目路径)
antmove wx-alipay -i ./ -o ./dist/alipay-app

或者

antmove wx-alipay
  • antmove - 该命令更加灵活,可配置输出输出目录/编译模式等
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 使用方式

示例

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)
        • 默认值为生产环境
  • start | Function - 开始编译操作

谁在使用

微信小程序

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

支付宝小程序

高德小程序

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

贡献

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

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

协议

GPL

联系

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

  • 钉钉微信交流群:
  • 邮件:amap-appx@service.autonavi.com

Current Tags

  • 1.0.19                                ...           latest (2 days ago)

59 Versions

  • 1.0.19                                ...           2 days ago
  • 1.0.15                                ...           7 days ago
  • 1.0.3                                ...           a month ago
  • 1.0.2                                ...           a month ago
  • 1.0.1                                ...           2 months ago
  • 1.0.0                                ...           2 months ago
  • 0.2.26                                ...           2 months ago
  • 0.2.25                                ...           2 months ago
  • 0.2.24                                ...           2 months ago
  • 0.2.23                                ...           2 months ago
  • 0.2.21                                ...           3 months ago
  • 0.2.20                                ...           3 months ago
  • 0.2.19                                ...           3 months ago
  • 0.2.18                                ...           3 months ago
  • 0.2.17                                ...           3 months ago
  • 0.2.16                                ...           3 months ago
  • 0.2.15                                ...           3 months ago
  • 0.2.14                                ...           3 months ago
  • 0.2.13                                ...           3 months ago
  • 0.2.12                                ...           3 months ago
  • 0.2.11                                ...           3 months ago
  • 0.2.10                                ...           3 months ago
  • 0.2.9                                ...           3 months ago
  • 0.2.8                                ...           3 months ago
  • 0.2.1                                ...           3 months ago
  • 0.1.22                                ...           3 months ago
  • 0.1.13                                ...           3 months ago
  • 0.1.12                                ...           4 months ago
  • 0.1.11                                ...           4 months ago
  • 0.1.10                                ...           4 months ago
  • 0.1.9                                ...           4 months ago
  • 0.1.8                                ...           4 months ago
  • 0.1.7                                ...           4 months ago
  • 0.1.6                                ...           4 months ago
  • 0.1.5                                ...           4 months ago
  • 0.1.4                                ...           4 months ago
  • 0.1.1                                ...           4 months ago
  • 0.0.23                                ...           4 months ago
  • 0.0.22                                ...           4 months ago
  • 0.0.21                                ...           4 months ago
  • 0.0.20                                ...           4 months ago
  • 0.0.19                                ...           4 months ago
  • 0.0.18                                ...           4 months ago
  • 0.0.17                                ...           4 months ago
  • 0.0.16                                ...           4 months ago
  • 0.0.15                                ...           4 months ago
  • 0.0.14                                ...           4 months ago
  • 0.0.13                                ...           4 months ago
  • 0.0.12                                ...           4 months ago
  • 0.0.11                                ...           4 months ago
  • 0.0.10                                ...           4 months ago
  • 0.0.9                                ...           4 months ago
  • 0.0.8                                ...           4 months ago
  • 0.0.6                                ...           4 months ago
  • 0.0.5                                ...           4 months ago
  • 0.0.4                                ...           4 months ago
  • 0.0.3                                ...           4 months ago
  • 0.0.2                                ...           4 months ago
  • 0.0.1                                ...           4 months ago
Maintainers (1)
Downloads
Today 0
This Week 19
This Month 66
Last Day 0
Last Week 35
Last Month 295
Dependencies (18)
Dev Dependencies (14)

Copyright 2014 - 2016 © taobao.org |