cloud-web-corejs 1.0.54-dev.763 → 1.0.54-dev.765

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -6,9 +6,9 @@
6
6
  const state = {
7
7
  isMicro: false,
8
8
  appCode: "",
9
- menus: [],
9
+ // 主应用回调(openTab / closeTab / navigate):包内不消费,供子应用业务代码
10
+ // (表单脚本跳主应用路由)读取,不得直接摸主应用 router
10
11
  mainAdapter: null,
11
- lang: "",
12
12
  // 自治嵌入模式:主应用未下发菜单(props.menus 非数组)时置 true,
13
13
  // 子应用自拉菜单、保留自身侧边栏/页签壳,整站运行在容器内(含登录页)
14
14
  selfManaged: false,
@@ -26,9 +26,7 @@ const mutations = {
26
26
  state.isMicro = true;
27
27
  state.appCode = payload.appCode || state.appCode;
28
28
  state.selfManaged = !Array.isArray(payload.menus);
29
- state.menus = payload.menus || [];
30
29
  state.mainAdapter = payload.mainAdapter || null;
31
- state.lang = payload.lang || "";
32
30
  state.debug = !!payload.debug;
33
31
  },
34
32
  BUMP_RELOAD_SEQ: (state) => {
@@ -40,9 +38,7 @@ const mutations = {
40
38
  CLEAR_MICRO_CONTEXT: (state) => {
41
39
  state.isMicro = false;
42
40
  state.appCode = "";
43
- state.menus = [];
44
41
  state.mainAdapter = null;
45
- state.lang = "";
46
42
  state.selfManaged = false;
47
43
  state.routerPaused = false;
48
44
  state.debug = false;
@@ -247,7 +247,7 @@ const actions = {
247
247
  "SET_REGISTRY_APP_CODES",
248
248
  hostRegistryApps.map((app) => app.appCode)
249
249
  );
250
- let { subAppMenus } = dispatchMenus(rows, hostRegistryApps);
250
+ let subAppMenus = dispatchMenus(rows, hostRegistryApps);
251
251
  hostMicroRoutes = buildSubAppRoutes(hostRegistryApps, subAppMenus);
252
252
  if (hostRegistryApps.length) {
253
253
  registerSubApps(hostRegistryApps, {
@@ -285,7 +285,7 @@ function getUrlParams(url) {
285
285
  return result;
286
286
  }
287
287
 
288
- // 宿主态下归属子应用的菜单不生成本地组件路由(否则会遮住 /appCode/* 通配路由),
288
+ // 宿主态下归属子应用的菜单不生成本地组件路由(否则会遮住 /micro/appCode/* 通配路由),
289
289
  // 由子应用经 qiankun 渲染;侧边栏 handleSidebarRoutes 仍保留全量
290
290
  function isDelegatedToSubApp(route) {
291
291
  return hostRegistryApps.length > 0 && !!resolveOwner(route, hostRegistryApps);
@@ -11,6 +11,23 @@ export const FORM_MENU_TYPE = 5;
11
11
  // url 命名空间保留首段:/base/xxx 表示组件在 npm 包内(@base/views/xxx)
12
12
  export const BASE_SEGMENT = "base";
13
13
 
14
+ /**
15
+ * 微前端固定前缀:访问路径形如 /micro/<appCode>/<来源>/<组件路径>。
16
+ * 用固定前缀而非"首段即 appCode",是为了让归属命名空间与主应用自身的
17
+ * 一级视图目录(/user、/pmd、/yx…)结构性隔离——否则注册一个与视图目录
18
+ * 同名的 appCode 会劫持主应用整棵子树,且新增视图目录还会反向撞掉已注册的应用。
19
+ */
20
+ export const MICRO_SEGMENT = "micro";
21
+
22
+ /**
23
+ * 本机调试命名空间:/micro_debug/<appCode>/... 与 /micro/<appCode>/... 归属相同、
24
+ * 菜单相同、组件解析相同,**只有 entry 不同**(正式取注册表,调试取约定端口)。
25
+ * 把"调试还是正式"编码进路径而非存储,是为了让调试态无状态——不会残留在
26
+ * localStorage 里跨天生效,刷新/分享/多标签页的行为都由 URL 自身决定。
27
+ */
28
+ export const MICRO_DEBUG_SEGMENT = "micro_debug";
29
+
30
+ const MICRO_SEGMENTS = [MICRO_SEGMENT, MICRO_DEBUG_SEGMENT];
14
31
  const BASE_VIEW_PREFIX = "@base/views";
15
32
  const APP_CODE_REG = /^[A-Za-z][A-Za-z0-9_-]*$/;
16
33
 
@@ -29,19 +46,62 @@ export function getAccessPath(menu) {
29
46
  /**
30
47
  * 取路径首段(不含查询串);@ 开头的存量组件路径无首段语义,返回 ""
31
48
  */
32
- export function getFirstSegment(path) {
49
+ function getFirstSegment(path) {
50
+ return getSegments(path)[0] || "";
51
+ }
52
+
53
+ /** 切分路径为段数组(不含查询串);@ 开头的存量组件路径无首段语义,返回 [] */
54
+ function getSegments(path) {
33
55
  if (!path || typeof path !== "string" || path.startsWith("@")) {
34
- return "";
56
+ return [];
35
57
  }
36
- return path.split("?")[0].split("/").filter(Boolean)[0] || "";
58
+ return path.split("?")[0].split("/").filter(Boolean);
37
59
  }
38
60
 
39
61
  /**
40
- * 解析菜单归属:访问路径首段命中注册表 appCode 则归属该子应用,
41
- * 否则(空 / base / 未命中)归主应用,返回 ""。
62
+ * 取访问路径里的归属 appCode:仅 /micro/<appCode>/... 或
63
+ * /micro_debug/<appCode>/... 形态才有归属,其余(主应用自身路由、
64
+ * /base 命名空间、裸路径)一律返回 ""。
65
+ */
66
+ export function getOwnerSegment(path) {
67
+ const segs = getSegments(path);
68
+ if (segs.length < 2 || MICRO_SEGMENTS.indexOf(segs[0]) < 0) return "";
69
+ return segs[1];
70
+ }
71
+
72
+ /**
73
+ * 切换访问路径的微前端命名空间(/micro/ ⇄ /micro_debug/),非微前端路径原样返回。
74
+ * 用途:主应用在调试命名空间下装载子应用时,把下发的菜单路径一并换过去——
75
+ * 子应用据此生成的路由才与浏览器 hash 对得上(主子路径始终保持一致)。
76
+ */
77
+ export function swapMicroNamespace(path, debug) {
78
+ const segs = getSegments(path);
79
+ if (segs.length < 2 || MICRO_SEGMENTS.indexOf(segs[0]) < 0) return path;
80
+ const target = debug ? MICRO_DEBUG_SEGMENT : MICRO_SEGMENT;
81
+ if (segs[0] === target) return path;
82
+ return "/" + target + stripFirstSegment(path);
83
+ }
84
+
85
+ /**
86
+ * 按调试与否重写整条菜单的访问路径命名空间(浅拷贝,不改原对象)。
87
+ * route 有值改 route,否则改 url——与 getAccessPath 的取值口径一致;
88
+ * 单字段写法里 url 同时是组件路径,但 resolveComponentPath 对两个命名空间
89
+ * 都会剥前缀,所以换过去不影响组件解析。
90
+ */
91
+ export function swapMenuNamespace(menu, debug) {
92
+ if (!menu) return menu;
93
+ const field = menu.route ? "route" : "url";
94
+ const swapped = swapMicroNamespace(String(menu[field] || ""), debug);
95
+ if (swapped === menu[field]) return menu;
96
+ return Object.assign({}, menu, { [field]: swapped });
97
+ }
98
+
99
+ /**
100
+ * 解析菜单归属:访问路径的 /micro/<appCode>(或 /micro_debug/<appCode>)
101
+ * 命中注册表则归属该子应用,否则(无前缀 / base / 未命中)归主应用,返回 ""。
42
102
  */
43
103
  export function resolveOwner(menu, registry) {
44
- const seg = getFirstSegment(getAccessPath(menu));
104
+ const seg = getOwnerSegment(getAccessPath(menu));
45
105
  if (!seg || seg === BASE_SEGMENT) return "";
46
106
  const apps = normalizeRegistry(registry);
47
107
  return apps.some((app) => app.appCode === seg) ? seg : "";
@@ -50,9 +110,10 @@ export function resolveOwner(menu, registry) {
50
110
  /**
51
111
  * 解析组件路径(type 0 普通菜单):
52
112
  * - "@..." 存量旧写法:url 即组件路径,原样返回;
113
+ * - /micro/<渲染方 appCode>/… 或 /micro_debug/<同>:剥掉归属两段
114
+ * (渲染方只渲染归属自己的菜单,两个命名空间同等对待);
53
115
  * - 首段 base:转 @base/views 命名空间;
54
- * - 首段等于渲染方 appCode:剥掉首段(渲染方只渲染归属自己的菜单);
55
- * - 其余原样(无前缀走渲染方 @/views;别家前缀加载失败落兜底组件)。
116
+ * - 其余原样(无前缀走渲染方 @/views;别家归属加载失败落兜底组件)。
56
117
  */
57
118
  export function resolveComponentPath(menu, rendererAppCode) {
58
119
  const url = menu && menu.url != null ? String(menu.url) : "";
@@ -60,17 +121,19 @@ export function resolveComponentPath(menu, rendererAppCode) {
60
121
  if (url.startsWith("@")) return url;
61
122
  const seg = getFirstSegment(url);
62
123
  if (!seg) return url;
124
+ if (MICRO_SEGMENTS.indexOf(seg) >= 0) {
125
+ const owner = getOwnerSegment(url);
126
+ // 归属别家、或主应用误渲染子应用菜单:原样返回,加载失败后由 MenuFallback 说明归属
127
+ if (!owner || !rendererAppCode || owner !== rendererAppCode) return url;
128
+ // 单字段写法 /micro/appA/base/xx:剥掉归属两段后可能仍带 base 命名空间,递归解析一次
129
+ // (appCode 传空,不会把 /micro/appA/micro/appA/xx 连剥两轮)
130
+ const rest = stripFirstSegment(stripFirstSegment(url));
131
+ return rest ? resolveComponentPath({ url: rest }, "") : "";
132
+ }
63
133
  if (seg === BASE_SEGMENT) {
64
134
  const rest = stripFirstSegment(url);
65
135
  return rest ? BASE_VIEW_PREFIX + rest : "";
66
136
  }
67
- if (rendererAppCode && seg === rendererAppCode) {
68
- const rest = stripFirstSegment(url);
69
- if (!rest) return "";
70
- // 单字段写法 /appA/base/xx:剥掉归属前缀后可能仍带 base 命名空间,递归解析一次
71
- // (appCode 传空,只剥一层归属前缀,不会把 /appA/appA/xx 连剥两层)
72
- return resolveComponentPath({ url: rest }, "");
73
- }
74
137
  return url;
75
138
  }
76
139
 
@@ -81,8 +144,9 @@ function stripFirstSegment(url) {
81
144
  }
82
145
 
83
146
  /**
84
- * 全量菜单按归属切分:主应用保留完整树(侧边栏整树展示),
85
- * 各子应用得到归属自己的菜单行的扁平列表(用于 props 下发生成子应用内部路由)。
147
+ * 全量菜单按归属切分,返回 { appCode: [菜单行] }。
148
+ * 主应用侧不需要切分结果——它始终用原始整树渲染侧边栏,直接用入参即可;
149
+ * 这里只产出各子应用归属自己的扁平列表(用于 props 下发生成子应用内部路由)。
86
150
  */
87
151
  export function dispatchMenus(menus, registry) {
88
152
  const apps = normalizeRegistry(registry);
@@ -102,13 +166,15 @@ export function dispatchMenus(menus, registry) {
102
166
  });
103
167
  };
104
168
  walk(menus || []);
105
- return { mainMenus: menus || [], subAppMenus };
169
+ return subAppMenus;
106
170
  }
107
171
 
108
172
  /**
109
173
  * 校验应用注册表(逻辑参数 micro_app_registry 的 paramValue)。
110
174
  * 非法条目跳过并记入 errors,绝不静默;enabled === false 的合法条目不收录也不报错。
111
- * options.reservedSegments 传各应用 @/views 一级目录名,防 appCode 撞名。
175
+ * appCode 处在 /micro/ 命名空间内,与主应用一级视图目录天然隔离,无需再防目录撞名;
176
+ * 仅保留 base(组件来源命名空间)与 micro / micro_debug(前缀自身)三个保留字。
177
+ * options.reservedSegments 可追加应用自定义保留字。
112
178
  */
113
179
  export function validateRegistry(raw, options = {}) {
114
180
  const errors = [];
@@ -123,7 +189,9 @@ export function validateRegistry(raw, options = {}) {
123
189
  if (!Array.isArray(list)) {
124
190
  return { apps: [], errors: ["注册表必须是 JSON 数组"] };
125
191
  }
126
- const reserved = [BASE_SEGMENT].concat(options.reservedSegments || []);
192
+ const reserved = [BASE_SEGMENT]
193
+ .concat(MICRO_SEGMENTS)
194
+ .concat(options.reservedSegments || []);
127
195
  const apps = [];
128
196
  const seen = {};
129
197
  list.forEach((item, index) => {
@@ -145,8 +213,16 @@ export function validateRegistry(raw, options = {}) {
145
213
  errors.push(tag + " appCode 重复: " + appCode);
146
214
  return;
147
215
  }
148
- if (item.entry == null || (typeof item.entry !== "string" && typeof item.entry !== "object")) {
149
- errors.push(tag + "(" + appCode + ")entry 缺失或格式非法");
216
+ if (typeof item.entry !== "string" || !item.entry.trim()) {
217
+ errors.push(
218
+ tag
219
+ + "("
220
+ + appCode
221
+ + ")entry 必须是非空字符串(分环境对象写法已废弃,"
222
+ + "注册表本身按环境分库;本机联调用 /"
223
+ + MICRO_DEBUG_SEGMENT
224
+ + "/ 命名空间)"
225
+ );
150
226
  return;
151
227
  }
152
228
  seen[appCode] = true;
@@ -154,8 +230,7 @@ export function validateRegistry(raw, options = {}) {
154
230
  apps.push({
155
231
  appCode: appCode,
156
232
  appName: item.appName || appCode,
157
- entry: item.entry,
158
- hasCorejs: !!item.hasCorejs,
233
+ entry: item.entry.trim(),
159
234
  enabled: true,
160
235
  });
161
236
  });
@@ -163,12 +238,48 @@ export function validateRegistry(raw, options = {}) {
163
238
  }
164
239
 
165
240
  /**
166
- * 取分环境 entry:entry 为字符串直接用;为对象按 env 取,缺省回落 production
241
+ * 解析调试开关(逻辑参数 micro_debug_enabled 的值)→ { all, codes }
242
+ * 与注册表分开承载:注册表描述"有哪些应用",本开关是环境级运维动作,
243
+ * 生命周期不同——运维开关调试不必改注册表 JSON,少一类把注册表改坏的风险。
244
+ *
245
+ * 空 / "0" / "false" / "off" → 关闭(默认,也是取值失败时的回落)
246
+ * "1" / "true" / "all" → 全部注册应用
247
+ * "appA,appB" → 仅列出的应用
248
+ */
249
+ export function parseDebugEnabled(raw) {
250
+ const value = (raw == null ? "" : String(raw)).trim();
251
+ if (!value || DEBUG_OFF_VALUES.indexOf(value.toLowerCase()) >= 0) {
252
+ return { all: false, codes: [] };
253
+ }
254
+ if (DEBUG_ALL_VALUES.indexOf(value.toLowerCase()) >= 0) {
255
+ return { all: true, codes: [] };
256
+ }
257
+ return {
258
+ all: false,
259
+ codes: value
260
+ .split(",")
261
+ .map((code) => code.trim())
262
+ .filter(Boolean),
263
+ };
264
+ }
265
+
266
+ const DEBUG_OFF_VALUES = ["0", "false", "off", "no"];
267
+ const DEBUG_ALL_VALUES = ["1", "true", "all", "on", "yes"];
268
+
269
+ /** 某应用是否允许经 /micro_debug/ 装载本机 devServer */
270
+ export function isDebugAllowed(setting, appCode) {
271
+ if (!setting || !appCode) return false;
272
+ if (setting.all) return true;
273
+ return (setting.codes || []).indexOf(appCode) >= 0;
274
+ }
275
+
276
+ /**
277
+ * 取 entry。不再支持分环境对象写法:注册表存在后端逻辑参数里,本身已按环境分库,
278
+ * 主应用连哪个后端就拿到哪份注册表——再按前端 NODE_ENV 分一次是重复机制。
279
+ * 本机联调走 /micro_debug/ 命名空间(显式、按 URL 生效),不依赖构建环境。
167
280
  */
168
- export function resolveEntry(entry, env) {
169
- if (!entry) return "";
170
- if (typeof entry === "string") return entry;
171
- return entry[env] || entry.production || "";
281
+ export function resolveEntry(entry) {
282
+ return typeof entry === "string" ? entry.trim() : "";
172
283
  }
173
284
 
174
285
  function normalizeRegistry(registry) {
@@ -73,26 +73,6 @@
73
73
  <span class="tips_1">{{ $t1('注:多个用逗号","隔开') }}</span>
74
74
  </td>
75
75
  </tr>
76
- <tr>
77
- <th>
78
- {{ $t1("参数值") }}
79
- </th>
80
- <td colspan="5">
81
- <el-form-item
82
- prop="paramValue"
83
- :rules="[{ required: false, trigger: 'blur' }]"
84
- >
85
- <el-input
86
- type="textarea"
87
- :rows="2"
88
- :placeholder="$t1('请输入内容')"
89
- size="small"
90
- v-model="logicParam.paramValue"
91
- clearable
92
- ></el-input>
93
- </el-form-item>
94
- </td>
95
- </tr>
96
76
  <tr>
97
77
  <th>{{ $t1("参数备注") }}</th>
98
78
  <td colspan="5">
@@ -120,6 +100,26 @@
120
100
  </el-form-item>
121
101
  </td>
122
102
  </tr>
103
+ <tr>
104
+ <th>
105
+ {{ $t1("参数值") }}
106
+ </th>
107
+ <td colspan="5">
108
+ <el-form-item
109
+ prop="paramValue"
110
+ :rules="[{ required: false, trigger: 'blur' }]"
111
+ >
112
+ <el-input
113
+ type="textarea"
114
+ :rows="16"
115
+ :placeholder="$t1('请输入内容')"
116
+ size="small"
117
+ v-model="logicParam.paramValue"
118
+ clearable
119
+ ></el-input>
120
+ </el-form-item>
121
+ </td>
122
+ </tr>
123
123
  <tr>
124
124
  <th>{{ $t1("创建人") }}</th>
125
125
  <td>{{ logicParam.createBy }}</td>
@@ -14,7 +14,7 @@
14
14
 
15
15
  <script>
16
16
  import settings from "@/settings";
17
- import { getFirstSegment, BASE_SEGMENT } from "@base/utils/menuAdapter";
17
+ import { getOwnerSegment, BASE_SEGMENT } from "@base/utils/menuAdapter";
18
18
 
19
19
  export default {
20
20
  name: "menuFallback",
@@ -28,14 +28,14 @@ export default {
28
28
  return meta.title || (this.$route && this.$route.path) || "";
29
29
  },
30
30
  ownerSegment() {
31
- return getFirstSegment((this.$route && this.$route.path) || "");
31
+ return getOwnerSegment((this.$route && this.$route.path) || "");
32
32
  },
33
33
  registryAppCodes() {
34
34
  let permission = (this.$store && this.$store.state.permission) || {};
35
35
  return permission.registryAppCodes || [];
36
36
  },
37
37
  foreignApp() {
38
- // 只有首段命中注册表里的别家 appCode 才算"归属别家应用";
38
+ // 只有 /micro/<appCode> 命中注册表里的别家 appCode 才算"归属别家应用";
39
39
  // 未命中(含注册表未配置)一律按组件加载失败处理,不误导去主平台
40
40
  let seg = this.ownerSegment;
41
41
  let own = settings.appCode || "";