@weimob-cloud/matrix

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，会有部分差异。