跳到主要内容

介绍

简介

酷家乐历来都坚持开放,我们相信联合全行业力量,是促进整个行业发展的最好的方式。在这个理念的驱动下,酷家乐对开发者生态的战略进行了全面的升级,推出了商家后台小程序(以下简称小程序)的整体解决方案。通过小程序,酷家乐将联合更多伙伴,将众多现有的、新的产品功能以小程序的方式集成到酷家乐这个平台上,共同为行业提供服务。

在用户界面上,小程序自己的 UI 会作为一个窗口或页面的一部分运行在商家后台页面内。

小程序本身大体可分为两部分,VM 和 Iframe

  • VM 指虚拟机。这部分代码可以同步访问商家后台小程序提供的 API。

  • Iframe 部分相当于一个普通的浏览器页面,Iframe 页面有与酷家乐不同的单独的域名。在页面中运行着小程序的交互界面。页面中引入 @manycore/miniapp-sdk SDK 包后可以直接异步访问商家后台小程序提供的接口。此外,在页面中也可以正常地使用浏览器 API,例如访问文件、发起网络请求等。

商家后台目前同时支持两类小程序开发模式:

  • Iframe 小程序(推荐)。无 VM ,支持在 Iframe 页面中直接异步调用商家后台小程序提供的接口,支持多个小程序同时运行。

  • VM 小程序(Iframe + VM),同酷家乐设计工具小程序。

小程序结构

sequenceDiagram
participant A as 小程序页面
participant B as 小程序代码
participant C as Iframe 容器
participant D as 运行时虚拟机
participant E as 小程序容器
participant F as 酷家乐App

A->>B: Message
B->>A: Message
C->>A: Hosting
B->>D: API同步调用
D->>B: API注入
E->>D: SDK接口注入
E->>C: Hosting
A->>F: API异步调用(须引入 "@manycore/miniapp-sdk" SDK)
F->>E: SDK接口注入

典型场景

FOP 订单管理

img

利用「业务接口调用」、「界面自定义」的能力,开发者可以根据自己的需要,开发一个定制版的订单管理小程序