likes
comments
collection
share

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

作者站长头像
站长
· 阅读数 34

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

https://github.com/SAP/genera...

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

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

npm install -g yo generator-easy-ui5

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

安装完毕后,执行命令行 yo:

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

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

选择 Easy Ui5,回车。

报错:unexpected token '.'

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

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

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

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

自动生成的文件列表如下:使用 generator-easy-ui5 快速创建 SAP UI5 应用的工程结构

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

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

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

package.json 里的 devDependenciesdependencies

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

"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

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

脚本 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:

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

成功打开 SAP UI5 页面:使用 generator-easy-ui5 快速创建 SAP UI5 应用的工程结构

打开 ui5.yaml 文件,查看代理服务器配置:

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

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.

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

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

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

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

当然,我们直接在 Chrome 开发者工具 network 标签页里是看不到请求是来自 https://ui5.sap.com 的:使用 generator-easy-ui5 快速创建 SAP UI5 应用的工程结构

https://ui5.sap.com/resources...

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

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

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

更多Jerry的原创文章,尽在:"汪子熙":使用 generator-easy-ui5 快速创建 SAP UI5 应用的工程结构