# wx2 > 微信小程序 转换 百度小程序 Latest version **1.1.0** (published 2021-04-28) · MIT license · 0 weekly downloads ## Install ```sh npm install wx2 pnpm add wx2 yarn add wx2 bun add wx2 ``` Provides the command `wx2`. ## Health **Score 15/100 (F)** — status: abandoned. Positive: no vulnerabilities. Warnings: low downloads; no types; no esm support. Negative: abandoned; low maintenance score. ## Facts | | | |---|---| | Version | 1.1.0 | | Published | 2021-04-28 | | First published | 2020-04-01 | | Weekly downloads | 0 | | License | MIT | | TypeScript types | none | | Module format | CommonJS | | Node | >=8.5.0 | | Dependencies | 22 | | Unpacked size | 174.4 KB | | Known vulnerabilities | 0 (+5 in 1 direct dependencies) | | Install scripts | no | | Author | wangpanfe | | Maintainers | gaoxiaofei | | Keywords | 小程序, 微信小程序, 百度小程序, 转换, swan, wx | ## Links - npm: https://www.npmjs.com/package/wx2 - npm.io page: https://npm.io/package/wx2 ## Dependencies (22) - [glob](https://npm.io/package/glob.md) ^7.1.6 - [chalk](https://npm.io/package/chalk.md) ^2.4.2 - [vfile](https://npm.io/package/vfile.md) ^4.0.2 - [lodash](https://npm.io/package/lodash.md) ^4.17.10 - [mkdirp](https://npm.io/package/mkdirp.md) ^0.5.1 - [postcss](https://npm.io/package/postcss.md) ^7.0.27 - [unified](https://npm.io/package/unified.md) ^8.4.2 - [fs-extra](https://npm.io/package/fs-extra.md) ^8.1.0 - [p-reduce](https://npm.io/package/p-reduce.md) ^2.1.0 - [regexgen](https://npm.io/package/regexgen.md) ^1.3.0 - [commander](https://npm.io/package/commander.md) ^4.1.1 - [fast-glob](https://npm.io/package/fast-glob.md) ^3.2.2 - [superagent](https://npm.io/package/superagent.md) ^5.2.2 - [cosmiconfig](https://npm.io/package/cosmiconfig.md) ^6.0.0 - [@babel/types](https://npm.io/package/@babel/types.md) ^7.7.4 - [@babel/parser](https://npm.io/package/@babel/parser.md) ^7.5.5 - [recursive-copy](https://npm.io/package/recursive-copy.md) ^2.0.10 - [@babel/traverse](https://npm.io/package/@babel/traverse.md) ^7.5.5 - [single-line-log](https://npm.io/package/single-line-log.md) ^1.1.2 - [@babel/generator](https://npm.io/package/@babel/generator.md) ^7.8.7 - [dependency-graph](https://npm.io/package/dependency-graph.md) ^0.9.0 - [stricter-htmlparser2](https://npm.io/package/stricter-htmlparser2.md) ^3.9.6 ## Recent versions - 1.1.0 (latest) — 2021-04-28 - 1.0.20 — 2021-04-28 - 1.0.19 — 2021-02-01 - 1.0.18 — 2020-12-10 - 1.0.17 — 2020-11-19 - 1.0.3 — 2020-08-26 - 1.0.2 — 2020-06-09 - 1.0.1 — 2020-04-01 ## README # 项目名称 wx2，微信小程序转换工具 基于已有的原生微信小程序项目，提供零成本平移转换的能力，对小程序间差异进行抹平，提供简单快捷的 API，助力开发者快速互转已有小程序项目。 * 工具会帮你将已有的原生微信小程序转换为目标小程序，目前支持度最好的为百度小程序，其他小程序的能力正在补充中。 * 工具虽然不能完成100%的转换，但可以帮你节省大量的重复开发成本，随着迭代优化，未来转换率会越来越高 * 目前只支持转`百度小程序`，后续支持QQ、支付宝、头条等小程序 ## 快速开始 ### 安装 ``` $ npm i wx2 -g ``` ### 使用 切换到自己指定的工作目录，执行全局命令`wx2`，并指定转换`目录路径`，和输出`目录路径` ```bash // 当前只支持百度小程序，其他小程序后续支持 $ wx2 <微信小程序文件夹> <目标小程序文件夹> ``` > 注： 路径中请包含'/'作为路径标识 ### 运行及参数 使用命令行参数`--target`，简写`-t` ``` # 默认，百度小程序 $ wx2 <微信小程序文件夹> <目标小程序文件夹> --target=swan # 二次迭代 $ wx2 <微信小程序文件夹> <目标小程序文件夹> --target=wx # 当前版本暂不支持，qq小程序 $ wx2 <微信小程序文件夹> <目标小程序文件夹> --target=qq ``` #### 日志输出 ``` // 第三个参数为生成日志的文件夹地址 $ wx2 <微信小程序文件夹> <目标小程序文件夹> <生成日志的文件夹> -t ``` #### 自定义转换 ``` // 第四个参数为生成日志的自定义规则地址 $ wx2 <微信小程序文件夹> <目标小程序文件夹> <生成日志的文件夹> <自定义规则地址> -t ``` 自定义规则使用方法： 1、新建自定义规则文件夹（文件夹名自定义），在文件夹下新建wx2.json文件，内部对象用于处理css,js,component,json,view等内置规则，示例如下: ``` { "view": { "backets": [ "s-if", "s-elif", "s-for" ] }, "component": { "beviors": { "swan://form-field": { "mapping": "wx://form-field" } } }, "js": {} "json": { "app.json": ["prefetches"] }, "css": {} } ``` 2、自定义对API处理的插件 创建过程：需要在自定义规则文件夹下新建api文件夹，并在api下新建plugins文件夹，形如/api/plugins/（代码块的类型）/xxx.js 代码块类型包括以下: 'MemberExpression', 'CallExpression', 'ObjectProperty', 'StringLiteral', 'ExpressionStatement', 'ObjectMethod', 'ImportDeclaration', 'VariableDeclaration' ## 测试 ### 测试方法 项目通过jest工具进行单元测试，包括测试结果和测试覆盖率。 ``` // 单元测试 npm run jest ``` ## 文档 详细文档参见技术官网：https://pan.baidu.com/union/wx2/home#/ ## 维护者 owners: * gaofei12@baidu.com committers: * zhouyixuan01@baidu.com * xujie07@baidu.com * wulinfei@baidu.com * zhanyongdong@baidu.com * dengxiaohong01@baidu.com * lijiaxuan02@baidu.com * wangshiyuan@baidu.com * lijinling03@baidu.com * zhangyatao@baidu.com ## 反馈 issues贡献： 如在使用中遇到问题，请在 https://github.com/baidu/wx2/issues 新建 issues 反馈问题。 ## 讨论 微信扫描二维码，欢迎加入wx2技术交流群(添加下列管理员微信，并备注“wx2”，管理员会邀请您入群)： lijinling03 gaofei12 xujie07 zhouyixuan01 互转工具百度如流讨论群：3498775 ## 版本更新（npm） * 1.0.18 支持了微信小程序代码直接对wx赋值或引用的转换情况。 * 1.0.19 修复了setClipboardData转换问题。 * 1.0.20 增加LICENSE;支持用户能自定义转换规则，用法见上 ”自定义转换“ 部分。 --- _Source: https://npm.io/package/wx2 · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._