Garfish.loadApp

用于手动挂载子应用，可动态控制子应用的渲染和销毁。

Garfish 支持路由驱动式的应用挂载和销毁模式，如果你的应用配置了 activeWhen, Garfish 则将自动监听路由变化并在路由命中时加载对应的子应用。这种模式属于路由驱动式的应用加载模式。如果你希望手动控制应用的加载和销毁，我们提供了 Garfish.loadApp() API 以供用户手动加载和销毁应用，这是一种更加灵活的子应用加载模式。

信息

基于路由匹配的应用加载模式会通过子应用的 activeWhen 参数在在路由变化后自动判断当前应加载的子应用；
在手动加载模式下（Garfish.loadApp），Garfish 不会根据路径匹配而是完全由开发者控制应用加载和销毁，此时应用加载不会受到 activeWhen 参数的影响；

类型

loadApp(appName: string, options?: Omit<interfaces.AppInfo, 'name'>): Promise<interfaces.App | null>;

默认值

示例

参数

name

Type: string
要加载的子应用名称，必选。
各子应用的名称应保持唯一，这是子应用的唯一标识；

提示

请确保当前要加载的子应用信息已注册。Garfish 会从已注册的 app 信息中查找同名 app，若应用信息未注册将导致应用加载失败。
应用信息注册可通过 Garfish.run()、Garfish.registerApp()、Garfish.setOptions() 三种方式注册； :::

options?

Type: Omit <interfaces.AppInfo, 'name'>
options 参数含义本质上与 registerApp 中同名参数保持一致，可选。
可移步 registerApp 查看具体参数说明；这里仅针对注意事项进行说明。

options 的作用？

这里提供 options 是允许用户在手动加载 App 时自定义当前应用的信息参数，若之前已注册过子应用，则会将已配置信息和这里的 options 参数进行 deepMerge，提供用户运行时更新 App 应用信息参数的能力；

值得注意的是，若已缓存过 App 实例，则再次加载会直接返回当前缓存的实例，同时 options 参数仍会进行 merge。若设置 cahce: false 关闭缓存，则会使用当前 merge 后的配置重新生成 App 实例信息并返回； :::

注意事项 ：
- options 中不允许传递 name 属性，只允许更新当前 App 的应用信息参数；
- options 若不传，则会默认使用已注册的应用信息参数；
- options 若传递，则会覆盖已注册应用信息中的同名属性(二者进行 deepMerge)，请确保在应用信息 merge 后 entry 入口信息参数存在，否则将会抛出错误；
- 子应用信息的更新不影响全局配置；

返回值

import Garfish from 'garfish';
import type { interfaces } from 'garfish';

let app: interfaces.App;
app = await Garfish.loadApp('vue-app', {
  cache: true,
  basename,
  domGetter: '#container',
  entry: 'http://localhost:8092',
});

loadApp 的返回值为子应用的 App 实例对象，实例对象上存在一些方法和属性，提供给开发者用于手动进行 App 的挂载、销毁及判断 App 当前应用状态等信息；

实例属性

name: string

应用名称，string。

mounted: boolean

应用是否已挂载，boolean。 true 表示已挂载，false 表示未挂载。

display: boolean

应用是否被隐藏，boolean。 true 表示显示状态，未隐藏，false 表示隐藏态。

strictIsolation: boolean

是否开启严格隔离。true 表示已开启，false 表示未开启。

isHtmlMode: boolean

是否是 html 入口模式。

appContainer: HTMLElement

应用容器

appInfo: AppInfo

应用配置信息

hooks: interfaces.AppHooks 应用生命周期钩子函数

实例方法

app.mount()
- Type
```
mount(): Promise<boolean>
```
- 示例
```
import Garfish from 'garfish';
import type { interfaces } from 'garfish';

const app = await Garfish.loadApp('vue-app', {
  cache: true,
  basename,
  domGetter: '#container',
  entry: 'http://localhost:3000',
});
await app.mount();
```
- 触发子应用的渲染流程。若应用已挂载、或正在挂载中、或正在卸载中将不会触发渲染流程；
- 在子应用渲染前将会触发 beforeMount 钩子函数，渲染完成将触发 afterMount 钩子函数并将当前挂载的应用 push 进 Garfish.activeApps。若渲染过程中出现异常将触发 errorMountApp钩子函数；
- 在此过程中将执行 provider 提供的子应用 render 函数，若 provider 函数未找到将会抛出错误。尝试解决
- mount 过程中都做了哪些事情

请注意：

对于 es module 子应用(如 Vite 应用)，路由驱动模式下默认走缓存模式。子应用不可重复使用 app.mount，应用二次渲染只能使用 app.show()；

app.unmount()
```
unmount(): boolean;
```
- 触发子应用的销毁流程。若应用正在卸载中，将不会重复卸载；
- 在子应用渲染前将会触发 beforeUnmount 钩子函数，渲染完成将触发 afterUnmount ，若销毁过程中出现异常将触发 errorUnmountApp 钩子函数；
- 应用卸载过程中会执行 provider 内部提供的 destroy 函数。卸载完成后，子应用的渲染容器将被移除、子应用的执行上下文也将被销毁，渲染过程中产生的副作用也都将会被清除，同时将子应用从 Garfish.activeApps 里移除，mounted 和 display 状态置为 false；
- unmount 过程中都做了哪些事情
app.show()
- Type
```
show(): Promise<boolean>
```
- 触发子应用的显示流程；
- 示例
```
import Garfish from 'garfish';
import type { interfaces } from 'garfish';

const app = await Garfish.loadApp('vue-app', {
  cache: true,
  basename,
  domGetter: '#container',
  entry: 'http://localhost:3000',
});
// 若已经渲染触发 show，只有首次渲染触发 mount，后面渲染都可以触发 show 提供性能
app.mounted ? app.show() : await app.mount();
```
- 触发子应用的显示流程。若应用已显示、或未挂载将不会触发应用渲染流程；
- 在子应用显示前将会触发 beforeMount 钩子函数，显示完成将触发 afterMount 钩子函数并将当前挂载的应用 push 进 Garfish.activeApps；
- 在此过程中将执行 provider 提供的子应用 render 函数，若 provider 函数未找到将会抛出错误。尝试解决
- show 过程中都做了哪些事情

请注意：

app.show() 用于触发子应用的显示流程，此过程并不是 css 中样式的显示或隐藏，show() 方法会触发子应用的 render 函数，若 render 函数中存在副作用也会再次执行；
app.show() 在应用渲染的过程中将会执行 provider 中提供的 render 函数，但与 app.mount() 不同的是，app.show() 不会创建新的执行上下文；
在基于路由驱动子应用加载模式下，若已启用缓存(cache: true)，则会默认使用 show() 触发子应用的渲染。若未开启缓存模式，则会使用 app.mount() 渲染子应用。非路由驱动模式下，由开发者控制子应用的渲染和销毁； :::

app.hide()
- Type
```
hide(): boolean;
```
- 触发子应用的隐藏流程。若应用未显示、或未挂载将不会触发应用隐藏流程；
- 在子应用隐藏前将会触发 beforeUnmount 钩子函数，隐藏完成将触发 afterUnmount 钩子函数并将当前隐藏的应用从 Garfish.activeApps 中移除；
- 在此过程中将执行 provider 提供的子应用 destory 函数。当移除完成，子应用的渲染容器也将被移除。
- hide 过程中都做了哪些事情

类型​

默认值​

示例​

参数​

name​

options?​

返回值​

实例属性​

实例方法​

类型

默认值

示例

参数

name

options?

返回值

实例属性

实例方法