DevGateway 是开发期间运行的小型帮助程序,用于向 Fabric 注册本地工作负荷实例。 它告知 Fabric 服务您的前端在哪托管(在 localhost 上的 DevServer)以及哪些项目可用,这是基于您的清单文件。 运行 DevGateway 后,Fabric 可以在 iFrame 中加载 UI,并调用本地 DevServer 来读取产品和项元数据,而无需将包发布到租户。
DevGateway 的作用
- 在当前登录开发人员的特定工作区中注册本地工作负荷实例。
- 使用清单通知 Fabric 工作负荷标识和入口点。
- 将 Fabric 主机调用引导到本地环境,以便平台可以在开发过程中加载前端并识别项目。
- 与 DevServer 配合使用,后者实际上托管前端并公开配置端点。
注释
** DevGateway 不提供 Web 应用,也不会自我呈现。 而是登记你的本地实例,并将 Fabric 指向你的 DevServer 和 Manifest。
它在开发过程中如何使用清单
工作负荷在开发和生产环境中都是清单驱动的。 在开发期间:
- DevGateway 使用本地配置来宣告工作负荷的标识和入口点(如< c0>工作负荷清单中定义)。
- 然后,Fabric 调用 DevServer,通过本地终结点(例如模板的路由)提取产品清单和
/manifests,以便服务可以呈现导航、磁贴和创建体验。
这反映了发布时发生的情况,但一切都保持本地,以便快速迭代。
典型开发流
- 启动 DevServer 以在 localhost 上托管前端。
- 启动 DevGateway 并使用作为目标工作区管理员的用户登录。
- 打开 Fabric 工作区并使用工作负荷入口点;Fabric 在 iFrame 中加载 UI,并通过清单发现项。
- 编辑 UI 和清单文件,刷新以立即查看更改。
有关分步设置和开始说明,请参阅 入门教程 。
配置输入
DevGateway 根据您的模板读取本地配置文件,其中包括:
- 用于注册的目标工作区
- 本地前端终结点(您的开发服务器 URL)
- 在开发过程中使用的清单文件/文件资源的路径或引用
存储库的设置/生成脚本自动生成或更新此配置,以便 DevGateway 和 DevServer 保持同步。
故障排除提示
- 如果 UI 在 Fabric 中未打开,请确保同时启动 DevGateway 和 DevServer,并且已登录到具有所需权限的工作区。
- 如果 Fabric 无法发现项,请确认 DevServer 的清单终结点返回有效的 JSON,并且 DevGateway 将服务指向正确的 localhost URL。
- 如果缺少图标或字符串,请验证清单中的资产路径,以及 DevServer 是否提供它们。