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

2023-05-26 10:48:18 +08:00
 hwaphon

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

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

MorJS 是什么?

简介

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

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

示例

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

为什么要做 MorJS ?

目前各大平台都相继推出了自己的小程序,饿了么 C 端业务需要在不同平台小程序进行投放,这些项目大多是以支付宝或微信原生 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
✔ 邮箱 … your@gmail.com
✔ 请输入 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 围绕小程序实现了一系列研发生态能力的建设,包括但不限于以下:

优势与现状

MorJS 的优势

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

使用现状

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

结语

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

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

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

2500 次点击
所在节点    开源软件
15 条回复
hwaphon
2023-05-26 10:49:34 +08:00
牛啊
ZakiLiu
2023-05-26 10:52:15 +08:00
刚开源的时候用过,用来给原生小程序项目做转端确实还可以,社群解决问题也挺积极的,看看后续维护情况咋样
Ashore
2023-05-26 11:12:21 +08:00
啥时候像腾讯似的,再把小程序转成 app
bojackhorseman
2023-05-26 11:53:02 +08:00
已 star ,准备试试把微信小程序转 h5 看看,结果发现 issue 说还不支持`model:value`,遂放弃。
LeegoYih
2023-05-26 12:15:26 +08:00
开发各种小程序心好累,要是小程序有统一标准规范就好了
psklf
2023-05-26 13:02:56 +08:00
提个问题:
现在 GooglePlay 版本的支付宝有 webview 的 bug ,现在进 eleme 小程序只会提示版本过低,能否再饿了么端规避这个问题?

(前提当然是支付宝技术落后垃圾,不适配最新的 webview
psklf
2023-05-26 13:06:38 +08:00
这是支付宝进入的截图:

LimboRunner
2023-05-26 13:08:52 +08:00
国产开源最大的问题就是:它们都是 KPI 产物,一旦公司领导觉得开发这个是浪费钱,这个项目就死了。

所以没兴趣用。
hwaphon
2023-05-26 13:44:03 +08:00
@Ashore 😂
hwaphon
2023-05-26 13:44:49 +08:00
@psklf #6 是不是 google play 上的支付宝版本太低了?
hwaphon
2023-05-26 13:45:39 +08:00
@LeegoYih 确实,这样也不用折腾各种框架了。
yangzzzzzz
2023-05-26 16:11:37 +08:00
狼来了(狗头
Desiree
2023-05-26 16:29:24 +08:00
很浓的 KPI 项目味道
psklf
2023-05-29 09:52:40 +08:00
@hwaphon #10 也不能算是这个问题,是因为 webview 的问题,在原生系统使用的是系统的 webview 与支付宝的不兼容导致的。

所以我说这个锅是属于支付宝的,只是支付宝店大欺客,不思进取,所以问问能不能从你们端来修改。你们既然做的是跨平台统一的小程序引擎,讲道理把 android 原生 webview 兼容一下子也不难吧?
hwaphon
2023-05-30 20:02:43 +08:00
@bojackhorseman https://github.com/eleme/morjs/releases/tag/v1.0.49 最新版本已经支持 model:value 语法,欢迎试用~

这是一个专为移动设备优化的页面(即为了让你能够在 Google 搜索结果里秒开这个页面),如果你希望参与 V2EX 社区的讨论,你可以继续到 V2EX 上打开本讨论主题的完整版本。

https://www.v2ex.com/t/943109

V2EX 是创意工作者们的社区,是一个分享自己正在做的有趣事物、交流想法,可以遇见新朋友甚至新机会的地方。

V2EX is a community of developers, designers and creative people.

© 2021 V2EX