饿了么开源自研多端框架 MorJS

[hwaphon]

开源项目地址：https://github.com/eleme/morjs，欢迎试用 ~

喜欢么？或者对您有用？ ☞ 立即去 ⭐️ Star ⭐️ 一下 ☞

MorJS 是什么？

简介

Mor (发音为 /mɔːr/，类似 more) 是饿了么开发的一款 基于小程序 DSL 的，可扩展的多端研发框架。

使用 MorJS ，我们只需书写一套（微信或支付宝）小程序，就可以通过 MorJS 的转端编译能力，将源码分别编译出可以发布在不同端（微信 /支付宝 /百度 /字节 /钉钉 /快手 /QQ/淘宝 /H5 ）的产物。MorJS 还支持小程序、小程序插件、小程序分包之间的形态转换，同时也配备了从源码到构建产物全阶段的插件体系，满足各类功能扩展，提升开发体验和开发效率。

示例

以下是饿了么-美食外卖频道在微信、支付宝、抖音小程序及 H5 中的表现：

为什么要做 MorJS ？

目前各大平台都相继推出了自己的小程序，饿了么 C 端业务需要在不同平台小程序进行投放，这些项目大多是以支付宝或微信原生 DSL 编写，面对业务渠道的不断增加，我们尝试了多种方法来兼容多端适配，但由于不同平台间小程序代码写法、能力支持的差异性逐步变大，过去的方案无法满足新业务的需求，我们需要一套跨端研发框架能解决以下诉求：

• 原生 DSL 支持，方便现有小程序 DSL 编写的存量业务使用；
• 降低性能开销，尽可能轻运行时，减少编译构建的时长；
• 便捷的使用，一键转换为支持各小程序平台使用的产物；
• 拓展的功能，提供针对大型复杂小程序的解耦方案；
• 灵活的配置，能够简单的增加修改多套不同端的项目配置；
• 产物优化能力，压缩构建产物体积，减少小程序包大小；

在明确这几点后，我们调研了业界所有主流技术框架，发现并没有能完全满足我们需求的方案，所以我们决定自研 MorJS 。

如何使用？

MorJS 是基于小程序原生 DSL 进行扩展的，只要你掌握微信或支付宝任意一种小程序，那你就几乎掌握了 MorJS 。

MorJS 提供了官方脚手架工具用于创建新项目，同时也支持已有小程序引入相关依赖接入 MorJS 。

开始一个新项目

MorJS 项目示例：https://github.com/eleme/morjs/tree/main/examples

1. 创建项目，选定项目目录，在目录终端执行以下任一命令：

$ npm init mor # npm 创建项目
$ yarn create mor # yarn 创建项目
$ pnpm create mor # pnpm 创建项目

1. 选择对应的工程类型，按照提示完成初始化操作

✔ 请选择工程类型 › 小程序
✔ 请选择源码类型 › 微信小程序 DSL
✔ 是否使用 Typescript … 否 / 是
✔ 请选择 CSS 预处理器 › less
✔ 请输入 小程序 的名称 … myapp
✔ 请输入 小程序 的描述 … my first app
✔ 用户名 … yourUserName
✔ 邮箱 … [email protected]
✔ 请输入 Git 仓库地址 … https://github.com/yourUserName/myapp
✔ 请选择 npm 客户端 › npm / pnpm / yarn
…

1. 执行编译命令启动项目：

$ npm run dev

1. 多端产物已构建在 dist 目录下，分别用对应平台的 IDE 打开即可开发预览

已有小程序项目接入

1. 在已有项目中添加必要的依赖：

$ npm i @morjs/cli -D && npm i @morjs/core --save

1. 在项目根目录下增加配置文件 mor.config.ts

import { defineConfig } from '@morjs/cli'

export default defineConfig([
  // 第一套配置: 微信 DSL 编译
  {
    name: 'wx',
    sourceType: 'wechat', // 源码类型: 微信 DSL
    target: 'wechat', // 编译目标: 微信
    compileMode: 'bundle', // 编译模式: 打包模式
  },
  // 第二套配置: 微信转支付宝
  {
    name: 'ali',
    sourceType: 'wechat', // 源码类型: 微信 DSL
    target: 'alipay', // 编译目标: 支付宝
    compileMode: 'bundle', // 编译模式: 打包模式
  },
  // 第三套配置: 微信转 Web
  {
    name: 'web',
    sourceType: 'wechat', // 源码类型: 微信 DSL
    target: 'web', // 编译目标: Web
    compileMode: 'bundle', // 编译模式: 打包模式
  }
])

1. 在 package.json 中配置脚本：

{
  "scripts": {
+   "dev": "mor compile -w",
+   "build": "mor compile --production"
  }
}

1. 在项目目录终端下执行编译命令启动项目：

$ npm run dev

1. 多端产物已构建在 dist 目录下，分别用对应平台的 IDE 打开即可开发预览。

MorJS 核心能力

多端编译：提供一码多端转换能力

从诞生之初，MorJS 的一个核心能力就是实现小程序一码多端的转换，让一套代码经过编译后对应的各端产物，分别在多个小程序平台上运行，让开发成本，招聘、管理、测试各方面成本都大幅下降。截止到目前，我们已经支持多数小程序平台的转换。

如果你对多端编译的实现感兴趣，可参见文档《 MorJS 如何工作》

集成研发：提供复杂小程序解耦开发能力

随着业务需求的不断增加，很多小程序项目不可避免的会出现体积巨大化的问题。虽然小程序官方提供了小程序分包、小程序插件的解决方案，但基于同一个小程序代码库，众多分包、插件的迭代情况复杂，实际业务难以解耦。如果你的项目遇到类似的问题，可以使用 MorJS 提供的集成研发能力，把各个分包、插件、模块分成一个个独立的项目，并通过集成研发将小程序宿主和这些子模块通过拉包、编译、构建、合并等一系列处理，合并为一个完整小程序进行开发、调试和部署。

如果你对集成研发的实现感兴趣，可参见文档《复杂小程序集成》

形态互转：提供小程序多形态转换能力

（如果你的项目没有类似诉求可以跳过本段内容）随着投放场景的增加，不同业务在不同小程序端的形态可能并不相同。例如一个在支付宝端的小程序应用，在某些场景下希望他以分包的形式接入到微信小程序中。于是让项目在独立小程序、小程序插件、小程序分包应用形态间互相转换成为一个难题。

MorJS 提供的形态一体化能力，可以在尽量减少业务代码修改的前提下，提供同一个项目在以不同端（微信、支付宝、淘宝、抖音等）不同形态（小程序、小程序插件、小程序分包）间的转换能力。

如果你对形态一体化的实现感兴趣，可参见文档《小程序形态一体化》

H5 同构：提供小程序 DSL 转 H5 能力

除了多端多形态的小程序外，不少开发者还面临着 H5 场景的投放。对此，MorJS 提供将小程序项目转换为 Web 项目的能力。这一能力的核心是将小程序转换成一个基于 React 的项目产物。无论是整个工程项目的转码、或是单个组件的编译，MorJS 都能够支持。

如果你对转 Web 开发的实现感兴趣，可参见文档《 MorJS Web 开发》

其他

除此上述核心能力外，MorJS 围绕小程序实现了一系列研发生态能力的建设，包括但不限于以下：

• 条件编译：提供对于多端或不同环境构建产出不同代码的能力，更加灵活的解决不同场景的适配问题；
• 产物压缩：提供了不同类型文件的最小化兼容压缩方式，并保留配置选项对高级压缩方案的扩展支持；
• Mock 能力：提供小程序本地 JSAPI mock 能力，解决开发阶段无法联调接口请求数据的痛点；
• …

优势与现状

MorJS 的优势

如你所见，MorJS 是一套基于小程序 DSL (支付宝或微信) 的框架。他的易用性、标准化和灵活性，使得开发者能更好地专注于业务，降低研发、调试成本，提高开发者的工作效率。

使用现状

截止目前，MorJS 支持 4 种编译形态（小程序、小程序插件、小程序分包、H5 ），支撑了饿了么 C 端大多数业务在各个渠道上的研发和投放。通过 MorJS 的开源，我们期望能把其中的技术细节、架构设计和技术思考呈现给大家，为有类似多端同构需求的企业和开发者服务。

结语

MorJS 为饿了么解决了大量业务在多端研发上的差异问题，让小程序开发的重心回到产品业务本身，减少使用者对多端差异兼容的投入，在通过开源让大家更好地了解和使用这项技术的同时，我们也希望能够借此吸引到更多志趣相投的小伙伴参与共建，一起加速小程序一码多端能力的发展。欢迎广大小程序开发者们与我们交流。

以上是对 MorJS 的简单介绍，如果想要详细了解可通过下述方式：

• GitHub：https://github.com/eleme/morjs
• 官网地址：https://mor.eleme.io/

如果在使用 MorJS 中遇到问题，欢迎加入 MorJS 社区服务钉钉群 反馈&交流。

官网迁移至： https://mor.ele.me/

[hwaphon]

牛啊

[ZakiLiu]

刚开源的时候用过，用来给原生小程序项目做转端确实还可以，社群解决问题也挺积极的，看看后续维护情况咋样

[Ashore]

啥时候像腾讯似的，再把小程序转成 app

[bojackhorseman]

已 star ，准备试试把微信小程序转 h5 看看，结果发现 issue 说还不支持`model:value`，遂放弃。

[LeegoYih]

开发各种小程序心好累，要是小程序有统一标准规范就好了

[psklf]

提个问题：
现在 GooglePlay 版本的支付宝有 webview 的 bug ，现在进 eleme 小程序只会提示版本过低，能否再饿了么端规避这个问题？

（前提当然是支付宝技术落后垃圾，不适配最新的 webview

[psklf]

这是支付宝进入的截图：

[LimboRunner]

国产开源最大的问题就是：它们都是 KPI 产物，一旦公司领导觉得开发这个是浪费钱，这个项目就死了。

所以没兴趣用。

[hwaphon]

@Ashore 😂

[hwaphon]

@psklf #6 是不是 google play 上的支付宝版本太低了？

[hwaphon]

@LeegoYih 确实，这样也不用折腾各种框架了。

[yangzzzzzz]

狼来了（狗头

[Desiree]

很浓的 KPI 项目味道

[psklf]

@hwaphon #10 也不能算是这个问题，是因为 webview 的问题，在原生系统使用的是系统的 webview 与支付宝的不兼容导致的。

所以我说这个锅是属于支付宝的，只是支付宝店大欺客，不思进取，所以问问能不能从你们端来修改。你们既然做的是跨平台统一的小程序引擎，讲道理把 android 原生 webview 兼容一下子也不难吧？

[hwaphon]

@bojackhorseman https://github.com/eleme/morjs/releases/tag/v1.0.49 最新版本已经支持 model:value 语法，欢迎试用~