wm-cloud-matrix

wm-cloud-matrix 介绍

这是一个尝试将 微信小程序的组件或页面 转换成 React组件 的编译转换工具。 同时也支持带条件编译的小程序代码编译为小程序平台的代码和H5平台的React代码。

用户安装使用

有两种使用方式：

一、JS API

$ npm install @weimob-cloud/matrix --save

const wmatrix = require('@weimob-cloud/matrix')
wmatrix.build(options)

Options

| 字段 | 类型 | 含义 | 默认值/参数 | 可选值| | ---- | ---- | ---- | ---- | ---- | | root | String | 项目根目录 | process.cwd() | - | | target | String | 编译目标平台 | all | all h5 xapp | | entry | String/Array | 待编译的组件的相对路径| ./wmxapp | ./wmxapp 该目录下所有组件 \ ./wmxapp/comp1 ./wmxapp/comp2 指定单个组件或多个组件 | | outdirh5 | String | h5平台的编译输出路径 | ./web | - | | outdirxapp | String | 小程序平台的编译输出路径 | ./xapp | - | | done | Function | 编译完成后的回调函数 | f(成功组件,失败组件,耗时){} | - |

二、命令行工具

$ npm install -g @weimob-cloud/matrix

$ matrix -r /Users/xxx/.../myproject -e ./wmxapp/comp1 ./wmxapp/comp2 -oh ./web -ox ./xapp
or
$ matrix -e ./xapp

命令行参数的options：

| option | 简写 | 含义 | 默认值/参数 | 可选值| | ---- | ---- | ---- | ---- | ---- | | --root | -r | 项目根目录 | process.cwd() | - | | --target | -t | 编译目标平台 | all | all h5 xapp | | --entry | -e | 待编译的组件的相对路径| ./wmxapp | - | | --outdirh5 | -oh | h5平台的编译输出路径 | ./web | - | | --outdirxapp | -ox | 小程序平台的编译输出路径 | ./xapp | - |

开发者参与开发

环境准备

1. node: "12.x || >=14.0.0"
2. npm: 与node配套即可
3. 包管理工具：npm，镜像源：微盟镜像源，已默认配置.npmrc

本地联调方法

在vscode工具中配置launch.json

编译打包

$ npm run build

注：打包后最好测试一下功能是否正常，因为开发用ESM，打包后是CommonJS，会有部分差异。