如何在控制器中获取 UI5 框架的版本？

Question

我想在控制器内部检索 UI5 版本（例如 1.97.0-SNAPSHOT）。最简单的方法是获取sap.ui.version 的值，但它是一个全局变量，我想避免。

本以为sap.ui.VersionInfo会是一个正确的选择，但是查看它的API，我找不到任何方法，与检索UI5版本有关。

我还检查了控制器的内部结构（不是太深）和sap.ui.Device，但没有版本号。

如何在不使用全局变量的情况下检索 UI5 框架版本？

Answer 1

如果您使用的是 OpenUI5，通过sap.ui.version 访问版本字符串是使用全局引用时仍然允许的例外情况之一（请参阅"Don't use references to global names"）。但您也可以要求sap/ui/Global，然后通过myRequiredGlobal<strong>.version</strong> 访问它。

但是，对于 SAPUI5，补丁版本并不总是与 SAPUI5 内核（即 OpenUI5）的版本相同。要可靠地获得正确的 SAPUI5 版本，需要模块 sap/ui/VersionInfo。它的method load() 将返回一个用对象解析的承诺 - same as https://<em>&lt;host&gt;</em>/resources/sap-ui-version.json - 包含有关当前框架的所有信息，包括其版本。

// VersionInfo required from "sap/ui/VersionInfo"
// VersionUtil required from "sap/base/util/Version"

// Within an async function:
const { version } = await VersionInfo.load(); // version === "1.94.1" !== sap.ui.version (1.94.0)
const versionUtil = new VersionUtil(version);

如您所见，还可以将检索到的版本字符串与提供getMajor()、getMinor()、getPatch()、compareTo、inRange 等方法的module sap/base/util/Version 组合起来。

相关文档主题

• SAPUI5：https://ui5.sap.com/#/topic/91f021426f4d1014b6dd926db0e91070
• OpenUI5：https://openui5.hana.ondemand.com/topic/91f021426f4d1014b6dd926db0e91070

---

⚠️ 已知问题

在独立 UI5 应用（例如使用ui5 build self-contained -a 构建）中使用模块sap/ui/VersionInfo 时，生成的resources/sap-ui-version.json 中的顶部version 值是应用版本 而不是框架的版本。在撰写本文时，独立应用应使用sap.ui.version，但是，如上所述，在 SAPUI5 的情况下，它不会报告确切的补丁级别。

请参阅issue SAP/ui5-tooling#353。