子应用配置不需要通过 umd: true 显示区分

[maoxiaoke]

icestark 2.0 支持 umd 和 非 umd 的子应用接入，目前在使用上会造成一些困惑。比如：如果子应用是 umd 方式加载，需要在主应用中指定 umd: true，容易产生一些认知成本和使用成本。

[imsobear]

icestark 1.x 也是这个逻辑哈

[maoxiaoke]

产生差异点分析：

目前 umd 方式加载是推荐的方式，但是示例项目中，使用的是非 umd 加载的方式；同时子应用项目是使用 umd 打包，所以产生一些 gap。

措施一：修改官方示例项目，保持方式统一
措施二：通过加载资源的方式，判断资源的加载类型。改动点，通过 getGlobalProp 来判断加载后是否往 window 挂载过变量

[ClarkXia]

目前通过 loadMode 判断的结果通过 console.warn 输出，比较容易忽略，错误信息建议直接显示在页面中

[imsobear]

什么时候先提个 RFC？

[maoxiaoke]

针对上述问题以及讨论，修改方案如下：

1. 官方示例项目均修改为使用推荐的 umd 方式加载：

• 修改 react 脚手架模板 feat: 🎸 将 icestark 修改为默认 umd 方式 alibaba-fusion/materials#85
• 修改 vue 脚手架模板 feat: 🎸 set default output to umd vue-materials#31
• 修改文档错误 docs: fix demo code alibaba/ice#4085

2. 通过 loadMode 的判断结果通过 error 输出，并在页面上提示错误信息

[imsobear]

有没有可能做到不需要配置 umd: true ？

[maoxiaoke]

@imsobear #240 (comment) 这里措施二，提供了一个可行的策略。方案下需要将所有通过 jsonp 获取资源的方式，通过 fetch 的方式获取，会产生 break change，可能导致的影响是：

• 之前不跨域的应用，可能产生跨域
• ie 应用由于不支持 fetch，会造成应用崩溃

[maoxiaoke]

子应用配置不需要通过 umd: true 显示区分

背景

方案设计

方案变更

目前 icestark js资源获取混合 JSONP 和主动 fetch 两种方式。逻辑如下：

改逻辑变更如下

• 当 umd 显示指定为 true/false，保持目前加载方式不变
• 当 umd 未显示指定（同时未开启沙箱模式），框架使用 JSONP 的方式加载 js 资源

逻辑如下：

在未来使用 icestark 时，我们推荐不设置 umd

api 变更

@ice/stark-app 新增 setLibraryName 和 getLibraryName 方法

在方法用于在加载子应用时指定 umd 资源挂载到 window 的变量

// 子应用
import { setLibraryName } from '@ice/stark-app';

setLibraryName('seller');

export function  mount () {
	...
}
  
 export function unmount () {
 	...
 }

umd 加入 @deprecated

AppRoute 增加 fetchingUmd 字段

标识是否使用 jsonp 方式加载应用，默认 true

其他

1. 修改官方 demo，移除 umd 设置

2. 修改 build-plugin-icestark，默认为 ice 体系用于注入 library name