SAP UI5 manifest.json 文件的 config 区域

发布时间 2023-07-01 14:19:40作者: JerryWang_汪子熙

SAP UI5 是一种用于构建企业级 Web 应用的 HTML5 用户界面技术。它提供了一套丰富的控件库,并支持 MVC(模型-视图-控制器)架构、双向数据绑定等特性。manifest.json 是 SAP UI5 应用的元数据文件,包含了应用的配置信息、依赖项、模型、路由等内容。

在 manifest.json 文件中,config 区域是一个非常重要的部分,它存储了应用的通用配置信息。在这篇文章中,我们将详细介绍 config 区域中可以维护的内容以及如何使用这些内容来配置您的 SAP UI5 应用。以下是一些 config 区域可以包含的信息:

  1. 资源路径和库配置
    config 区域可以包含资源路径和库的配置信息。这些信息有助于应用在运行时正确加载所需的库和资源。例如,可以在 config 区域中定义资源路径和库的别名,以便在应用中使用这些别名来引用资源,而无需指定完整的路径。示例:
{
  "sap.ui5": {
    "config": {
      "resourceRoots": {
        "my.custom.lib": "./custom_lib/"
      },
      "libs": {
        "sap.m": {},
        "sap.ui.commons": {},
        "my.custom.lib": {}
      }
    }
  }
}

在这个例子中,我们定义了一个名为 "my.custom.lib" 的资源根路径,并将其映射到 "./custom_lib/" 文件夹。同时,我们还引入了 "sap.m"、"sap.ui.commons" 和 "my.custom.lib" 三个库。

  1. 服务端点配置
    在实际应用中,我们可能需要与后端服务进行交互。config 区域可以用于定义服务端点,这样我们就可以在应用中方便地引用这些端点。示例:
{
  "sap.ui5": {
    "config": {
      "serviceConfig": {
        "name": "Northwind",
        "serviceUrl": "https://services.odata.org/V2/Northwind/Northwind.svc/"
      }
    }
  }
}

在这个例子中,我们定义了一个名为 "Northwind" 的服务端点,并指定了其服务 URL。之后,我们可以在应用中使用这个端点名称进行数据请求。

  1. 本地化和国际化
    config 区域还可以用于配置本地化和国际化相关信息。例如,我们可以指定应用支持的语言集,以及默认语言。示例:
{
  "sap.ui5": {
    "config": {
      "supportedLanguages": [
        "EN",
        "DE"
      ],
      "defaultLanguage": "EN"
    }
  }
}

在这个例子中,我们指定了应用支持的语言集,包括英语(EN)和德语(DE),并设置英语为默认语言。

在 SAP UI5 工程文件夹里,manifest.json 文件定义了关于应用程序的静态信息,例如应用程序的名称或各种文件的位置。它采用 JavaScript 对象表示法(JSON)格式编写¹。如果您的应用程序仍然使用应用程序配置文件,您可以跳过此部分¹。

例如,APF(Analysis Path Framework)期望组件清单中包含某些条目,该组件扩展了 sap.apf.core.Component。必须在 sap.app 命名空间中定义四个不同数据源的条目:对于数据源 AnalyticalConfigurationLocation,您必须指定分析配置文件的位置。从 Component.js 输入相对路径。以下三个数据源是预定义的,不得更改:PathPersistenceServiceRootSmartBusinessLogicalSystem。这些数据源根据您使用 SAP Business Suite 还是 SAP S/4HANA 而有所不同¹。

此外,sap.app 命名空间还包含应用程序的标题。此“标题”条目引用文本键 AnalyticalConfigurationName。当您从 APF 配置建模器导出文本池时,最新的配置标题将使用文本键 AnalyticalConfigurationName 写入 .properties 文件中。确保在 manifest.json 文件中也保持 .properties 文件的位置最新(条目“i18n”)。在运行时,此标题将显示为浏览器选项卡标题¹。

这只是一个简单的概述,您可以在 SAP 帮助门户 上查看更多详细信息。