开源工具 @sap/ux-ui5-tooling 介绍

SAP Fiori Tools - UI5 Tooling 包含一系列可与命令 ui5 serve 一起使用的自定义中间件，以及可与命令 ui5 build 一起使用的自定义任务。 此外，该模块公开了 cli fiori 产品，例如 fiori run 命令是 ui5 serve 命令的包装器，并提供了一些附加参数以及 fiori add deploy-config 和 fiori add flp-config 以扩展现有项目。

SAP Fiori 工具使用自定义中间件的功能来启动和预览 SAP Fiori 元素或 SAPUI5 自由式应用程序，例如 启用自动刷新、切换 SAPUI5 源的版本或提供静态资源。 从版本 1.3.0 开始，SAP Fiori 应用程序的预览行为发生了变化。 现在忽略持久 iAppState，以便在刷新应用程序时始终应用源代码更改。

如果仍想启用 iAppState，需要添加 URL 参数 fiori-tools-iapp-state=true 到浏览器 url 里，例如：

http://localhost:8080/test/flpSandbox.html?fiori-tools-iapp-state=true#masterDetail-display.

Application Reload

应用程序重载中间件允许开发人员在开发/配置 SAP Fiori 应用程序时预览它们。 每当与 SAP Fiori 应用程序相关的文件发生更改时，重新加载中间件都会刷新应用程序预览。

在 SAP UI5 项目中进行如下的 ui5.yaml 配置，再执行执行命令行 npx fiori run， 将使用默认设置启动 application reload middleware.

server:
  customMiddleware:
  - name: fiori-tools-appreload
    afterMiddleware: compression

下列配置启用后，中间件会将包含了 path parameter 的请求，转发到 back-end url 指定的后台服务器去。

- name: fiori-tools-proxy
  afterMiddleware: compression
  configuration:
    backend:
    - path: /sap
      url: https://my.backend.com:1234

Connecting to a back-end system with destination

如果后台系统被一个 Destination 隐藏了起来，可以在 ui5.yaml 里指定 Destination 信息：

- name: fiori-tools-proxy
  afterMiddleware: compression
  configuration:
    backend:
    - path: /sap
      url: https://my.backend.com:1234
      destination: my_backend

支持同时连接到多个后台系统：

- name: fiori-tools-proxy
  afterMiddleware: compression
  configuration:
    backend:
    - path: /northwind
      url: https://my.backend_2.com:1234
    - path: /sap
      url: https://my.backend.com:1234

使用 scp = true 表明连接的是一个 SAP Business Technology Platform 实例：

- name: fiori-tools-proxy
  afterMiddleware: compression
  configuration:
    backend:
    - path: /sap
      url: https://my.steampunk.com:1234
      scp: true