From b548b839ec6d214b8b47b15d71fed99957e3e349 Mon Sep 17 00:00:00 2001 From: "zhouxiao.shaw" Date: Sat, 2 Nov 2024 05:31:12 +0800 Subject: [PATCH] docs: init new doc --- website-new/.gitignore | 25 + website-new/docs/_meta.json | 22 + website-new/docs/api/__meta__.md | 5 + website-new/docs/api/_meta.json | 1 + website-new/docs/api/channel.mdx | 40 ++ website-new/docs/api/clearEscapeEffect.md | 16 + website-new/docs/api/getGlobal.mdx | 31 ++ website-new/docs/api/index.md | 27 + website-new/docs/api/loadApp.mdx | 303 ++++++++++ website-new/docs/api/loader.mdx | 79 +++ website-new/docs/api/preloadApp.mdx | 45 ++ website-new/docs/api/registerApp.mdx | 187 +++++++ website-new/docs/api/router.mdx | 272 +++++++++ website-new/docs/api/run.mdx | 208 +++++++ website-new/docs/api/setExternal.md | 73 +++ website-new/docs/api/setGlobal.md | 24 + website-new/docs/api/setOptioins.md | 30 + website-new/docs/blog/__meta__.md | 5 + website-new/docs/blog/_meta.json | 1 + website-new/docs/blog/architecture.md | 440 +++++++++++++++ website-new/docs/blog/hmr.md | 295 ++++++++++ website-new/docs/blog/sourcemap.md | 130 +++++ website-new/docs/guide/API/loadApp.md | 253 +++++++++ website-new/docs/guide/_meta.json | 30 + website-new/docs/guide/advance/__meta__.md | 5 + website-new/docs/guide/advance/_meta.json | 1 + website-new/docs/guide/advance/nested.md | 53 ++ website-new/docs/guide/advance/plugins.mdx | 306 ++++++++++ website-new/docs/guide/concept/_meta.json | 1 + website-new/docs/guide/concept/bridge.mdx | 434 +++++++++++++++ website-new/docs/guide/concept/buildConfig.md | 73 +++ website-new/docs/guide/concept/cache.md | 86 +++ website-new/docs/guide/concept/lifecycle.md | 53 ++ website-new/docs/guide/concept/router.md | 31 ++ website-new/docs/guide/concept/sandbox.md | 503 +++++++++++++++++ website-new/docs/guide/demo/_meta.json | 1 + website-new/docs/guide/demo/angular.mdx | 182 ++++++ website-new/docs/guide/demo/demo.md | 16 + website-new/docs/guide/demo/react.mdx | 195 +++++++ website-new/docs/guide/demo/vite.mdx | 127 +++++ website-new/docs/guide/demo/vue.mdx | 311 +++++++++++ website-new/docs/guide/quick-start/_meta.json | 1 + website-new/docs/guide/quick-start/env.md | 36 ++ website-new/docs/guide/quick-start/index.md | 56 ++ website-new/docs/guide/quick-start/start.md | 200 +++++++ website-new/docs/hello.md | 5 + website-new/docs/index.md | 28 + website-new/docs/issues/_meta.json | 1 + website-new/docs/issues/index.mdx | 523 ++++++++++++++++++ website-new/docs/issues/webComponent.md | 241 ++++++++ website-new/docs/plugins/__meta__.md | 5 + website-new/docs/plugins/es-module.md | 7 + website-new/docs/plugins/plugins.md | 7 + website-new/docs/public/rspress-dark-logo.png | Bin 0 -> 6296 bytes website-new/docs/public/rspress-icon.png | Bin 0 -> 102713 bytes .../docs/public/rspress-light-logo.png | Bin 0 -> 6379 bytes website-new/package.json | 16 + website-new/rspress.config.ts | 31 ++ website-new/src/components/Highlight/index.js | 16 + .../src/components/TeamProfileCards/index.jsx | 76 +++ .../src/components/config/_basename.mdx | 8 + .../src/components/config/_domGetter.mdx | 16 + .../components/config/_insulationVariable.mdx | 10 + .../components/config/_protectVariable.mdx | 6 + .../src/components/config/_sandbox.mdx | 75 +++ .../src/components/config/_viteConfig.mdx | 20 + .../src/components/config/_webpackConfig.mdx | 46 ++ .../src/components/lifeCycle/_afterEval.mdx | 21 + .../src/components/lifeCycle/_afterLoad.mdx | 19 + .../src/components/lifeCycle/_afterMount.mdx | 22 + .../components/lifeCycle/_afterUnmount.mdx | 8 + .../src/components/lifeCycle/_beforeEval.mdx | 23 + .../src/components/lifeCycle/_beforeLoad.mdx | 20 + .../src/components/lifeCycle/_beforeMount.mdx | 23 + .../components/lifeCycle/_beforeUnmount.mdx | 11 + .../components/lifeCycle/_errorLoadApp.mdx | 21 + .../components/lifeCycle/_errorMountApp.mdx | 21 + .../components/lifeCycle/_errorUnmountApp.mdx | 20 + .../lifeCycle/_onNotMatchRouter.mdx | 19 + .../src/components/sumarryImg/index.jsx | 12 + website-new/tsconfig.json | 20 + 81 files changed, 6610 insertions(+) create mode 100644 website-new/.gitignore create mode 100644 website-new/docs/_meta.json create mode 100644 website-new/docs/api/__meta__.md create mode 100644 website-new/docs/api/_meta.json create mode 100644 website-new/docs/api/channel.mdx create mode 100644 website-new/docs/api/clearEscapeEffect.md create mode 100644 website-new/docs/api/getGlobal.mdx create mode 100644 website-new/docs/api/index.md create mode 100644 website-new/docs/api/loadApp.mdx create mode 100644 website-new/docs/api/loader.mdx create mode 100644 website-new/docs/api/preloadApp.mdx create mode 100644 website-new/docs/api/registerApp.mdx create mode 100644 website-new/docs/api/router.mdx create mode 100644 website-new/docs/api/run.mdx create mode 100644 website-new/docs/api/setExternal.md create mode 100644 website-new/docs/api/setGlobal.md create mode 100644 website-new/docs/api/setOptioins.md create mode 100644 website-new/docs/blog/__meta__.md create mode 100644 website-new/docs/blog/_meta.json create mode 100644 website-new/docs/blog/architecture.md create mode 100644 website-new/docs/blog/hmr.md create mode 100644 website-new/docs/blog/sourcemap.md create mode 100644 website-new/docs/guide/API/loadApp.md create mode 100644 website-new/docs/guide/_meta.json create mode 100644 website-new/docs/guide/advance/__meta__.md create mode 100644 website-new/docs/guide/advance/_meta.json create mode 100644 website-new/docs/guide/advance/nested.md create mode 100644 website-new/docs/guide/advance/plugins.mdx create mode 100644 website-new/docs/guide/concept/_meta.json create mode 100644 website-new/docs/guide/concept/bridge.mdx create mode 100644 website-new/docs/guide/concept/buildConfig.md create mode 100644 website-new/docs/guide/concept/cache.md create mode 100644 website-new/docs/guide/concept/lifecycle.md create mode 100644 website-new/docs/guide/concept/router.md create mode 100644 website-new/docs/guide/concept/sandbox.md create mode 100644 website-new/docs/guide/demo/_meta.json create mode 100644 website-new/docs/guide/demo/angular.mdx create mode 100644 website-new/docs/guide/demo/demo.md create mode 100644 website-new/docs/guide/demo/react.mdx create mode 100644 website-new/docs/guide/demo/vite.mdx create mode 100644 website-new/docs/guide/demo/vue.mdx create mode 100644 website-new/docs/guide/quick-start/_meta.json create mode 100644 website-new/docs/guide/quick-start/env.md create mode 100644 website-new/docs/guide/quick-start/index.md create mode 100644 website-new/docs/guide/quick-start/start.md create mode 100644 website-new/docs/hello.md create mode 100644 website-new/docs/index.md create mode 100644 website-new/docs/issues/_meta.json create mode 100644 website-new/docs/issues/index.mdx create mode 100644 website-new/docs/issues/webComponent.md create mode 100644 website-new/docs/plugins/__meta__.md create mode 100644 website-new/docs/plugins/es-module.md create mode 100644 website-new/docs/plugins/plugins.md create mode 100644 website-new/docs/public/rspress-dark-logo.png create mode 100644 website-new/docs/public/rspress-icon.png create mode 100644 website-new/docs/public/rspress-light-logo.png create mode 100644 website-new/package.json create mode 100644 website-new/rspress.config.ts create mode 100644 website-new/src/components/Highlight/index.js create mode 100644 website-new/src/components/TeamProfileCards/index.jsx create mode 100644 website-new/src/components/config/_basename.mdx create mode 100644 website-new/src/components/config/_domGetter.mdx create mode 100644 website-new/src/components/config/_insulationVariable.mdx create mode 100644 website-new/src/components/config/_protectVariable.mdx create mode 100644 website-new/src/components/config/_sandbox.mdx create mode 100644 website-new/src/components/config/_viteConfig.mdx create mode 100644 website-new/src/components/config/_webpackConfig.mdx create mode 100644 website-new/src/components/lifeCycle/_afterEval.mdx create mode 100644 website-new/src/components/lifeCycle/_afterLoad.mdx create mode 100644 website-new/src/components/lifeCycle/_afterMount.mdx create mode 100644 website-new/src/components/lifeCycle/_afterUnmount.mdx create mode 100644 website-new/src/components/lifeCycle/_beforeEval.mdx create mode 100644 website-new/src/components/lifeCycle/_beforeLoad.mdx create mode 100644 website-new/src/components/lifeCycle/_beforeMount.mdx create mode 100644 website-new/src/components/lifeCycle/_beforeUnmount.mdx create mode 100644 website-new/src/components/lifeCycle/_errorLoadApp.mdx create mode 100644 website-new/src/components/lifeCycle/_errorMountApp.mdx create mode 100644 website-new/src/components/lifeCycle/_errorUnmountApp.mdx create mode 100644 website-new/src/components/lifeCycle/_onNotMatchRouter.mdx create mode 100644 website-new/src/components/sumarryImg/index.jsx create mode 100644 website-new/tsconfig.json diff --git a/website-new/.gitignore b/website-new/.gitignore new file mode 100644 index 000000000..044373fb2 --- /dev/null +++ b/website-new/.gitignore @@ -0,0 +1,25 @@ +# Logs +logs +*.log +npm-debug.log* +yarn-debug.log* +yarn-error.log* +pnpm-debug.log* +lerna-debug.log* + +node_modules +dist +dist-ssr +*.local + +# Editor directories and files +.vscode/* +!.vscode/extensions.json +.idea +.DS_Store +*.suo +*.ntvs* +*.njsproj +*.sln +*.sw? +doc_build diff --git a/website-new/docs/_meta.json b/website-new/docs/_meta.json new file mode 100644 index 000000000..5dce1191c --- /dev/null +++ b/website-new/docs/_meta.json @@ -0,0 +1,22 @@ +[ + { + "text": "指南", + "link": "/guide/quick-start/", + "activeMatch": "/guide/" + }, + { + "text": "API", + "link": "/api/index", + "activeMatch": "/api/" + }, + { + "text": "博客", + "link": "/blog/architecture", + "activeMatch": "/blog/" + }, + { + "text": "常见问题", + "link": "/issues/index", + "activeMatch": "/issues/" + } +] diff --git a/website-new/docs/api/__meta__.md b/website-new/docs/api/__meta__.md new file mode 100644 index 000000000..6d7eff77b --- /dev/null +++ b/website-new/docs/api/__meta__.md @@ -0,0 +1,5 @@ +--- +title: API +collapsed: false +order: 4 +--- diff --git a/website-new/docs/api/_meta.json b/website-new/docs/api/_meta.json new file mode 100644 index 000000000..d1735c939 --- /dev/null +++ b/website-new/docs/api/_meta.json @@ -0,0 +1 @@ +["index", "run", "registerApp", "loadApp", "loader", "preloadApp", "channel", "router", "setOptioins", "setExternal", "setGlobal", "clearEscapeEffect"] diff --git a/website-new/docs/api/channel.mdx b/website-new/docs/api/channel.mdx new file mode 100644 index 000000000..124178ff0 --- /dev/null +++ b/website-new/docs/api/channel.mdx @@ -0,0 +1,40 @@ +# Garfish.channel + +import Highlight from '@components/Highlight'; + +用于应用间的通信，`Garfish.channel` 为 Garfish 的实例属性，该属性是 [EventEmitter2](https://github.com/EventEmitter2/EventEmitter2) 的实例。 + +### Type + +```ts +channel: EventEmitter2; +``` + +### 默认值 + +- 无 + +### 示例 + +```js +// 子应用监听登录事件 +const App = () => { + const handleLogin = (userInfo) => { + console.log(`${userInfo.name} has login`); + }; + + useEffect(() => { + window?.Garfish.channel.on('login', handleLogin); + return () => { + window?.Garfish.channel.removeListener('login', handleLogin); + }; + }); +}; + +// 主应用触发监听事件 +api.getLoginInfo().then((res) => { + if (res.code === 0) { + window.Garfish.channel.emit('login', res.data); + } +}); +``` diff --git a/website-new/docs/api/clearEscapeEffect.md b/website-new/docs/api/clearEscapeEffect.md new file mode 100644 index 000000000..539815972 --- /dev/null +++ b/website-new/docs/api/clearEscapeEffect.md @@ -0,0 +1,16 @@ +# Garfish.clearEscapeEffect + +用来清除逃逸沙箱的变量。 + +> 在微前端应用下，子应用将默认开启沙箱模式。在沙箱模式下，若发现有一些特殊的行为会逃逸沙箱系统，可以使用此方法来清除逃逸的变量； + +## Type +```ts +clearEscapeEffect: (key: string, value?: any) => void; +``` + +## 示例 + +```js +Garfish.clearEscapeEffect('webpackJsonp'); +``` diff --git a/website-new/docs/api/getGlobal.mdx b/website-new/docs/api/getGlobal.mdx new file mode 100644 index 000000000..fd135d1a7 --- /dev/null +++ b/website-new/docs/api/getGlobal.mdx @@ -0,0 +1,31 @@ +# Garfish.getGlobalObject + + +import Highlight from '@components/Highlight'; + +用于子应用获取真实 window 的值。 + +> 在微前端应用下，子应用将默认开启沙箱模式。在沙箱模式下，子应用中全局变量为被 proxy 的 'fakeWindow'，而全局变量（真实 window）默认会被隔离。若子应用需求获取真实 window 的值，可以通过此方法获取。 + + + +:::tip +1. 一般情况下我们不建议直接通过此 API 获取真实 window，这样建议的原因是： + - 使用此 API 后子应用产生了一个无法独立运行的逻辑，导致子应用失去独立运行的能力； + - 由于环境变量的修改并不是单向数据流，造成主应用无法感知哪些子应用会去修改 window 上的哪些变量，可能造成数据管理的混乱； + +2. 若需要获取真实 window 上的环境变量，可通过 [`protectVariable`](/api/run#protectvariable) 属性，将需要共享的属性放入列表中即可通过子应用的全局变量获取，这样主应用能感知到哪些值是会被修改的，哪些值是不会被修改的，能在一定程度上控制 `window` 变量的修改； + +::: + +## Type +```ts +getGlobalObject: () => Window & typeof globalThis; +``` +## 示例 + +```js +import Garfish from 'garfish'; + +const nativeWindow = Garfish.getGlobalObject(); +``` diff --git a/website-new/docs/api/index.md b/website-new/docs/api/index.md new file mode 100644 index 000000000..b5ce0b4b8 --- /dev/null +++ b/website-new/docs/api/index.md @@ -0,0 +1,27 @@ +# 概览 + +```ts +import Garfish from "garfish"; +``` +在主应用中，我们通过 `import Garfish from "garfish";` 来引入 Garfish，并调用相关 Garfish api 去注册子应用或运行微前端应用。 + +其中，Garfish 是 `garfish` 包默认导出的实例，实例上包含微前端相关API，用户可以通过相应 API 完成对整个微前端应用的管理。 + + +:::tip +这里需要特殊说明的是，子应用不需要额外引入 Garfish 实例，子应用可通过 `window.Garfish` 获取全局 Garfish 实例信息，参考 [Garfish 环境变量](../guide/quickStart/env.md)。 + + +::: + + +## Garfish 实例方法 +- [Garfish.run](/api/run) （用于初始化应用参数、启动路由监听，当路由发生变化时自动激活应用或销毁应用） +- [Garfish.registerApp](/api/registerapp)（用于动态注册应用信息） +- [Garfish.loadApp](/api/loadapp)（可以手动控制子应用加载和销毁） +- [Garfish.router](/api/router)（提供路由跳转和路由守卫能力） +- [Garfish.channel](/api/channel)（提供应用间通信的能力） +- [Garfish.setExternal](/api/setexternal)（支持应用间的依赖共享） +- [Garfish.getGlobalObject](/api/getglobalobject)（用于获取真实 Window） +- [Garfish.setGlobalObject](/api/getglobalobject)（用于设置真实 Window 的值） +- [Garfish.clearEscapeEffect](/api/getglobalobject)（用于清除逃逸的副作用） diff --git a/website-new/docs/api/loadApp.mdx b/website-new/docs/api/loadApp.mdx new file mode 100644 index 000000000..f3904ef61 --- /dev/null +++ b/website-new/docs/api/loadApp.mdx @@ -0,0 +1,303 @@ +# Garfish.loadApp + +import Highlight from '@components/Highlight'; +import { Tab, Tabs } from 'rspress/theme'; + +用于手动挂载子应用，可动态控制子应用的渲染和销毁。 + +> Garfish 支持路由驱动式的应用挂载和销毁模式， +> 如果你的应用配置了 `activeWhen`, Garfish 则将自动监听路由变化并在路由命中时加载对应的子应用。这种模式属于路由驱动式的应用加载模式。如果你希望手动控制应用的加载和销毁，我们提供了 `Garfish.loadApp()` API 以供用户手动加载和销毁应用，这是一种更加灵活的子应用加载模式。 + + +:::info + +1. 基于路由匹配的应用加载模式会通过子应用的 `activeWhen` 参数在在路由变化后自动判断当前应加载的子应用； +2. 在手动加载模式下（Garfish.loadApp），Garfish 不会根据路径匹配而是完全由开发者控制应用加载和销毁，此时应用加载不会受到 `activeWhen` 参数的影响； + + +::: + +## 类型 + +```ts +loadApp(appName: string, options?: Omit): Promise; +``` + +## 默认值 + +- 无 + +## 示例 + + + + +```jsx +import React, { useState } from 'react'; +import Garfish from "garfish"; +import type { interfaces } from "garfish"; + +// 提供 VueApp 的 React 组件 +export default App = () => { + const [app, setApp] = useState(null); + const loadApplication = async () => { + if (!app) { + setLoadAsync(true); + const app = await Garfish.loadApp('vue-app', { + cache: true, + basename, + domGetter: '#container', + entry: 'http://localhost:8092', + }); + setApp(app); + setLoadAsync(false); + } else { + app.display ? app.hide() : app.show(); + } + } + + return ( + <> + +
+ {loadAsync && } +
+ + ) +} +``` + + + +```html + + + +``` + +- 优点 + - 不需要用户手动增加配置 +- 缺点 + - 子应用的节点会受到主应用的影响 + - 子应用独立运行表现和在主应用运行表现可能不一致 + - 需要配合节点的处理一起进行（组件库可能会创建弹窗到 `body` 下，需要将节点劫持添加到容器内） + +多实例下的样式隔离 +在多实例场景下，可能会存在多份不同版本的 UI 组件库，从而导致样式冲突，目前的一种解决方案是通过构建工具给所有的样式都加上 namespace，如 + +```css +#garfish_app1 { + ...css; +} +``` + +由于挂载的时候会把所有的节点都挂载在#garfish_app1 上，所以样式仍然能够生效。 + +```html +
+ +
+``` + +> Shadow DOM + +基于 `Web Components` 的 `Shadow DOM` 能力，将每个子应用包裹到一个 `Shadow DOM` 中，保证其运行时的样式的绝对隔离 `WebComponents Polyfill` + +`Shadow dom` 是实现 `Web Components` 的主要技术之一，另外两项分别为 `custom element`、`HTML templates`，在 `Shadow dom` 用简单概括为：将 `Dom` 文档树中的某个节点变为隔离节点，隔离节点内的子节点样式、行为将与外界隔离（隔离节点内的样式不会受到外部影响，也不会影响外部节点，在隔离节点内的事件最终都只会冒泡到隔离节点中） + +- Garfish 基于 ShadowDom 实现样式隔离 + + - 将容器节点变为 shadow dom + - 子应用节点操作转发到容器内，动态增加的样式和节点都会放置容器内 + - 查询节点操作转发到容器内 + - 事件向上传播，避免 `React` 依赖事件委托的库失效 + +- 优点 + - 浏览器基本的样式隔离 + - 支持主子应用样式隔离 + - 支持多实例 +- 缺点 + - 需要同时处理 DOM，将 DOM 放置容器内 + - 可能会导致部分组件库或基础库无法正常运行（不支持放置 ShadowDom 内） + +### 其他副作用 + +上面描述的其实只是对于变量的隔离，其实除了变量之外，还会有其他的副作用是需要隔离的，包括但不限于： + +- 计时器：`setInterval`、`setTimeout` +- 全局事件监听：`addEventListener` +- 全局存储：`localStorage`、`sessionStorage` + +解决方法主要分为两类，能够通过劫持收集的： + +1. 如 `setInterval`、`setTimeout`、`addEventListener`，通过重写这些方法，在调用的时候记录起来，放进一个队列里，在沙箱销毁的时候统一进行清除。 + +2. 持久化数据，无法通过劫持进行收集的，使用命名空间来区分 + 如 `localStorage`，`sessionStorage`，重写对象和方法 + +```javascript +// 代码 +localStorage.setItem('a', '1'); + +// 在SandboxA里执行实际效果 +localStorage.setItem('Garfish_A_a', '1'); + +// 逃逸的场景 +Garfish.getRawLocalStorage().setItem('a', '1'); +``` + +## 两种沙箱的对比 + +![image](https://user-images.githubusercontent.com/27547179/164144636-2d85409e-d011-43c8-929b-07eb287abf2f.png) +![image](https://user-images.githubusercontent.com/27547179/164144650-c2d26150-7779-4bb0-bfbb-3404615335b9.png) +![image](https://user-images.githubusercontent.com/27547179/164144658-3997cb63-20f2-4f8c-a4b4-199389d7f5be.png) diff --git a/website-new/docs/guide/demo/_meta.json b/website-new/docs/guide/demo/_meta.json new file mode 100644 index 000000000..461eda416 --- /dev/null +++ b/website-new/docs/guide/demo/_meta.json @@ -0,0 +1 @@ +["demo","react","vue", "vite","angular"] diff --git a/website-new/docs/guide/demo/angular.mdx b/website-new/docs/guide/demo/angular.mdx new file mode 100644 index 000000000..7874d3395 --- /dev/null +++ b/website-new/docs/guide/demo/angular.mdx @@ -0,0 +1,182 @@ +# angular 子应用 +本节我们将详细介绍 angular 框架的应用作为子应用的接入步骤。[demo](https://github.com/modern-js-dev/garfish/tree/main/dev/app-angular) + +## angular 子应用接入步骤 + +### 1. 插件安装 + +```bash npm2yarn +# 1. 安装 @angular-builders/custom-webpack:browser +npm install @angular-builders/custom-webpack:browser -D + +# 2. 安装 @angular-builders/custom-webpack:dev-server +npm install @angular-builders/custom-webpack:dev-server -D +``` + +### 2. 修改 angular.json +1. 修改 [packageName] > architect > build > builder +```json +// angular.json +"builder": "@angular-builders/custom-webpack:browser", +``` +2. 修改 [packageName] > architect > build > options +```json +// angular.json +"options": { + "customWebpackConfig": { + // 新增 webpack 配置 + "path": "./custom-webpack.config.js" + }, + "index": "", +} +``` +3. 修改 [packageName] > architect > serve > builder +```json +// angular.json +"builder": "@angular-builders/custom-webpack:dev-server", +``` +:::caution +1. 请注意，在 [packageName] > architect > build > options 的配置中，index 属性我们设置为空，这是因为在 angular 13 中编译产物默认会带上 esm 标识，即 type=module, 即使打包产物是 umd 格式，这会导致 garfish 加载子应用失败； +2. index 置空后，编译产物会去除 es module 标识，子应用加载正常； + +::: + + +### 3. 添加 webpack 配置文件 + +:::caution 【重要】注意： +1. libraryTarget 需要配置成 umd 规范； +2. globalObject 需要设置为 'window'，以避免由于不规范的代码格式导致的逃逸沙箱； +3. 如果你的 webpack 为 v4 版本，需要设置 jsonpFunction 并保证该值唯一（否则可能出现 webpack chunk 互相影响的可能）。若为 webpack5 将会直接使用 package.json name 作为唯一值，请确保应用间的 name 各不相同； +4. publicPath 设置为子应用资源的绝对地址，避免由于子应用的相对资源导致资源变为了主应用上的相对资源。这是因为主、子应用处于同一个文档流中，相对路径是相对于主应用而言的 +5. 'Access-Control-Allow-Origin': '*' 允许开发环境跨域，保证子应用的资源支持跨域。另外也需要保证在上线后子应用的资源在主应用的环境中加载不会存在跨域问题（**也需要限制范围注意安全问题**）； + +::: + +```js +// custom-webpack.config.js +const HtmlWebpackPlugin = require('html-webpack-plugin'); + +module.exports = { + output: { + filename: '[name].[contenthash].js', + chunkFilename: '[name].[contenthash].js', + libraryTarget: 'umd', + globalObject: 'window', + chunkLoadingGlobal: 'Garfish-demo-angular', + publicPath: 'http://localhost:8080' + }, + plugins: [ + new HtmlWebpackPlugin({ + filename: 'index.html', + template: path.join(__dirname, 'src/index.html'), + chunksSortMode: 'manual', + chunks: ['styles', 'runtime', 'polyfills', 'scripts', 'vendors', 'main'], + scriptLoading: 'defer', + }), + ], + devServer: { + headers: { + 'Access-Control-Allow-Origin': '*', + }, + }, +}; + +``` + +### 4. 更改 package.json 启动脚本 +```json + "scripts": { + "builder": "@angular-builders/custom-webpack:dev-server" + } +``` + +### 5. 入口文件处导出 provider 函数 +```ts + // src/main.ts + import { enableProdMode, NgModuleRef } from '@angular/core'; + import { platformBrowserDynamic } from '@angular/platform-browser-dynamic'; + import { AppModule } from './app/app.module'; + import { environment } from './environments/environment'; + + if (environment.production) { + enableProdMode(); + } + + let app: void | NgModuleRef; + + async function render() { + await platformBrowserDynamic() + .bootstrapModule(AppModule) + .catch((err) => console.error(err)); + } + export const provider = ({ dom, basename, props}) => { + return { + render, + destroy({ dom }) { + const root = dom + ? dom.querySelector('#root') + : document.querySelector('#root'); + }, + }; + }; +``` + +### 6. 根组件设置路由的 basename +:::info +1. 为什么要设置 basename？请参考 [issue](../../issues/childApp.md#子应用拿到-basename-的作用) +2. 我们强烈建议使用从主应用传递过来的 basename 作为子应用的 basename，而非主、子应用约定式，避免 basename 后期变更未同步带来的问题。 +3. 目前主应用仅支持 history 模式的子应用路由，[why](../../issues/childApp.md#为什么主应用仅支持-history-模式) + +::: +```ts +// app.module.ts +import { NgModule } from '@angular/core'; +import { BrowserModule } from '@angular/platform-browser'; +import { RouterModule } from '@angular/router'; +import { ReactiveFormsModule } from '@angular/forms'; +import { AppComponent } from './app.component'; +import { TopBarComponent } from './topBar/topBar.component'; +import { HomeComponent } from './home/home.component'; +import { APP_BASE_HREF } from '@angular/common'; + +@NgModule({ + imports: [ + BrowserModule, + ReactiveFormsModule, + RouterModule.forRoot([ + { path: '/home', component: HomeComponent } + ]) + ], + providers: [{ provide: APP_BASE_HREF, useValue: '/examples/angular' }], + declarations: [ + AppComponent, + TopBarComponent, + ], + bootstrap: [AppComponent], +}) +export class AppModule {} +``` + +### 7. 增加子应用独立运行兼容逻辑 +:::tip +last but not least, 别忘了添加子应用独立运行逻辑，这能够让你的子应用脱离主应用独立运行，便于后续开发和部署。 + +::: + +```js +// src/main.ts +import { enableProdMode, NgModuleRef } from '@angular/core'; +import { platformBrowserDynamic } from '@angular/platform-browser-dynamic'; +import { AppModule } from './app/app.module'; + +async function render() { + await platformBrowserDynamic() + .bootstrapModule(AppModule) + .catch((err) => console.error(err)); +} + +if (!(window as any).__GARFISH__) { + render(); +} +``` diff --git a/website-new/docs/guide/demo/demo.md b/website-new/docs/guide/demo/demo.md new file mode 100644 index 000000000..3a096d5f3 --- /dev/null +++ b/website-new/docs/guide/demo/demo.md @@ -0,0 +1,16 @@ +# 概述 + +本节我们会详细讲述不同框架下的子应用如何接入 Garfish, 提供抄得走的接入案例，以下所有 demo 均可在 [garfish demo](https://github.com/modern-js-dev/garfish/tree/main/dev) 中找到实际使用案例，目前提供的 demo 案例包含： + +- react (version 16, 17, 18) +- vue (version 2, 3) +- vite (version 2) +- angular (version 13) +## demo 案例 + +子应用的导出提供通过 `@garfish/bridge-*` 的方式和自定义导出函数两种方式，我们将在下列 demo 案例中分别讲述。 + +- [react 子应用](/guide/demo/react) +- [vue 子应用](/guide/demo/vue) +- [vite 子应用](/guide/demo/vite) +- [angular 子应用](/guide/demo/angular) diff --git a/website-new/docs/guide/demo/react.mdx b/website-new/docs/guide/demo/react.mdx new file mode 100644 index 000000000..26a8f1aab --- /dev/null +++ b/website-new/docs/guide/demo/react.mdx @@ -0,0 +1,195 @@ +# react 子应用 + +import WebpackConfig from '@components/config/_webpackConfig.mdx'; + +本节我们将详细介绍 react 框架的应用作为子应用的接入步骤。[v16/17 demo](https://github.com/modern-js-dev/garfish/tree/main/dev/app-react-17)、[v18 demo](https://github.com/modern-js-dev/garfish/blob/main/dev/app-react-18) + +## react 子应用接入步骤 +### 1. bridge 依赖安装 + +:::tip +1. 请注意，桥接函数的安装不是必须的，你可以自定义导出函数。 +2. 我们提供桥接函数是为了进一步降低用户接入成本并降低用户出错概率，桥接函数中将会内置一些默认行为，可以避免由于接入不规范导致的错误，所以这也是我们推荐的接入方式。 + +::: + +```bash npm2yarn +npm install @garfish/bridge-react --save +``` + +### 2. 入口文件处导出 provider 函数 + +更多 bridge 函数参数介绍请参考 [这里](/guide/bridge) +### react v16、v17 导出 +import { Tab, Tabs } from 'rspress/theme'; + + + + +```tsx +// src/index.tsx +import { reactBridge } from '@garfish/bridge-react'; +import RootComponent from './components/root'; +import Error from './components/ErrorBoundary'; + +export const provider = reactBridge({ + // 子应用挂载点，若子应用构建成 js ，则不需要传递该值 + el: '#root', + // 根组件, bridge 会默认传递 basename、dom、props 等信息到根组件 + rootComponent: RootComponent, + // 设置应用的 errorBoundary + errorBoundary: () => , +}); +``` + + + + + +```tsx + // src/index.tsx + import React from "react"; + import ReactDOM from "react-dom"; + import RootComponent from "./components/root"; + + export const provider = () => { + return { + // 和子应用独立运行时一样，将子应用渲染至对应的容器节点，根据不同的框架使用不同的渲染方式 + render({ dom, basename, props}) { + ReactDOM.render(, root); + }, + destroy({ dom, basename}) { + // 使用框架提供的销毁函数销毁整个应用，已达到销毁框架中可能存在得副作用，并触发应用中的一些组件销毁函数 + // 需要注意的时一定要保证对应框架得销毁函数使用正确，否则可能导致子应用未正常卸载影响其他子应用 + ReactDOM.unmountComponentAtNode( + dom ? dom.querySelector('#root') : document.querySelector('#root'), + ); + }, + }; + }; +``` + + + + +### react v18 导出 + + + + +```tsx +// src/index.tsx +import { reactBridge } from '@garfish/bridge-react-v18'; +import RootComponent from './root'; +import ErrorBoundary from './ErrorBoundary'; + +export const provider = reactBridge({ + el: '#root', + rootComponent: RootComponent, + errorBoundary: (e: any) => , +}); + +``` + + + + + +```tsx +// src/index.tsx +import { createRoot } from 'react-dom/client'; +import RootComponent from './root'; + +// 在首次加载和执行时会触发该函数 +export const provider = () => { + let root = null; + return { + render({ basename, dom, store, props }) { + const container = dom.querySelector('#root'); + root = createRoot(container!); + (root as any).render(); + }, + destroy({ dom }) { + (root as any).unmount(); + }, + }; +}; +``` + + + + +### 3. 根组件设置路由的 basename + +:::info +1. 为什么要设置 basename？请参考 [issue](../../issues/childApp.md#子应用拿到-basename-的作用) +2. 我们强烈建议使用从主应用传递过来的 basename 作为子应用的 basename，而非主、子应用约定式，避免 basename 后期变更未同步带来的问题。 +3. 目前主应用仅支持 history 模式的子应用路由，[why](../../issues/childApp.md#为什么主应用仅支持-history-模式) +::: + +```tsx +// src/component/rootComponent +import React from "react"; +import { BrowserRouter } from "react-router-dom"; + +const RootComponent = ({ basename }) => { + return ( + + + }> + } /> + } /> + + + + ) +} +``` + +### 4. 更改 webpack 配置 + + + +### 5. 增加子应用独立运行兼容逻辑 + +:::tip +last but not least, 别忘了添加子应用独立运行逻辑，这能够让你的子应用脱离主应用独立运行，便于后续开发和部署。 +::: + + + + + +```tsx +// src/index.tsx +if (!window.__GARFISH__) { + ReactDOM.render( + , document.getElementById("root")); +} +``` + + + + + +```tsx +// src/index.tsx +if (!window.__GARFISH__) { + const container = document.getElementById('root'); + const root = createRoot(container!); + root.render( + + ); +} +``` + + + diff --git a/website-new/docs/guide/demo/vite.mdx b/website-new/docs/guide/demo/vite.mdx new file mode 100644 index 000000000..c80ec765c --- /dev/null +++ b/website-new/docs/guide/demo/vite.mdx @@ -0,0 +1,127 @@ +# vite 子应用 + +import ViteConfig from '@components/config/_viteConfig.mdx'; + +本节我们将详细介绍 vite 框架的应用作为子应用的接入步骤。[demo](https://github.com/modern-js-dev/garfish/tree/main/dev/app-vue-vite) + +### 子应用沙箱状态 + +当 vite 应用作为子应用接入 garfish 时，我们要求子应用沙箱需关闭，否则应用将不能正常运行。 + +:::info 请注意： +1. 子应用沙箱默认为开启状态，请[设置子应用沙箱关闭](/guide/demo/vite#设置子应用沙箱关闭)； +2. 在关闭沙箱的场景下，子应用的副作用将会发生逃逸，请确保子应用卸载后对应全局的副作用被清除； + +::: + +### 设置子应用沙箱关闭 + +```js +// 主应用工程中，Garfish.run 处设置： +Garfish.run({ + ..., + apps: [ + { + name: 'sub-app', + activeWhen: '/vite', + sandbox: false + } + ] +}) +``` + +:::caution +注意，不要设置 Garfish.run() 顶层的 sandbox 属性，这会导致所有子应用的沙箱关闭。 + +::: + +## vite 子应用接入步骤 + +### 1. bridge 依赖安装 + +:::tip +1. 请注意，桥接函数的安装不是必须的，你可以自定义导出函数。 +2. 我们提供桥接函数是为了进一步降低用户接入成本并降低用户出错概率，桥接函数中将会内置一些默认行为，可以可以避免由于接入不规范导致的错误，所以这也是我们推荐的接入方式。 + +::: + +```bash npm2yarn +npm install @garfish/bridge-vue-v3 --save +``` +### 2. 入口文件处导出 provider 函数 + +更多 bridge 函数参数介绍请参考 [这里](/guide/bridge) + +```js +// src/main.js +import { h } from 'vue'; +import { createRouter, createWebHistory } from 'vue-router'; +import { vueBridge } from '@garfish/bridge-vue-v3'; +import App from './App.vue'; + +function newRouter(basename) { + const router = createRouter({ + history: createWebHistory(basename), + base: basename, + routes, + }); + return router; +} + +export const provider = vueBridge({ + rootComponent: App, + // 可选，注册 vue-router或状态管理对象 + appOptions: ({ basename, dom, appName, props }) => ({ + el: '#app', + render: () => h(App), + router: newRouter(basename), + }), +}); +``` + +### 3. 根组件设置路由的 basename + +:::info +1. 为什么要设置 basename？请参考 [issue](../../issues/childApp.md#子应用拿到-basename-的作用) +2. 我们强烈建议使用从主应用传递过来的 basename 作为子应用的 basename，而非主、子应用约定式，避免 basename 后期变更未同步带来的问题。 +3. 目前主应用仅支持 history 模式的子应用路由，[why](../../issues/childApp.md#为什么主应用仅支持-history-模式) + +::: + +```js +// src/main.js +import { h } from 'vue'; +import { createRouter, createWebHistory } from 'vue-router'; +import { vueBridge } from '@garfish/bridge-vue-v3'; +import App from './App.vue'; + +function newRouter(basename) { + const router = createRouter({ + history: createWebHistory(basename), + base: basename, + routes, + }); + return router; +} +``` + +### 4. 更改 vite 配置 + + + + +### 5. 增加子应用独立运行兼容逻辑 + +:::tip +last but not least, 别忘了添加子应用独立运行逻辑，这能够让你的子应用脱离主应用独立运行，便于后续开发和部署。 + +::: + +```js +// src/main.js +if (!window.__GARFISH__) { + // 非微前端环境直接运行 + const vueInstance = createApp(App); + vueInstance.mount(document.querySelector('#app')); +} +``` diff --git a/website-new/docs/guide/demo/vue.mdx b/website-new/docs/guide/demo/vue.mdx new file mode 100644 index 000000000..12e32cce4 --- /dev/null +++ b/website-new/docs/guide/demo/vue.mdx @@ -0,0 +1,311 @@ +# vue 子应用 + +import WebpackConfig from '@components/config/_webpackConfig.mdx'; + +本节我们将详细介绍 vue 框架的应用作为子应用的接入步骤。[v2 demo](https://github.com/modern-js-dev/garfish/tree/main/dev/app-vue-2)、[v3 demo](https://github.com/modern-js-dev/garfish/tree/main/dev/app-vue-3) + +## vue 子应用接入步骤 + +### 1. bridge 依赖安装 + +:::tip + 1. 请注意，桥接函数的安装不是必须的，你可以自定义导出函数。 + 2. 我们提供桥接函数是为了进一步降低用户接入成本并降低用户出错概率，桥接函数中将会内置一些默认行为，可以避免由于接入不规范导致的错误，所以这也是我们推荐的接入方式。 + 3. 我们分别为 vue 2、3 应用提供不同的 bridge 包，目的是为了更好的类型提示及精简参数。 + +::: + + +import { Tab, Tabs } from 'rspress/theme'; + + + + + ```bash npm2yarn + npm install @garfish/bridge-vue-v2 --save + ``` + + + + + + ```bash npm2yarn + npm install @garfish/bridge-vue-v3 --save + ``` + + + +### 2. 入口文件处导出 provider 函数 + +更多 bridge 函数参数介绍请参考 [这里](/guide/bridge) +### vue2 导出 + + + + ```js + import Vue from 'vue'; + import VueRouter from 'vue-router'; + import store from './store'; + import App from './App.vue'; + import Home from './components/Home.vue'; + import { vueBridge } from '@garfish/bridge-vue-v2'; + + Vue.use(VueRouter); + Vue.config.productionTip = false; + + function newRouter(basename) { + const router = new VueRouter({ + mode: 'history', + base: basename, + routes: [ + { path: '/home', component: Home }, + ], + }); + return router; + } + + export const provider = vueBridge({ + // 根组件 + rootComponent: App, + // 可选，注册 vue-router或状态管理对象 + appOptions: ({ basename, dom, appName, props, appInfo }) => { + // pass the options to Vue Constructor. check https://vuejs.bootcss.com/api/#%E9%80%89%E9%A1%B9-%E6%95%B0%E6%8D%AE + return { + el: '#app', + router: newRouter(basename), + store, + }; + }, + }); + ``` + + + + +```js + import Vue from 'vue'; + import App from './App.vue'; + import store from './store'; + import VueRouter from 'vue-router'; + import HelloWorld from './components/HelloWorld.vue'; + + Vue.use(VueRouter); + Vue.config.productionTip = false; + + const render = ({ dom, basename = '/' }) => { + const router = new VueRouter({ + mode: 'history', + base: basename, + router, + routes: [ + { path: '/', component: HelloWorld }, + ], + }); + + const vm = new Vue({ + store, + render: (h) => h(App, { props: { basename } }), + }).$mount(); + (dom || document).querySelector('#app').appendChild(vm.$el); + }; +``` + + + +### vue3 导出 + + + + + ```js + import { h, createApp } from 'vue'; + import { createRouter, createWebHistory } from 'vue-router'; + import { stateSymbol, createState } from './store.js'; + import App from './App.vue'; + import Home from './components/Home.vue'; + import { vueBridge } from '@garfish/bridge-vue-v3'; + + const routes = [ + { path: '/home', component: Home }, + ]; + + function newRouter(basename) { + const router = createRouter({ + history: createWebHistory(basename), + routes, + }); + return router; + } + + export const provider = vueBridge({ + rootComponent: App, + // 可选，注册 vue-router或状态管理对象 + handleInstance: (vueInstance, { basename, dom, appName, props, appInfo}) => { + vueInstance.use(newRouter(basename)); + vueInstance.provide(stateSymbol, createState()); + }, + }); + ``` + + + + + ```js + import { h, createApp } from 'vue'; + import { createRouter, createWebHistory } from 'vue-router'; + import { stateSymbol, createState } from './store.js'; + import App from './App.vue'; + import HelloGarfish from './components/HelloGarfish.vue'; + + export function provider({ dom, basename }) { + let app = null; + return { + render() { + app = createApp(App); + app.provide(stateSymbol, createState()); + const router = createRouter({ + history: createWebHistory(basename), + base: basename, + routes: [{ path: '/home', component: HelloGarfish }] + }); + app.use(router); + app.mount( + dom ? dom.querySelector('#app') : document.querySelector('#app'), + ); + }, + destroy() { + if (app) { + app.unmount( + dom ? dom.querySelector('#app') : document.querySelector('#app'), + ); + } + }, + }; + } + ``` + + + +### 3. 根组件设置路由的 basename + +:::tip +1. 为什么要设置 basename？请参考 [issue](../../issues/childApp.md#子应用拿到-basename-的作用) +2. 我们强烈建议使用从主应用传递过来的 basename 作为子应用的 basename，而非主、子应用约定式，避免 basename 后期变更未同步带来的问题。 +3. 目前主应用仅支持 history 模式的子应用路由，[why](../../issues/childApp.md#为什么主应用仅支持-history-模式) + +::: + + + + + ```js + import Vue from 'vue'; + import VueRouter from 'vue-router'; + import store from './store'; + import App from './App.vue'; + import Home from './components/Home.vue'; + import { vueBridge } from '@garfish/bridge-vue-v2'; + + Vue.use(VueRouter); + Vue.config.productionTip = false; + + function newRouter(basename) { + const router = new VueRouter({ + mode: 'history', + base: basename, + routes: [ + { path: '/home', component: Home }, + ], + }); + return router; + } + ``` + + + + ```js + import { h, createApp } from 'vue'; + import { createRouter, createWebHistory } from 'vue-router'; + import { stateSymbol, createState } from './store.js'; + import App from './App.vue'; + import Home from './components/Home.vue'; + import { vueBridge } from '@garfish/bridge-vue-v3'; + + const routes = [ + { path: '/home', component: Home }, + ]; + + function newRouter(basename) { + const router = createRouter({ + history: createWebHistory(basename), + base: basename, + routes, + }); + return router; + } + ``` + + + + +### 4. 更改 webpack 配置 + + + +### 5. 增加子应用独立运行兼容逻辑 + +:::tip +last but not least, 别忘了添加子应用独立运行逻辑，这能够让你的子应用脱离主应用独立运行，便于后续开发和部署。 + +::: + + + + + ```js + // src/main.js + import Vue from 'vue'; + import VueRouter from 'vue-router'; + + // 这能够让子应用独立运行起来，以保证后续子应用能脱离主应用独立运行，方便调试、开发 + if (!window.__GARFISH__) { + const router = new VueRouter({ + mode: 'history', + base: '/', + routes: [ + { path: '/home', component: Home }, + ], + }); + new Vue({ + store, + router, + render: (h) => h(App), + }).$mount('#app'); + } + ``` + + + + ```js + // src/main.js + import { h, createApp } from 'vue'; + import VueRouter from 'vue-router'; + + // 这能够让子应用独立运行起来，以保证后续子应用能脱离主应用独立运行，方便调试、开发 + if (!window.__GARFISH__) { + const router = new VueRouter({ + mode: 'history', + base: '/', + routes: [ + { path: '/home', component: Home }, + ], + }); + const app = createApp(App); + app.provide(stateSymbol, createState()); + app.use(router); + app.mount('#app'); + } + ``` + + + diff --git a/website-new/docs/guide/quick-start/_meta.json b/website-new/docs/guide/quick-start/_meta.json new file mode 100644 index 000000000..73eecf9cb --- /dev/null +++ b/website-new/docs/guide/quick-start/_meta.json @@ -0,0 +1 @@ +["index","start","env"] diff --git a/website-new/docs/guide/quick-start/env.md b/website-new/docs/guide/quick-start/env.md new file mode 100644 index 000000000..3bdc67b60 --- /dev/null +++ b/website-new/docs/guide/quick-start/env.md @@ -0,0 +1,36 @@ +# 环境变量 + +有时候需要使用环境变量（Environment Variables）以按需控制 `Garfish` 的行为，或者通过环境变量来区分微前端的子应用是否在微前端环境下运行，进行一些兼容性逻辑的处理，下面来看看如何使用环境变量来控制 `Garfish` 的行为。 + +## 环境变量列表 + +| 名称 | 描述 | 使用场景 | +| -------------------- | ---------------------------------------------------------- | ----------------------------------------------------------------------------- | +| `window.__GARFISH__` | 在引入 `garfish` 包后， `window.__GARFISH__` 为 `true` | 主要让子应用在校验是否处于微前端环境，因此建议子应用不要单独引入 `garfish` 包 | +| `window.Garfish` | 在引入 `garfish` 包后， `window.Garfish` 为 `Garfish` 实例 | 可以使用 `Garfish` 实例上的方法，子应用也可使用该变量 | + + + +## 使用场景 + +### `window.__GARFISH__` + +用于子应用判断当前是否处于微前端环境中。 +如：在子应用入口处。增加子应用独立运行时逻辑： + +```ts +if (!window.__GARFISH__) { + ReactDOM.render( + , + document.querySelector('#root'), + ); +} +``` + +### `window.Garfish` + +使用 `Garfish` 的路由进行路由跳转 + +```ts +window.Garfish.router.push({ path: '/test' }); +``` diff --git a/website-new/docs/guide/quick-start/index.md b/website-new/docs/guide/quick-start/index.md new file mode 100644 index 000000000..a31675f7c --- /dev/null +++ b/website-new/docs/guide/quick-start/index.md @@ -0,0 +1,56 @@ +# 介绍 + +微前端是一种类似于微服务的架构，是一种由独立交付的多个前端应用组成整体的架构风格，将前端应用分解成一些更小、更简单的能够独立开发、测试、部署的应用，而在用户看来仍然是内聚的单个产品。 + +它主要解决了两个问题： + +- 随着项目迭代应用越来越庞大，难以维护； +- 跨团队或跨部门协作开发项目导致效率低下的问题； + +## Garfish 起源 + +Garfish 起源于 [头条号](http://mp.toutiao.com) 的实际场景，随着业务发展变成一个 Monolithic-Applications （[巨石应用](https://en.wikipedia.org/wiki/Monolithic_application)）。同时由于维护的团队人员都比较分散，工程大，导致开发调试效率低、上线困难（代码合并相互依赖），成为阻塞业务发展的一个重要因素。 + +于是在 2018 年衍生了 Garfish 这个微前端框架，经过大量业务方实际场景的验证和打磨，Garfish 逐渐趋于成熟。并且随着更多的业务对微前端的需求，Garfish 也在不断迭代之中，已经积累了丰富的微前端问题解决经验。 + +## Garfish 是什么 + +Garfish 是一套 [微前端](https://micro-frontends.org/) 解决方案，主要用于解决现代 web 应用在前端生态繁荣和 web 应用日益复杂化两大背景下带来的跨团队协作、技术体系多样化、web 应用日益复杂化等问题：从架构层面出发将多个独立交付的前端应用组成整体，这些前端应用能够「**独立开发**」、「**独立测试**」、「**独立部署**」，但是最终在用户看来仍然是**内聚的单个产品**。 + +## 框架特性 + +- 🌈 **丰富高效的产品特征** + + - Garfish 微前端子应用支持任意多种框架、技术体系接入 + - Garfish 微前端子应用支持「**独立开发**」、「**独立测试**」、「**独立部署**」 + - 强大的预加载能力，自动记录用户应用加载习惯增加加载权重，应用切换时间极大缩短 + - 支持依赖共享，极大程度的降低整体的包体积，减少依赖的重复加载 + - 内置数据收集，有效的感知到应用在运行期间的状态 + - 支持多实例能力，可在页面中同时运行多个子应用提升了业务的拆分力度 + +- 📦 **高扩展性的核心模块** + + - 通过 Loader 核心模块支持 HTML entry、JS entry 的支持，接入微前端应用简单易用 + - Router 模块提供了路由驱动、主子路由隔离，用户仅需要配置路由表应用即可完成自主的渲染和销毁，无需关心内部逻辑 + - Sandbox 模块为应用的 Runtime 提供运行时隔离能力，能有效隔离 JS、Style 对应用的副作用影响 + - Store 提供了一套简单的通信数据交换机制 + +- 🎯 **高度可扩展的插件机制** + + - 提供业务插件满足各种定制需求 + +## 设计理念 + +![image.png](https://p-vcloud.byteimg.com/tos-cn-i-em5hxbkur4/d456c7d2235c41daa298aba69ade435f~tplv-em5hxbkur4-noop.image?width=1126&height=454) + +具体可参考 [微前端架构设计](/blog) 这篇文章中的详细介绍 + +## 什么时候用 + +如果你的团队成员多、项目类型多，并且想将其打造成「内聚的单个产品」： + +- 项目的团队成员来自多个团队 +- 项目内多条迭代出现需求挤兑，影响测试、发布效率 +- 跨空间、跨时间维度导致团队内技术体系无法统一 +- 多个前端应用需要达到「内聚的单个产品」特征 +- 「内聚的单个产品」中部分内容希望达到独立开发、独立发布、独立测试、独立灰度等能力 diff --git a/website-new/docs/guide/quick-start/start.md b/website-new/docs/guide/quick-start/start.md new file mode 100644 index 000000000..6df22b013 --- /dev/null +++ b/website-new/docs/guide/quick-start/start.md @@ -0,0 +1,200 @@ +# 快速开始 + +import WebpackConfig from '@components/config/_webpackConfig.mdx'; + +import ViteConfig from '@components/config/_viteConfig.mdx'; + +本节分别从主、子 应用视角出发，介绍如何通过 [Garfish API](/api) 来将应用接入 Garfish 框架 + +:::tip 在线预览 + +::: + +## 主应用 + +通过 Garfish API 接入主应用整体流程分为 2 步： + +1. 添加 `garfish` 依赖包 +2. 通过 `Garfish.run`，提供挂载点、basename、子应用列表 + +### 1.安装依赖 + +```bash npm2yarn +npm install garfish --save +``` + +### 2.注册子应用并启动 Garfish + +```js +// index.js（主应用入口处） +import Garfish from 'garfish'; +Garfish.run({ + basename: '/', + domGetter: '#subApp', + apps: [ + { + name: 'react', + activeWhen: '/react', + entry: 'http://localhost:3000', // html入口 + }, + { + name: 'vue', + activeWhen: '/vue', + entry: 'http://localhost:8080/index.js', // js入口 + }, + ], +}); +``` + +当引入 Garfish 实例，执行实例方法 `Garfish.run` 后，`Garfish` 将会立刻启动路由劫持能力。 + +这时 `Garfish` 将会监听浏览器路由地址变化，当浏览器的地址发生变化时，`Garfish` 框架内部便会执行匹配逻辑，当解析到当前路径符合子应用匹配逻辑时，便会自动将应用挂载至指定的 `dom` 节点上，并在此过程中会依次触发子应用加载、渲染过程中的 [生命周期钩子函数](/guide/lifecycle). + +:::tip 注意 +请确保指定的节点存在于页面中，否则可能会导致出现 `Invalid domGetter "xxx"​` 错误。在 `Garfish` 开始渲染时，无法查询到该挂载节点则会提示该错误 + +> 解决方案 + +1. 将挂载点设置为常驻挂载点，不要跟随路由变化使子应用挂载点销毁和出现 +2. 保证 Garfish 在渲染时挂载点存在 +::: + +如果你的业务需要手动控制应用加载，可以使用 [Garfish.loadApp](/api/loadApp.md) 手动加载 APP： + +```typescript +// 使用 loadApp 动态挂载应用 +import Garfish from 'garfish'; +const app = await Garfish.loadApp('vue-app', { + domGetter: '#container', + entry: 'http://localhost:3000', + cache: true, +}); + +// 若已经渲染触发 show，只有首次渲染触发 mount，后面渲染都可以触发 show 提供性能 +app.mounted ? app.show() : await app.mount(); +``` + +## 子应用 + +通过 Garfish API 接入子应用整体流程分为 3 步： + +1. 调整子应用的构建配置(目前 Garfish 仅支持 umd 格式的产物) +2. 导出子应用生命周期 +3. 设置应用路由 `basename` + +### 1.调整子应用的构建配置 + + + + + + + + + + + + + + +### 2.导出 provider 函数 + +> 针对子应用需要导出生命周期函数，我们提供了桥接函数 [`@garfish/bridge-react`](/guide/bridge) 自动包装应用的生命周期，使用`@garfish/bridge-react` 可以降低接入成本与用户出错概率，也是 garfish 推荐的子应用接入方式。 + +```bash npm2yarn +// 安装 @garfish/bridge-react： +npm install @garfish/bridge-react --save +``` + + + + +```jsx +import { reactBridge } from '@garfish/bridge-react'; + +export const provider = reactBridge({ + el: '#root', + rootComponent: RootComponent, + errorBoundary: () => , +}); +``` + + + + +```tsx +import React from 'react'; +import ReactDOM from 'react-dom'; +import { BrowserRouter, Switch, Route, Link } from 'react-router-dom'; + +export const provider = () => ({ + // render 渲染函数，必须提供 + render: ({ dom, basename }) => { + // 和子应用独立运行时一样，将子应用渲染至对应的容器节点，根据不同的框架使用不同的渲染方式 + ReactDOM.render( + + + , + // 需要注意的一点是，子应用的入口是否为 HTML 类型（即在主应用的中配置子应用的 entry 地址为子应用的 html 地址）， + // 如果为 HTML 类型，需要在 dom 的基础上选中子应用的渲染节点 + // 如果为 JS 类型，则直接将 dom 作为渲染节点即可 + dom.querySelector('#root'), + ); + }, + // destroy 应用销毁函数，必须提供 + destroy: ({ dom, basename }) => { + // 使用框架提供的销毁函数销毁整个应用，已达到销毁框架中可能存在得副作用，并触发应用中的一些组件销毁函数 + // 需要注意的时一定要保证对应框架得销毁函数使用正确，否则可能导致子应用未正常卸载影响其他子应用 + ReactDOM.unmountComponentAtNode( + dom ? dom.querySelector('#root') : document.querySelector('#root'), + ); + }, +}); +``` + + + + +### 3. 设置应用路由 `basename` + +```ts +// src/component/rootComponent +import React from "react"; +import { BrowserRouter } from "react-router-dom"; + +const RootComponent = ({ basename }) => { + return ( + + + }> + } /> + } /> + + + + ) +} +``` + +我们在 [接入指南](/guide/demo) 章节详细中介绍了各框架的子应用接入 Garfish 的 demo 案例及接入过程注意事项，目前提供了： + +- react (version 16, 17, 18) +- vue (version 2, 3) +- vite (version 2) +- angular (version 13) + +可移步 [接入指南](/guide/demo) 查看详细接入步骤。 + +## 总结 + +使用 Garfish API 搭建一套微前端主子应用的主要成本来自两方面 + +- 主应用的搭建 + - 注册子应用的基本信息 + - 使用 Garfish 在主应用上调度管理子应用 +- 子应用的改造 + - 增加对应的构建配置 + - 使用 `@garfish/bridge-react` 包提供的函数包装子应用后返回 `provider` 函数并导出 + - 子应用针对不同的框架类型，添加不同 `basename` 的设置方式 + - React 在根组件中获取 `basename` 将其传递至 `BrowserRouter` 的 `basename` 属性中 + - Vue 将 `basename` 传递至 `VueRouter` 的 `basename` 属性中 diff --git a/website-new/docs/hello.md b/website-new/docs/hello.md new file mode 100644 index 000000000..d08771599 --- /dev/null +++ b/website-new/docs/hello.md @@ -0,0 +1,5 @@ +# Hello World! + +## Start + +Write something to build your own docs! 🎁 diff --git a/website-new/docs/index.md b/website-new/docs/index.md new file mode 100644 index 000000000..df8bf41ae --- /dev/null +++ b/website-new/docs/index.md @@ -0,0 +1,28 @@ +--- +pageType: home + +hero: + name: Garfish + text: 微前端框架 + tagline: 可轻松将多个前端应用组合成内聚的单个产品 + actions: + - theme: brand + text: Quick Start + link: /guide/quick-start/index.html + - theme: alt + text: GitHub + link: https://github.com/web-infra-dev/rspress + image: + src: https://lf3-static.bytednsdoc.com/obj/eden-cn/dhozeh7vhpebvog/open-garfish/icons/icon.png + alt: Garfish Logo +features: + - title: 跨框架 + details: 支持 vue、react、angular 多种框架混合使用 + icon: 📦 + - title: API 最大简洁化 + details: 在实际应用中使用方式极大简洁化 + icon: 🎨 + - title: 路由驱动 + details: 支持配置路由激活信息可完成自动化挂载和销毁 + icon: 🌈 +--- diff --git a/website-new/docs/issues/_meta.json b/website-new/docs/issues/_meta.json new file mode 100644 index 000000000..a7d5eda49 --- /dev/null +++ b/website-new/docs/issues/_meta.json @@ -0,0 +1 @@ +["index"] diff --git a/website-new/docs/issues/index.mdx b/website-new/docs/issues/index.mdx new file mode 100644 index 000000000..b6f69dd95 --- /dev/null +++ b/website-new/docs/issues/index.mdx @@ -0,0 +1,523 @@ +# 常见问题 + +import WebpackConfig from '@components/config/\_webpackConfig.mdx'; + +## "provider" is "null". + +出现这个问题是因为 garfish 无法从子应用中正确获取到 `provider` 导出函数，可以先按照以下步骤自查： + +1. 检查子应用是否正确 export 了 provider 函数。[参考](/guide/start#2导出-provider-函数) +2. 检查子应用是否正确配置了 webpack 的 output 配置： + + + +3. 确认子应用 `entry` 地址设置正确：若为 html 的入口类型 `entry` 配置为 html 入口地址，若为 js 类型，子应用 `entry` 配置为 js 入口地址； + +4. 若子应用为 js 入口，需要保证子应用的资源被打包成了单 bundle，若有部分依赖未被打包成 bundle 会导致子应用无法正常加载。例如子应用使用了 webpack splitChunk 进行拆包且为 js 入口时，会导致上述报错； + +5. 如以上途径都无法解决，请试图通过环境变量导出，这将会让 Garfish 框架更准确的获取到导出内容： + +```js +if (window.__GARFISH__ && typeof __GARFISH_EXPORTS__ !== 'undefined') { + // eslint-disable-next-line no-undef + __GARFISH_EXPORTS__.provider = provider; +} +``` + +## 微应用 JSONP 跨域错误怎么处理？ + +在使用 Garfish 时，微应用的动态脚本（如 JSONP）会被转化为 fetch 请求，这要求后端服务支持跨域请求，否则会产生错误。 + +可以使用 [excludeAssetFilter](/api/registerApp#sandbox) 参数来放行这些资源请求，但请注意，被该参数放行的资源会逃逸出沙箱，可能导致副作用，需自行处理。 + + +## Uncaught (in promise) TypeError: [Garfish warning]: Cannot read properties of undefined (reading 'call') + +- 错误原因 + + - 这个问题出现在子应用构建为 umd 格式后存在脚本出现了 `type="module"` 的标识，这将导致该 script 逃逸出沙箱执行，而其余脚本在沙箱内执行，找不到 chunk 导致报错。 + +- 解决方案 + - 请确保子应用构建为 umd 格式后 script 不会带上 `type="module"` 标识，保证子应用的正常解析和渲染。 + +## Invalid domGetter "xxx" + +错误原因：在 Garfish 开始渲染时，无法查询到该挂载节点则会提示该错误 + +> 解决方案 + +1. 将挂载点设置为常驻挂载点，不要跟随路由变化使子应用挂载点销毁和出现 +2. 保证 Garfish 在渲染时挂载点存在 + +## 如何获取主应用的 localStorage + +可按照如下配置获取主应用的 localStorage： + +```ts +import Garfish from 'garfish'; + +Garfish.run({ + ..., + sandbox: { + modules: [ + () => ({ + override: { + localStorage: window.localStorage, + }, + }), + ], + } +}); +``` + +类似 localStorage，子应用若需要获取被沙箱隔离机制隔离的全局变量上的变量，均可通过上述方式获取。 + +## 如何判断子应用是否微前端应用中 + +可通过环境变量 `window.__GARFISH__` 判断。 + +## 如何手动挂载子应用 + +可通过 [Garfish.loadApp](/api/loadApp) 动态加载子应用。 + +## HTML entry 和 JS entry 差异 + +- HTML entry + + - 指的是子应用配置的资源地址是 HTML 的地址 + - 指定子应用的 entry 地址为 HTML 地址，支持像 iframe 一样的能力，将对应的子应用渲染至当前应用中 + - HTML entry 模式的作用设计的初衷，解决子应用：**独立开发**、**独立测试** 的能力 + +- JS entry + + - 指的是子应用配置的资源地址就是一个 JS 地址 + +- 二者在使用层面上的差异 + - 在作为 `html entry` 时，子应用的挂载点需要基于传入的 `dom` 节点进行选中挂载点 + - 因为在 `html entry` 时，其实类似于 `iframe` 的模式，子应用在独立运行时的所有 `dom` 结构都会被挂到主应用的文档流上（整个文档流会挂载在当前 html 上） + - 所以子应用在渲染时需要根据子应用的 `dom` 结构去找他的挂载点。 + +* HTML entry 正确渲染销毁写法 + +```js {6} +export const provider = () => { + return { + render({ dom }) { + ReactDOM.render( + React.createElement(HotApp), + dom.querySelector('#root'), // 基于 dom 去选中文档流中的 #root，就和在独立运行时使用 document.querySelector('#root') 一样 + ); + }, + destroy({ dom }) { + // 此外，destroy 应该正确的执行 + const root = dom && dom.querySelector('#root'); + if (root) { + ReactDOM.unmountComponentAtNode(root); + } + }, + }; +}; +``` + +- JS entry 正确渲染销毁写法 + +```js +export const provider = ({ dom, basename }) => ({ + render() { + ReactDOM.render(, dom); // 作为 js entry 时，没有自己的文档流，只有提供的渲染节点 + }, + + destroy({ dom }) { + ReactDOM.unmountComponentAtNode(dom); // 没有自己的文档流，直接销毁 + }, +}); +``` + +## garfish 支持多实例吗 + +支持。 + +目前 garfish 支持多实例场景，业务使用场景可分为 「非嵌套场景」 和 「嵌套场景」： + +- 非嵌套场景下 + +* 非嵌套场景下，子应用请勿在安装引入 Garfish 包，并导入使用。 +* 子应用如果想要在微前端场景下使用 Garfish 包的相关能力，可判断在微前端环境内时，通过 `window.Garfish` 使用相关接口。 + +```js +if (window.__GARFISH__) { + window.Garfish.xx; +} +``` + +- 嵌套场景 + +* Garfish 目前内部的设计都支持嵌套场景，如果业务对这一块有诉求可以使用，协助我们一起推进在嵌套场景下的能力。 + +## 子应用销毁后重定向逻辑影响其他子应用 + +可能原因，出现该问题的原因是子应用未正常销毁，当子应用未正常销毁时，其路由监听事件也未跟随子应用的销毁而销毁 + +> React 应用解决方案 + +- 需要保证渲染的节点和销毁的节点为同一个节点，否则导致 React 组件销毁不正常，[ReactDOM.unmountComponentAtNode API 使用说明](https://reactjs.org/docs/react-dom.html#unmountcomponentatnode) +- 这里需要注意的是子应用的入口类型，如果子应用是构建为 js 入口时，则不存在 html 模板，可以直接将 dom 作为挂载点。但也需要保证渲染和销毁的为同一个节点 + +```js +export const provider = () => { + return { + render: ({ dom, basename }) => { + const root = dom ? dom.querySelector('#root') : document.querySelector('#root'); + ReactDOM.render( + + + , + root, + ); + }, + + destroy: ({ dom, basename }) =>{ + const root = dom ? dom.querySelector('#root') : document.querySelector('#root'); + ReactDOM.unmountComponentAtNode(root), + }, + }; +}; +``` + +## You are attempting to use a basename on a page whose URL path does not begin with the basename. + +> 问题原因 + +- 出现这个错误的原因一般是因为子应用没有正确的设置子应用的 basename 所导致的。 +- 子应用的 `basename` = 主应用的 `basename` + 子应用设置的激活路径 `activeWhen`，这个值会在生命周期函数中由 garfish 默认通过通过参数传递过来，直接使用即可。 + +> 解决方案 + +- 将生命周期函数中主应用传递过来的 `basename` 设置为子应用的 `basename`。[参考](/guide/demo/react#3-根组件设置路由的-basename) + +## 刷新直接返回子应用内容 + +> 问题原因 + +- 微前端是一个 SPA 应用，加载子应用是通过 SPA 模式来动态的加载其他子应用内容 +- 当访问到主应用的某个路径下激活子应用时是不存在这个路径下的静态资源的，从而 failback 到主应用的内容 +- Garfish 在初始化时根据当前路径来确定加载的子应用 +- 如果在访问主应用的某个路径时来加载子应用，而这个地址已经存在一个静态资源，浏览器将会直接返回该资源 + +> 解决方案 + +- 子应用的资源地址不要和主应用上面激活路径的资源地址一致 + +## 子应用的接口和资源路径不正确 + +尽可能将子应用的接口请求和资源路径调整为绝对路径 + +1. 子应用在独立运行时，使用相对路径的接口，接口请求的路径是，当前页面域名+相对路径 +2. 但是在主应用时，子应用使用相对路径的接口，请求的路径按道理来说还是，当前域名+相对路径 + +当在微前端的场景下如果 Garfish 让子应用走「当前域名+相对路径」会发生更多的异常请求（hmr 热更新、websock、server worker ...），因为子应用的域名并不一定是与主应用一致，因此 Garfish 框架会对相对路径的资源和请求去进行修正，修正的参照物为基础域名为子应用的路径，在本地开发时可能是正常的，但是发到线上出现问题，原因在于发布到线上之后，Goofy web 为了提升子应用资源加载的性能，子应用的入口会走 CDN。因此参照的基础路径就变为了 CDN 前缀。那么此时子应用的相对路径请求就变为了 CDN 前缀。这一块做了很对权衡，因为 hmr、websock、server worker 这些内容可能难以被用户控制，所以默认走的还是修正模式。 + +## 为什么主应用仅支持 history 模式？ + +- 目前 Garfish 是通过命名空间去避免应用间的路由发生冲突的。 + +- 主应用仅支持 `history` 模式的原因在于，`hash` 路由无法作为子应用的基础路由，从而可能导致主应用和子应用发生路由冲突。 + +## 根路由作为子应用的激活条件？ + +- 有部分业务想将根路径作为子应用的激活条件，例如 `garfish.bytedance.com` 就触发子应用的渲染，由于目前子应用 **字符串的激活条件为最短匹配原则**，若子应用 `activeWhen: '/'` 表明 `'/xxx'` 都会激活。 + +- 之所以为最短匹配原则的原因在于，我们需要判断是否某个子应用的子路由被激活，如果可能是某个子应用的子路由，我们则可能激活该应用。 + +- 之所以有该限制是由于若某个子应用的激活条件为 `/`，则该应用的 `/xx` 都可能为改子应用的子路由，则可能与其他应用产生冲突，造成混乱。 + +## 子应用拿到 basename 的作用？ + +为什么推荐子应用拿通过 `provider` 传递过来的 `basename` 作为子应用的 `basename`，有些业务方在实际过程中直接通过约定形式直接在子应用增加 `basename` 已到达隔离的效果，但该使用方式可能导致主应用如果变更 `basename` 可能导致子应用无法一起变更生效。 + +例如： + +1. 当前主应用访问到 `garfish.bytedance.com` 即可访问到该站点的主页，当前 `basename` 为 `/`，子应用 vue，访问路径为 `garfish.bytedance.com/vue` + +2. 如果主应用想更改 `basename` 为 `/site`，则主应用的访问路径变为`garfish.bytedance.com/site`，子应用 vue 的访问路径变为 `garfish.bytedance.com/site/vue` + +3. 所以推荐子应用直接将 `provider` 中传递的 `basename` 作为自身应用的基础路由，以保证主应用在变更路由之后，子应用的相对路径还是符合整体变化 + +> 微前端场景下，每个子应用可能都有自己的路由场景，为保证子应用间路由不冲突，Garfish 框架将配置的 `basename` + `子应用的 activeWhen` 匹配的路径作为子应用的基路径。 + +- 若在 Garfish 上配置 `basename: /demo`，子应用的激活路径为：`/vue2`，则子应用得到的激活路径为：`/demo/vue2` +- 若子应用的激活条件为函数，在每次发生路由变化时会通过校验子应用的激活函数若函数返回 `true` 表明符合当前激活条件将触发路由激活， +- Garfish 会将当前的路径传入激活函数分割以得到子应用的最长激活路径，并将 `basename` + `子应用最长激活路径传` 给子应用参数 +- **子应用如果本身具备路由，在微前端的场景下，必须把 basename 作为子应用的基础路径，没有基础路由，子应用的路由可能与主应用和其他应用发生冲突** + +## 子应用使用 style-component 切换子应用后样式丢失 + +- 开启 Style-component 后在生产模式下 style 将会插入到 sheet 中（[React Styled Components stripped out from production build](https://stackoverflow.com/questions/53486470/react-styled-components-stripped-out-from-production-build)） +- 应用重渲染后 style 重新插入后依然，但是 sheet 未恢复 + +解决方案在使用 `style-component` 的子应用添加环境变量：`REACT_APP_SC_DISABLE_SPEEDY=true` + +### arco-design 多版本样式冲突 + +1. [Arco-design 全局配置 ConfigProvider](https://arco.design/react/components/config-provider) +2. 给子应用分别设置不同的 `prefixCls` 前缀 + +### ant-design 样式冲突 + +1. 配置 `webpack` 配置 + +```js +module.exports = { + module: { + rules: [ + { + test: /\.less$/i, + use: [ + { loader: 'style-loader' }, + { loader: 'css-loader' }, + { + loader: 'less-loader', + options: { + modifyVars: { + '@ant-prefix': 'define-prefix', // 定制自己的前缀 + }, + javascriptEnabled: true, + }, + }, + ], + }, + ], + }, +}; +``` + +2. 配置公共前缀：[antdesign-config](https://ant.design/components/config-provider/#API) + +```js +import { ConfigProvider } from 'antd'; + +export default () => ( + + + +); +``` + +## 子应用热更新问题 + +garfish 子应用热更新问题请参考 [博客](/blog/hmr) + +## 如何独立运行子应用 + +通过 `window.__GARFISH__` 可判断当前子应用是否处于微前端下，通过此变量判断何时独立运行子应用： + +```js +// src/index.tsx +import React from 'react'; +import ReactDOM from 'react-dom'; +import App from './components/App'; + +// 这能够让子应用独立运行起来，以保证后续子应用能脱离主应用独立运行，方便调试、开发 +if (!window.__GARFISH__) { + ReactDOM.render(, document.querySelector('#root')); +} +``` + +## 已有 `SPA` 应用如何改造为 garfish 子应用 + +### 场景描述 + +- 很多需要改造成微前端的 `SPA` 应用，都是已经存在的旧应用。 +- 可能需要逐步拆解应用内的部分路由，变为子应用。 +- 主应用现有路由如何与微前端路由驱动共存，是迁移过程中常遇到的。 + +### 如何逐步改造（以 `react` 为例） + +1. 增加 `id` 为 `micro-app` 的挂载点，预留给子应用挂载，`Router` 部分的内容为主应用其他路由。 +2. 主应用增加匹配到子应用路由前缀时，`Router` 内容为空。 +3. 配置子应用列表时以 `Router` 内容为空时的前缀作为子应用激活条件前缀。 + +主应用的根组件： + +```jsx + + +
+
+ +
+
+ + +``` + +routes： + +```js +export default [ + { + path: '/platform/search', + component: Search, + }, + { + // 以 /platform/micro-app 开头的应用Router都不展示内容 + path: '/platform/micro-app', + component: function () { + return null; + }, + }, + { + component: Home, + }, +]; +``` + +主入口处： + +```js +Garfish.run({ + domGetter: '#micro-app', + basename: '/platform/micro-app', + apps: [ + ... + ], +}); +``` + +## 子应用动态插入到 body 上的节点逃逸？ + +- 首先 garfish 会对每一个子应用创建一个 app container 用于包裹子应用，会创建 `__garfishmockhtml__`、 `__garfishmockbody__` 等 mock 节点。 +- 对于在子应用运行过程中动态添加到 body 上的节点（如 drawer 组件），garfish 并未 + 将此类节点移动到 mock 的 `__garfishmockbody__` 中，原因是有些组件库会计算在 dom 层级中的位置，所以目前 garfish 会主动让其逃逸到上层。 +- 在子应用运行过程中动态添加到 body 上的节点在子应用卸载时，garfish 并不会默认回收其 DOM 副作用，需要用户主动在组件的销毁回调里触发 dom 的回收，防止 DOM 副作用未销毁带来的影响。 + +## 子应用 addEventListener 注册的事件监听在子应用卸载后并未销毁 + +- 若子应用默认开启了缓存模式，在子应用卸载时会保留应用的上下文，不会默认清除 addEventListener 注册的事件监听，这是因为再次渲染该子应用时 garfish 只会执行 render 函数，因此子应用的副作用不会随意被清除。 + +- 这种情况建议用户在组件的销毁函数里面手动释放组件的副作用，若有些逻辑确实需要清除，并且需要保证应用可用性可以将 cache 设置成 false。 + +## garfish 缓存模式 + +- garfish 目前默认启用了缓存模式，在缓存模式下 garfish 会保留应用的上下文，且不会重新执行所有代码，只会执行 render 和 destory 函数，因此应用的性能将得到很大的提升。 + +- 在缓存模式下 garfish 只会隔离环境变量和样式，子应用卸载时会保留应用的上下文，不会默认清除子应用的副作用。若业务存在需要销毁的副作用，一般来说建议用户在组件的销毁函数里面手动释放组件的副作用，如果有些逻辑确实需要清除，并且需要保证应用可用性可以把 cache 设置成 false。 + +## JS 错误上报 Script error 0 + +- 一般错误收集的工具都是通过： + - `window.addEventListener('error', (...args) => { console.log(args) })` + - `window.addEventListener('unhandledrejection', (...args) => { console.log(args) })` +- 如果能打印出 error 对象，但是只能拿到类似 Script error 0. 这类信息。说明当前 js error 跨域了【由于浏览器跨域的限制，非同域下的脚本执行抛错，捕获异常的时候，不能拿到详细的异常信息，只能拿到类似 Script error 0. 这类信息】。通常跨域的异常信息会被忽略，不会上报。可以通过一下方法验证是否跨域（如果输出 Script error 0. 则为跨域） + +> 解决方案 + +由于浏览器跨域的限制，非同域下的脚本执行抛错，捕获异常的时候，不能拿到详细的异常信息，只能拿到类似 Script error 0. 这类信息。通常跨域的异常信息会被忽略，不会上报。解决方案： 所有 ``，设置该属性后对应的 script 内容将不会运行在 commonjs 环境，对应的环境变量也会正常的插入到子应用的 window 上 + +## SyntaxError: Identifier 'exports' has already been declared + +> 问题概述 + +这个问题其实和上面那个 cdn 的问题，原因是一样的，由于 garfish 会注入一个 exports 变量，而子应用某个脚本（比如 vite 自己的热更引入的`react-refresh-runtime.development.js`）的代码也写了类似`const exports = {}`的代码，导致出现重复声明而报错。 + +> 解决方案 + +解决办法还是和上面加`no-entry`一样，不会注入 commonjs 相关的环境变量，但是，考虑到某些脚本可能是构建工具默认注入的，无法修改 script 标签，所以可以在 html 入口处加入以下配置代码来达到同样的效果（以 vite 的`react-refresh`为例）： + +```html + + + + vue sub app + + + + + +
+ + + +``` + +## ESModule + +Garfish 核心库默认支持 esModule，但是需要关掉 vm 沙箱或者为快照沙箱时，才能够使用。 + +```js +Garfish.run({ + ... + apps: [ + { + name: 'vue'， + activeWhen: '/vue', + entry: 'http://localhost:8080', + sandbox: { + open: false, + // snapshot: true, 或者只开启快照沙箱 + }, + }, + ], +}) +``` + +如果需要在 vm 沙箱下开启 esModule 的能力，可以使用 `@garfish/es-module` 插件。 + +> `@garfish/es-module` 会在运行时分析子应用的源码做一层 esModule polyfill，但他会带来严重的首屏性能问题，如果你的项目不是很需要在 vm 沙箱下使用 esModule 就不应该使用此插件。 + +> 在短期的规划中，为了能在生产环境中使用，我们会尝试使用 wasm 来优化整个编译性能。在未来如果 [module-fragments](https://github.com/tc39/proposal-module-fragments) 提案成功进入标准并成熟后，我们也会尝试使用此方案，但这需要时间。 + +```js +import { GarfishEsModule } from '@garfish/es-module'; + +Garfish.run({ + ... + plugins: [GarfishEsModule()], +}) +``` + +> 提示：当子项目使用 `vite` 开发时，你可以在开发模式下使用 esModule 模式，生产环境可以打包为原始的无 esModule 的模式。 + +## 子应用堆栈信息丢失、sourcemap 行列信息错误 + +> 问题背景 + +微前端场景下，存在沙盒机制，基于 eval 和 new Function 的形式去实现沙箱机制，在手动执行代码的情况下，会产生堆栈丢失、sourcemap 还原错行等问题。 + +> 解决方案 + +可通过增加如下 webpack 配置解决： + +```js +// webpack.config.js +const webpack = require('webpack'); + +config.plugins = [ + new webpack.BannerPlugin({ + banner: 'Micro front-end', + }); +] +``` + +具体原因可参考 [博客](/blog/sourcemap) diff --git a/website-new/docs/issues/webComponent.md b/website-new/docs/issues/webComponent.md new file mode 100644 index 000000000..4929ed2f1 --- /dev/null +++ b/website-new/docs/issues/webComponent.md @@ -0,0 +1,241 @@ +--- +title: 使用 Web component（beta） +slug: /guide/develop/webComponent +order: 1 +--- + +本节主要从主应用视角出发，通过 `Web Component` 概览性描微前端应用，Web Component 接入方式特点： + +- 便于与主应用框架结合使用，加载微前端应用像加载组件一样简单 +- 支持设置子应用 Loading 中间态、错误态占位内容 +- 可以与路由驱动模式一起使用 + +## 主应用 + +### 安装依赖 + +```bash npm2yarn +npm install garfish --save +``` + +### 入口处注册 Web Component + +```js +// index.js（主应用入口处） +import { defineCustomElements } from 'garfish'; + +// 定义 WebComponent Tag 为“micro-portal”，并指定 loading 时的内容 +defineCustomElements('micro-portal', { + loading: ({ isLoading, error, pastDelay }) => { + let loadingElement = document.createElement('div'); + // 渲染过程中发生异常，展示异常内容 + if (error) { + loadingElement.innerHTML = `load app get error: ${error.message}`; + return loadingElement; + } + // 渲染中，并且符合延迟时间（避免 loading 闪退） + if (pastDelay && isLoading) { + loadingElement.innerHTML = `loading`; + return loadingElement; + } + return null; + }, +}); +``` + +### 分配路由给微前端应用 + +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; + + + + +```jsx +import React from 'react'; +import { BrowserRouter, Route, Link, Switch } from 'react-router-dom'; + +function VueApp(basename) { + // name: 子应用名称 + // entry: 子应用入口资源地址，可以为 HTML、或 JS + // basename: 子应用路由的基础路径 + return ( + + ); +} + +function App() { + return ( + + VueApp + + // 分配一个路由给 vue 应用 + VueApp('/vue-app')}> + + + ); +} +``` + + + + +> 提供 ReactApp 的 Vue 组件 + +```html + + + + + +``` + +> 将 ReactApp 组件添加到路由中 + +```js +// index.js +import Vue from 'vue'; +import VueRouter from 'vue-router'; +import ReactApp from './component/ReactApp.vue'; + +const router = new VueRouter({ + mode: 'history', + base: '/', + routers: [{ path: '/react-app', component: ReactApp }], +}); + +new Vue({ + router, + store, + render: (h) => h(App), +}).$mount('#app'); +``` + + + + +## 子应用 + +### 安装依赖 + +```bash npm2yarn +npm install @garfish/bridge-react --save +``` + +### 通过 Bridge 函数包装子应用 + + + + +```jsx +import { BrowserRouter, Switch, Route, Link } from 'react-router-dom'; +import { reactBridge } from '@garfish/bridge-react'; + +function App({ basename }) { + return ( + // 根组件使用传递过来的 basename，作为应用的基础路径 + + Home + + + + + + + ); +} + +export const provider = reactBridge({ + rootComponent: App, + domElementGetter: '#root', // 应用的挂载点，如果子应用打包为 JS 入口，可不填写 +}); +``` + + + + +```js +import App from './App.vue'; +import { vueBridge } from '@garfish/bridge-vue-v2'; + +function newRouter(basename) { + const router = new VueRouter({ + router, + mode: 'history', + base: basename, + routes: [{ path: '/', component: HelloGarfish }], + }); + return router; +} + +export const provider = vueBridge({ + rootComponent: App, + appOptions: ({ basename }) => { + const router = newRouter(basename); + return { + store, + router, + el: '#app', + }; + }, +}); +``` + + + + +### 调整子应用的构建配置 + + + + +```js +// webpack.config.js +const webpack = require('webpack'); + +module.exports = { + output: { + // 需要配置成 umd 规范 + libraryTarget: 'umd', + // 修改不规范的代码格式，避免逃逸沙箱 + globalObject: 'window', + // 请求确保每个子应用该值都不相同，否则可能出现 webpack chunk 互相影响的可能 + jsonpFunction: 'vue-app-jsonpFunction', + // 保证子应用的资源路径变为绝对路径，避免子应用的相对资源在变为主应用上的相对资源，因为子应用和主应用在同一个文档流，相对路径是相对于主应用而言的 + publicPath: 'http://localhost:8000', + }, + plugin: [ + // 保证错误堆栈信息及 sourcemap 行列信息正确 + new webpack.BannerPlugin({ + banner: 'Micro front-end', + }) + ], + devServer: { + // 保证在开发模式下应用端口不一样 + port: '8000', + headers: { + // 保证子应用的资源支持跨域，在线上后需要保证子应用的资源在主应用的环境中加载不会存在跨域问题（**也需要限制范围注意安全问题**） + 'Access-Control-Allow-Origin': '*', + }, + }, +}; +``` + + + diff --git a/website-new/docs/plugins/__meta__.md b/website-new/docs/plugins/__meta__.md new file mode 100644 index 000000000..bfb9a49c7 --- /dev/null +++ b/website-new/docs/plugins/__meta__.md @@ -0,0 +1,5 @@ +--- +title: garfish-plugins +collapsed: false +order: 1 +--- diff --git a/website-new/docs/plugins/es-module.md b/website-new/docs/plugins/es-module.md new file mode 100644 index 000000000..b29767638 --- /dev/null +++ b/website-new/docs/plugins/es-module.md @@ -0,0 +1,7 @@ +--- +title: Garfish es-module plugins +slug: /garfish-plugins/es-module.md +order: 1 +--- + +## garfish es-module plugin diff --git a/website-new/docs/plugins/plugins.md b/website-new/docs/plugins/plugins.md new file mode 100644 index 000000000..ed5ffe348 --- /dev/null +++ b/website-new/docs/plugins/plugins.md @@ -0,0 +1,7 @@ +--- +title: Garfish 插件 +slug: /garfish-plugins +order: 2 +--- + +## Garfish 插件 diff --git a/website-new/docs/public/rspress-dark-logo.png b/website-new/docs/public/rspress-dark-logo.png new file mode 100644 index 0000000000000000000000000000000000000000..928bcc9169c8c0b3c747e0d15c84267b609a94e7 GIT binary patch literal 6296 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 OIGDi94XdCoQU3u6KgfFk literal 0 HcmV?d00001 diff --git a/website-new/docs/public/rspress-light-logo.png b/website-new/docs/public/rspress-light-logo.png new file mode 100644 index 0000000000000000000000000000000000000000..1e3442eec5b42eac4d0bae484e4c2eebd1ea9e1a GIT binary patch literal 6379 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 literal 0 HcmV?d00001 diff --git a/website-new/package.json b/website-new/package.json new file mode 100644 index 000000000..be99347bc --- /dev/null +++ b/website-new/package.json @@ -0,0 +1,16 @@ +{ + "name": "rspress-doc-template", + "version": "1.0.0", + "private": true, + "scripts": { + "dev": "rspress dev", + "build": "rspress build", + "preview": "rspress preview" + }, + "dependencies": { + "rspress": "^1.32.0" + }, + "devDependencies": { + "@types/node": "^16" + } +} diff --git a/website-new/rspress.config.ts b/website-new/rspress.config.ts new file mode 100644 index 000000000..13921a55f --- /dev/null +++ b/website-new/rspress.config.ts @@ -0,0 +1,31 @@ +import * as path from 'path'; +import { defineConfig } from 'rspress/config'; + +export default defineConfig({ + root: path.join(__dirname, 'docs'), + title: 'Garfish', + description: + '包含构建微前端系统时所需要的基本能力，任意前端框架均可使用。接入简单，可轻松将多个前端应用组合成内聚的单个产品', + icon: 'https://lf3-static.bytednsdoc.com/obj/eden-cn/dhozeh7vhpebvog/open-garfish/icons/icon.png', + logo: { + light: + 'https://lf3-static.bytednsdoc.com/obj/eden-cn/dhozeh7vhpebvog/open-garfish/icons/garfish-icon.png', + dark: 'https://lf3-static.bytednsdoc.com/obj/eden-cn/dhozeh7vhpebvog/open-garfish/icons/garfish-icon.png', + }, + themeConfig: { + socialLinks: [ + { + icon: 'github', + mode: 'link', + content: 'https://github.com/bytedance/garfish', + }, + ], + }, + builderConfig: { + source: { + alias: { + '@components': path.join(__dirname, 'src/components'), + }, + }, + }, +}); diff --git a/website-new/src/components/Highlight/index.js b/website-new/src/components/Highlight/index.js new file mode 100644 index 000000000..d3e4f8dd3 --- /dev/null +++ b/website-new/src/components/Highlight/index.js @@ -0,0 +1,16 @@ +import React from 'react'; + +export default function Highlight({ children, color }) { + return ( + + {children} + + ); +} diff --git a/website-new/src/components/TeamProfileCards/index.jsx b/website-new/src/components/TeamProfileCards/index.jsx new file mode 100644 index 000000000..d077671ec --- /dev/null +++ b/website-new/src/components/TeamProfileCards/index.jsx @@ -0,0 +1,76 @@ +import React from 'react'; +import Translate from '@docusaurus/Translate'; +import Link from '@docusaurus/Link'; +import { members } from '@site/src/data/team'; + +function WebsiteLink({to, children}) { + return ( + + {children || ( + website + )} + + ); +} + +function TeamProfileCard({ className, name, children, githubUrl, username, avatar }) { + return ( +
+
+
+
+ {username} +
+

{name}

+
+
+
+
{children}
+ {/*
+
+ {githubUrl && ( + + GitHub + + )} +
+
*/} +
+
+ ); +} + +function TeamProfileCardCol(props) { + return ( + + ); +} + +export function ActiveTeamRow() { + members.sort((pre, next)=>{ + return pre.username.charCodeAt(0) - next.username.charCodeAt(0); + }); + + return ( +
+ {members.map(member => { + const { name, username, description = '', ...rest } = member; + return ( + + + {description} + + + ); + })} +
+ ); +} diff --git a/website-new/src/components/config/_basename.mdx b/website-new/src/components/config/_basename.mdx new file mode 100644 index 000000000..294d351f5 --- /dev/null +++ b/website-new/src/components/config/_basename.mdx @@ -0,0 +1,8 @@ + + +- Type: string +- 子应用的基础路径，可选，默认值为全局 [basename](/api/run#basename)； +- 通过路由驱动自动加载子应用时实际传递给子应用的 basename 为 `basename + activeWhen` 计算的值 +- 若手动载入渲染应用时 `basename` 为实际传入的值 +- 通过 [provider 函数](/guide/start#2导出-provider-函数) 的 `basename` 参数透传给子应用，子应用需要将 basename 设置为相应子应用的基础路由，这是必须的； +- [为什么子应用需要设置 basename ?](/issues#子应用拿到-basename-的作用) diff --git a/website-new/src/components/config/_domGetter.mdx b/website-new/src/components/config/_domGetter.mdx new file mode 100644 index 000000000..84d5a3687 --- /dev/null +++ b/website-new/src/components/config/_domGetter.mdx @@ -0,0 +1,16 @@ + + +- Type: interfaces.DomGetter + +```ts +export type DomGetter = + | string + | (() => Element | null) + | (() => Promise); +``` + +- 子应用的默认挂载点，可选，没有默认值，若省略需要在子应用 AppInfo 中单独指定。二者同时存在时，子应用指定优先级更高； +- 当提供 `string` 类型时需要其值是 `selector`, Garfish 内部会使用 `document.querySelector(domGetter)` 去选中子应用的挂载点 +- 当提供 `string` 类型的 `domGetter` 时，子应用在触发渲染后并不会若当前文档流上并不存在挂载点，`Garfish` 框架内部在 `3s` 内轮讯是否有挂载点 +- 当提供函数时，将在子应用挂载过程中执行此函数，并期望返回一个 dom 元素； +- 若 `domGetter` 在子应用渲染时无法查询到挂载点，则会丢出 `domGetter` 无效的异常 diff --git a/website-new/src/components/config/_insulationVariable.mdx b/website-new/src/components/config/_insulationVariable.mdx new file mode 100644 index 000000000..b1eb71c3a --- /dev/null +++ b/website-new/src/components/config/_insulationVariable.mdx @@ -0,0 +1,10 @@ + + +- Type: string[] +- 在开启沙箱的情况下，沙箱的子应用的环境变量将会从主应用中继承，举例： + - 在加载子应用前，主应用有一段：`window.xxxx = 123` + - 子应用中可以获取获取主应用的环境变量 `console.log(window.xxxx)`，输出 123 + - 因为目前 `Garfish` 的主子应用环境是隔离的，但是子应用的环境继承至主应用时可能会造成一些影响不符合预期 +- 若希望在子应用某些环境变量不继承至主应用，可以使用 `insulationVariable` 配置，例如： + - `insulationVariable: ['xxxx']` + - 'xxxx' 在子应用中将不会继承至主应用，`console.log(window.xxxx)` 输出 `undefined` diff --git a/website-new/src/components/config/_protectVariable.mdx b/website-new/src/components/config/_protectVariable.mdx new file mode 100644 index 000000000..cf2ad1796 --- /dev/null +++ b/website-new/src/components/config/_protectVariable.mdx @@ -0,0 +1,6 @@ + + +- Type: string[] +- 在开启沙箱的情况下，提供使得 window 上的某些变量处于受保护状态的能力：这些值的读写不会受到沙箱隔离机制的影响，所有应用均可读取到，可选； +- 若希望在应用间共享 window 上的某些值，可将该值放置在数组中； +- 该属性与 [setGlobalValue](/api/setGlobalObject) 功能相同，推荐使用 `protectVariable` 属性，通过 `protectVariable` 可以明确的感知哪些值可能在应用间相互影响； diff --git a/website-new/src/components/config/_sandbox.mdx b/website-new/src/components/config/_sandbox.mdx new file mode 100644 index 000000000..4dc4a99a6 --- /dev/null +++ b/website-new/src/components/config/_sandbox.mdx @@ -0,0 +1,75 @@ + + +- Type: SandboxConfig | false 可选，默认值为 [全局 sandbox 配置](/api/run#sandbox)，当设置为 false 时关闭沙箱； + +- SandboxConfig： + +```ts +interface SandboxConfig { + // 是否开启快照沙箱，默认值为 false：关闭快照沙箱，开启 vm 沙箱 + snapshot?: boolean; + // 是否自动以子应用入口的域名前缀对子应用 fetch 请求的进行补齐，默认值为 false + fixBaseUrl?: boolean; + // 是否自动以子应用入口的域名前缀对相对路径资源进行前缀修正，默认值为 true，v1.15.0 版本提供 + fixStaticResourceBaseUrl?: boolean; + // 是否开启开启严格隔离，默认值为 false。开启严格隔离后，子应用的渲染节点将会开启 Shadow DOM close 模式，并且子应用的查询和添加行为仅会在 DOM 作用域内进行 + strictIsolation?: boolean; + // modules 仅在 vm 沙箱时有效，用于覆盖子应用执行上下文的环境变量，使用自定义的执行上下文，默认值为[] + modules?: Array | Record; + // disableElementtiming 1.14.4 版本提供，默认值为 false，将会给子应用元素注入 elementtiming 属性，可以通过此属性获取子应用元素的加载时间 + disableElementtiming?: boolean; + // fixOwnerDocument 1.17.2 版本提供 ，默认值 false，目前可能会存在 ownerDocument 逃逸的情况，设置为 true 之后将会避免 ownerDocument 逃逸 + fixOwnerDocument?: boolean; + // disableLinkTransformToStyle 1.18.0 版本提供 ，默认值 false，禁用掉 link 自动 transform 成 style 的行为 + disableLinkTransformToStyle?: boolean; + // excludeAssetFilter 1.18.0 版本提供，默认值为 undefined，用于过滤不需要再子应用沙箱中执行的资源例如 jsonp，url 参数为对应 script 的地址，返回 true 则会过滤掉该资源 + excludeAssetFilter?: (url: string) => boolean; +} + +type Module = (sandbox: Sandbox) => OverridesData | void; + +export interface OverridesData { + recover?: (context: Sandbox['global']) => void; + prepare?: () => void; + created?: (context: Sandbox['global']) => void; + override?: Record; +} +``` + +- 示例 + +```ts +Garfish.run({ + sandbox: { + snapshot: false, + strictIsolation: false, + // 覆盖子应用 localStorage，使用当前主应用 localStorage + modules: [ + () => ({ + override: { + localStorage: window.localStorage, + }, + }), + ], + }, +}); +``` + +:::caution +请注意： +如果你在沙箱内自定义的行为将会产生副作用，请确保在 recover 函数中清除你的副作用，garfish 将在应用卸载过程中执行 recover 函数销毁沙箱副作用，否则可能会造成内存泄漏。 +::: + +- 在什么情况下我应该关闭 sandbox ? + + > Garfish 目前已默认支持沙箱 esModule 能力，若需要在 vm 沙箱支持 esModule 应用，请使用 `@garfish/es-module` garfish 官方插件支持此能力，但这会带来严重的性能问题，[原因](/issues/#esmodule)。如果你的项目不是很需要在 vm 沙箱下运行，此时可以关闭沙箱； + +- [Garfish 沙箱机制](/guide/sandbox) + +:::info +若开启快照沙箱，请注意： + +1. 快照沙箱无法隔离主、子应用 +2. 快照沙箱无法支持多实例（同时加载多个子应用） + +::: diff --git a/website-new/src/components/config/_viteConfig.mdx b/website-new/src/components/config/_viteConfig.mdx new file mode 100644 index 000000000..b3be803a2 --- /dev/null +++ b/website-new/src/components/config/_viteConfig.mdx @@ -0,0 +1,20 @@ + +```js +// vite.config.js +export default defineConfig({ + base: 'http://localhost:3000/', + server: { + port: 3000, + cors: true, + origin: 'http://localhost:3000', + }, +}); +``` + +:::caution 【重要】注意： +1. base 提供资源绝对路径，避免相对路径带来的资源访问问题； +2. origin 提供资源绝对路径，避免相对路径带来的资源访问问题； +3. 需要将子应用沙箱关闭 `Garfish.run({ apps: [{ ..., sandbox: false }] })` +4. 子应用的副作用将会发生逃逸，在子应用卸载后需要将对应全局的副作用清除 + +::: diff --git a/website-new/src/components/config/_webpackConfig.mdx b/website-new/src/components/config/_webpackConfig.mdx new file mode 100644 index 000000000..c811320f3 --- /dev/null +++ b/website-new/src/components/config/_webpackConfig.mdx @@ -0,0 +1,46 @@ +```js +// webpack.config.js +const webpack = require('webpack'); +const isDevelopment = process.env.NODE_ENV !== 'production'; + +module.exports = { + output: { + // 开发环境设置 true 将会导致热更新失效 + clean: isDevelopment ? false : true, + filename: '[name].[contenthash].js', + chunkFilename: '[name].[contenthash].js', + // 需要配置成 umd 规范 + libraryTarget: 'umd', + // 修改不规范的代码格式，避免逃逸沙箱 + globalObject: 'window', + // webpack5 使用 chunkLoadingGlobal 代替，或不填保证 package.json name 唯一即可 + jsonpFunction: 'garfish-demo-react', + // 保证子应用的资源路径变为绝对路径 + publicPath: 'http://localhost:8080', + }, + plugin: [ + // 保证错误堆栈信息及 sourcemap 行列信息正确 + new webpack.BannerPlugin({ + banner: 'Micro front-end', + }), + ], + devServer: { + // 保证在开发模式下应用端口不一样 + port: '8000', + headers: { + // 保证子应用的资源支持跨域，在上线后需要保证子应用的资源在主应用的环境中加载不会存在跨域问题（**也需要限制范围注意安全问题**） + 'Access-Control-Allow-Origin': '*', + }, + }, +}; +``` + +:::caution 【重要】注意： + +1. libraryTarget 需要配置成 umd 规范； +2. globalObject 需要设置为 'window'，以避免由于不规范的代码格式导致的逃逸沙箱； +3. 如果你的 webpack 为 v4 版本，需要设置 jsonpFunction 并保证该值唯一（否则可能出现 webpack chunk 互相影响的可能）。若为 webpack5 将会直接使用 package.json name 作为唯一值，请确保应用间的 name 各不相同； +4. publicPath 设置为子应用资源的绝对地址，避免由于子应用的相对资源导致资源变为了主应用上的相对资源。这是因为主、子应用处于同一个文档流中，相对路径是相对于主应用而言的 +5. 'Access-Control-Allow-Origin': '\*' 允许开发环境跨域，保证子应用的资源支持跨域。另外也需要保证在上线后子应用的资源在主应用的环境中加载不会存在跨域问题（**也需要限制范围注意安全问题**）； + +::: diff --git a/website-new/src/components/lifeCycle/_afterEval.mdx b/website-new/src/components/lifeCycle/_afterEval.mdx new file mode 100644 index 000000000..03628c3e1 --- /dev/null +++ b/website-new/src/components/lifeCycle/_afterEval.mdx @@ -0,0 +1,21 @@ + + +- Type: (appInfo: AppInfo, code: string, env: `Record`, url: string, options) => void + - 该 `hook` 的参数分别为：`appInfo` 信息、`code` 执行的代码、`env` 要注入的环境变量，`url` 应用访问地址、`options` 参数选项例如 `async` 是否异步执行、`noEntry` 是否是 `noEntry` 模式； +- Kind: `sync`, `sequential` +- Previous Hook: `beforeLoad`、`afterLoad` +- Trigger: + + - 在实际执行代码后。`afterMount` 触发前触发； + - 子应用 html 内的 script 和动态创建的脚本执行时都会触发该 hook + +- 示例 + +```ts +Garfish.run({ + ..., + afterEval(appInfo) { + console.log('子应用代码执行完成', appInfo.name); + } +}) +``` diff --git a/website-new/src/components/lifeCycle/_afterLoad.mdx b/website-new/src/components/lifeCycle/_afterLoad.mdx new file mode 100644 index 000000000..5a2dc9401 --- /dev/null +++ b/website-new/src/components/lifeCycle/_afterLoad.mdx @@ -0,0 +1,19 @@ + + +- Type: async (appInfo: AppInfo, appInstance: interfaces.App) => void +- 该 `hook` 的参数分别为：应用信息、应用实例； +- Kind: `async`, `sequential` +- Trigger: + + - 在调用 `Garfish.load` 后并且子应用加载完成时触发该 `hook`； + +- 示例 + +```ts +Garfish.run({ + ..., + afterLoad(appInfo) { + console.log('子应用加载完成', appInfo.name); + } +}) +``` diff --git a/website-new/src/components/lifeCycle/_afterMount.mdx b/website-new/src/components/lifeCycle/_afterMount.mdx new file mode 100644 index 000000000..575774839 --- /dev/null +++ b/website-new/src/components/lifeCycle/_afterMount.mdx @@ -0,0 +1,22 @@ + + +- Type: (appInfo: AppInfo, appInstance: interfaces.App, cacheMode: boolean) => void + - 该 `hook` 的参数分别为：`appInfo` 信息、`appInstance` 应用实例、是否为 `缓存模式` 渲染和销毁 +- Kind: `sync`, `sequential` +- Previous Hook: `beforeLoad`、`afterLoad`、`beforeMount` +- Trigger: + + - 此时子应用 DOM 树已渲染完成，garfish 实例 `activeApps` 中已添加当前子应用 app 实例； + - 在挂载过程中，会调用应用生命周期中的 [`render` 函数](/guide/start#2导出-provider-函数)，用户可在挂载前定义相关操作； + - 若挂载过程中出现异常，会触发 [errorMountApp](/api/run#errormountapp)，同时会清除已创建的 app 渲染容器 appContainer + +- 示例 + +```ts +Garfish.run({ + ..., + afterMount(appInfo) { + console.log('子应用渲染结束', appInfo.name); + } +}) +``` diff --git a/website-new/src/components/lifeCycle/_afterUnmount.mdx b/website-new/src/components/lifeCycle/_afterUnmount.mdx new file mode 100644 index 000000000..01e0109a1 --- /dev/null +++ b/website-new/src/components/lifeCycle/_afterUnmount.mdx @@ -0,0 +1,8 @@ + + +- Type: ( appInfo: AppInfo, appInstance: interfaces.App) => void +- Kind: `sync`, `sequential` +- Trigger: + - 此时，应用在渲和运行过程中产生的副作用已清除，DOM 已卸载，沙箱副作用已清除，garfish 实例 `activeApps` 当前 app 已移除； + - 在应用销毁过程中会调用应用生命周期中的 [`destory` 函数](/guide/start#2导出-provider-函数)，用户可在销毁前定义相关操作； + - 若应用卸载过程中出现异常，会触发 [errorUnmountApp](/api/run#errorUnmountApp) diff --git a/website-new/src/components/lifeCycle/_beforeEval.mdx b/website-new/src/components/lifeCycle/_beforeEval.mdx new file mode 100644 index 000000000..1bf1fb9aa --- /dev/null +++ b/website-new/src/components/lifeCycle/_beforeEval.mdx @@ -0,0 +1,23 @@ + + +- Type: (appInfo: AppInfo, code: string, env: `Record`, url: string, options) => void + - 该 `hook` 的参数分别为：`appInfo` 信息、`code` 执行的代码、`env` 要注入的环境变量，`url` 代码的资源地址、`options` 参数选项（例如 `async` 是否异步执行、`noEntry` 是否是 `noEntry` 模式）； +- Kind: `sync`, `sequential` +- Previous Hook: `beforeMount` +- Trigger: + + - 在子应用挂载过程中、实际执行代码前触发该 hook； + - 应用 html 内的 script 和动态创建的脚本执行时都会触发该 hook + - 此时 DOM 树已添加至文档流中，子应用代码准备执行； + - 若代码执行过程中抛出异常，则将触发 [errorMountApp](/api/run#errormountapp)，否则触发 [beforeEval](/api/run#afterEval) + +- 示例 + +```ts +Garfish.run({ + ..., + beforeEval(appInfo) { + console.log('子应用代码开始执行', appInfo.name); + } +}) +``` diff --git a/website-new/src/components/lifeCycle/_beforeLoad.mdx b/website-new/src/components/lifeCycle/_beforeLoad.mdx new file mode 100644 index 000000000..36dab9d08 --- /dev/null +++ b/website-new/src/components/lifeCycle/_beforeLoad.mdx @@ -0,0 +1,20 @@ + + +- Type: async (appInfo: AppInfo, appInstance: App) => false | undefined + - 该 `hook` 的参数分别为：应用信息、应用实例； + - 当返回 `false` 时将中断子应用的加载及后续流程； +- Kind: `async`, `sequential` +- Trigger: + + - 在调用 `Garfish.load` 时触发该 `hook` + - 子应用加载前触发，此时还未开始加载子应用资源； + +- 示例 + +```ts +Garfish.run({ + ..., + beforeLoad(appInfo) { + console.log('子应用开始加载', appInfo.name); + } +``` diff --git a/website-new/src/components/lifeCycle/_beforeMount.mdx b/website-new/src/components/lifeCycle/_beforeMount.mdx new file mode 100644 index 000000000..f98521f37 --- /dev/null +++ b/website-new/src/components/lifeCycle/_beforeMount.mdx @@ -0,0 +1,23 @@ + + +- Type: (appInfo: AppInfo, appInstance: interfaces.App, cacheMode: boolean) => void + - 该 `hook` 的参数分别为：`appInfo` 信息、`appInstance` 应用实例、是否为 `缓存模式` 渲染和销毁 +- Kind: `sync`, `sequential` +- Previous Hook: `beforeEval`、`afterEval` +- Trigger: + + - 此时子应用资源准备完成，运行时环境初始化完成，准备开始渲染子应用 DOM 树； + - 在调用 `app.mount` 或 `app.show` 触发该 `hook`，用户除了手动调用这两个方法外，`Garfish Router` 托管模式还会自动触发 + - 在使用 `app.mount` 渲染应用是 `cacheMode` 为 `false`； + - 在使用 `app.show` 渲染应用是 `cacheMode` 为 `true`； + +- 示例 + +```ts +Garfish.run({ + ..., + beforeMount(appInfo) { + console.log('子应用开始渲染', appInfo.name); + } +}) +``` diff --git a/website-new/src/components/lifeCycle/_beforeUnmount.mdx b/website-new/src/components/lifeCycle/_beforeUnmount.mdx new file mode 100644 index 000000000..e7c210dea --- /dev/null +++ b/website-new/src/components/lifeCycle/_beforeUnmount.mdx @@ -0,0 +1,11 @@ + + +- Type: ( appInfo: AppInfo, appInstance: interfaces.App) => void +- Kind: `sync`, `sequential` +- Previous Hook: `beforeLoad`、`afterLoad`、`beforeMount`、`afterMount` +- Trigger: + - 在调用 `app.unmount` 或 `app.hide` 触发该 `hook`，用户除了手动调用这两个方法外，`Garfish Router` 托管模式还会自动触发 + - 在使用 `app.unmount` 渲染应用是 `cacheMode` 为 `false`； + - 在使用 `app.hide` 渲染应用是 `cacheMode` 为 `true`； + - 此时子应用 DOM 元素还未卸载，副作用尚未清除； + - 此时子应用 DOM 树已渲染完成，garfish 实例 `activeApps` 中已添加当前子应用 app 实例； diff --git a/website-new/src/components/lifeCycle/_errorLoadApp.mdx b/website-new/src/components/lifeCycle/_errorLoadApp.mdx new file mode 100644 index 000000000..e836a23e7 --- /dev/null +++ b/website-new/src/components/lifeCycle/_errorLoadApp.mdx @@ -0,0 +1,21 @@ + + +- Type: (error: Error, appInfo: AppInfo, appInstance: interfaces.App) => void + - 该 `hook` 的参数分别为：`error` 实例、 `appInfo` 信息、`appInstance` 应用实例 + - 一旦设置该 hook，子应用加载错误不会 throw 到文档流中，全局错误监听将无法捕获到； +- Kind: `sync`, `sequential` +- Trigger: + + - 在调用 `Garfish.load` 过程中，并且加载失败时触发该 `hook` + +- 示例 + +```ts +Garfish.run({ + ..., + errorLoadApp(error, appInfo) { + console.log('子应用加载异常', appInfo.name); + console.error(error); + } +}) +``` diff --git a/website-new/src/components/lifeCycle/_errorMountApp.mdx b/website-new/src/components/lifeCycle/_errorMountApp.mdx new file mode 100644 index 000000000..1ca584ecc --- /dev/null +++ b/website-new/src/components/lifeCycle/_errorMountApp.mdx @@ -0,0 +1,21 @@ + + +- Type: (error: Error, appInfo: AppInfo, appInstance: interfaces.App) => void + - 一旦设置该 hook，子应用加载错误不会 throw 到文档流中，全局错误监听将无法捕获到； +- Kind: `sync`, `sequential` +- Previous Hook: `beforeLoad`、`afterLoad`、`beforeMount`、`afterMount` +- Trigger: + + - 在渲染过程中出现异常会触发该 `hook`，子应用同步执行的代码出现异常会触发该 `hook`，异步代码无法触发 + +- 示例 + +```ts +Garfish.run({ + ..., + errorMountApp(error, appInfo) { + console.log('子应用渲染异常', appInfo.name); + console.error(error); + } +}) +``` diff --git a/website-new/src/components/lifeCycle/_errorUnmountApp.mdx b/website-new/src/components/lifeCycle/_errorUnmountApp.mdx new file mode 100644 index 000000000..6872de60c --- /dev/null +++ b/website-new/src/components/lifeCycle/_errorUnmountApp.mdx @@ -0,0 +1,20 @@ + + +- Type: (error: Error, appInfo: AppInfo, appInstance: interfaces.App)=> void + - 一旦设置该 hook，子应用销毁错误不会向上 throw 到文档流中，全局错误监听将无法捕获到； +- Kind: `sync`, `sequential` +- Trigger: + + - 在 `app.unmount` 或 `app.hide` 销毁过程中出现异常则会触发该 `hook`，用户除了手动调用这两个方法外，`Garfish Router` 托管模式还会自动触发 + +- 示例 + +```ts +Garfish.run({ + ..., + errorUnmountApp(error, appInfo) { + console.log('子应用销毁异常', appInfo.name); + console.error(error); + } +}) +``` diff --git a/website-new/src/components/lifeCycle/_onNotMatchRouter.mdx b/website-new/src/components/lifeCycle/_onNotMatchRouter.mdx new file mode 100644 index 000000000..fcee307ff --- /dev/null +++ b/website-new/src/components/lifeCycle/_onNotMatchRouter.mdx @@ -0,0 +1,19 @@ + + +- Type: (path: string)=> void + - 该 `hook` 的参数分别为：应用信息、应用实例； +- Kind: `sync`, `sequential` +- Trigger: + + - 路由发生变化当前未激活子应用且未匹配到任何子应用时触发 + +- 示例 + +```ts +Garfish.run({ + ..., + onNotMatchRouter(path) { + console.log('未匹配到子应用', path); + } +}) +``` diff --git a/website-new/src/components/sumarryImg/index.jsx b/website-new/src/components/sumarryImg/index.jsx new file mode 100644 index 000000000..543eb3df0 --- /dev/null +++ b/website-new/src/components/sumarryImg/index.jsx @@ -0,0 +1,12 @@ +import React from 'react'; + + +export function summaryImg (url) { + return ( +
+ + + +
+ ) +} diff --git a/website-new/tsconfig.json b/website-new/tsconfig.json new file mode 100644 index 000000000..936218cee --- /dev/null +++ b/website-new/tsconfig.json @@ -0,0 +1,20 @@ +{ + "compilerOptions": { + "target": "ES2020", + "lib": ["DOM", "ES2020"], + "module": "ESNext", + "jsx": "react-jsx", + "noEmit": true, + "strict": true, + "skipLibCheck": true, + "isolatedModules": true, + "resolveJsonModule": true, + "moduleResolution": "bundler", + "useDefineForClassFields": true, + "allowImportingTsExtensions": true + }, + "include": ["docs", "theme", "rspress.config.ts"], + "mdx": { + "checkMdx": true + } +}