当前文档对应 qiankun 3.0(RC),安装请使用 npm i qiankun@rc;2.x 文档见 v2 站点
Skip to content

qiankun · 微前端运行时独立交付,按需组合

使用 loadMicroApp,可将不同团队、不同技术栈的前端应用挂载到页面中的指定区域;各应用均可独立开发和发布。

主应用在运行时组合多个独立交付的微应用

管理单个微应用实例

在主应用中安装 qiankun:

bash
npm install qiankun@rc

v3 目前发布在 rc 标签上

qiankun 3.0 仍处于 RC 阶段,npm 的 latest 标签指向的仍是 2.x。安装时需显式指定 @rc 才能获得 v3。

容器创建后即可加载微应用。记得保存返回的实例句柄,后续查询状态、卸载实例都要靠它:

ts
import { loadMicroApp } from 'qiankun';

const container = document.getElementById('micro-app-slot');
if (!container) throw new Error('micro-app-slot not found');

const microApp = loadMicroApp({
  name: 'orders',
  entry: '//localhost:7101',
  container,
});

await microApp.mountPromise;

// 页面区域销毁前卸载微应用
await microApp.unmount();

微应用需要导出 bootstrapmountunmount。qiankun 会将其加载到指定的 HTMLElement 中,并调用相应的生命周期函数。快速上手提供了完整的可运行示例。

如果微应用的激活状态完全取决于当前 URL,可使用基于路由的 registerMicroAppsstart

仓库中的示例应用(两个主应用加载同一组微应用)已部署在 examples.qiankunjs.com,可直接在线体验。

基于 MIT 协议发布