使用 generator-easy-ui5 快速创建 SAP UI5 应用的工程结构

generator-easy-ui5 的 Github 仓库地址：

​​https://github.com/SAP/generator-easy-ui5​​

该工具是为了简化 SAP UI5 应用创建而设计的。

使用下面的命令行安装这个工具：

npm install -g yo generator-easy-ui5

安装完毕后，执行命令行 yo：

如果看到上图的输出，说明 generator 安装成功了。

选择 Easy Ui5，回车。

报错：unexpected token '.'

应该选择 ​​@sap/fiori​​​, 然后显示一个创建向导，逐一回复向导的问题，按​​回车​​键进入下一向导项。

自动生成的文件列表如下：

确保最后看到 ​​Application generated successfully​​ 的消息：

来看看 ​​generator-easy-ui5​​ 都帮助我们自动生成了哪些文件。

package.json 里的 ​​devDependencies​​​ 和 ​​dependencies​​：

"devDependencies": {
    "@ui5/cli": "^2.11.1",
    "@ui5/fs": "^2.0.6",
    "@ui5/logger": "^2.0.1",
    "@sap/ux-ui5-tooling": "1",
    "rimraf": "3.0.2"
  },
  "ui5": {
    "dependencies": [
      "@sap/ux-ui5-tooling"
    ]
  }

script 区域有很多 ​​fiori​​​ 命令行，来自 ​​@sap/ux-ui5-tooling​​：

脚本 start 和 start-local 的区别，就在于使用 ​​ui5.yaml​​​ 还是 ​​ui5-local.yaml​​:

"start": "fiori run --open 'index.html'",
"start-local": "fiori run --config ./ui5-local.yaml --open 'index.html'",

运行 ​​npm run start​​:

成功打开 SAP UI5 页面：

打开 ​​ui5.yaml​​ 文件，查看代理服务器配置：

specVersion: '1.0'
metadata:
  name: 'project1'
type: application
ui5Theme: sap_fiori_3
server:
  customMiddleware:
  - name: fiori-tools-proxy
    afterMiddleware: compression
    configuration:
      ignoreCertError: false # If set to true, certificate errors will be ignored. E.g. self-signed certificates will be accepted
      backend:
      - path: /sap/opu/odata
        url: http://localhost
      ui5:
        path: 
        - /resources
        - /test-resources
        url: https://ui5.sap.com
        version:  # The UI5 version, for instance, 1.78.1. Empty means latest version
  - name: fiori-tools-appreload
    afterMiddleware: compression
    configuration:
     port: 35729
     path: webapp

这个高亮区域的含义是，如果 SAP UI5 发起请求的 url 里包含了 ​​/resources​​​ 或者 ​​/test-resources​​​, 那么 domain 自动被替换为 ​​https://ui5.sap.com​​.

如果我们把 ui5.sap.com 改成 ui5.sap1.com, 就会看到期望中的 ​​getaddrinfo ENOTFOUND ui5.sap1.com​​ 错误：

当然，我们直接在 Chrome 开发者工具 network 标签页里是看不到请求是来自 ​​​​​​ 的：

​​https://ui5.sap.com/resources/sap-ui-core.js​​

有了这个 proxy 服务器之后，我们在 ​​index.html​​​ 里不必引入 CDN 的 SAP UI5 库，直接使用相对路径 ​​resources/sap-ui-core.js​​ 即可:

更多Jerry的原创文章，尽在："汪子熙":