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

Jerry Wang

发布于 2022-03-10 19:29:24

2430

发布于 2022-03-10 19:29:24

文章被收录于专栏：Jerry的SAP技术分享Jerry的SAP技术分享

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.