关于 SAP Fiori Tools Application Modeler Page Map 功能的 app.json

Application Modeler 扩展允许 SAP UI5 开发人员可视化和更改 SAP Fiori Elements 应用程序的页面路由（页面地图），并通过清单设置(manifest settings)、注释属性(annotation properties)和 UI 灵活性更改（页面编辑器）配置各个页面。

从版本 1.10.1 开始，页面编辑器支持为基于 OData V4 的应用程序添加和维护 SAP Fiori Elements 构建块的属性。 此功能目前处于实验阶段，可能会根据客户反馈进行更改和增强。

SAP Fiori 工具 - Page Map 提供应用程序页面、导航及其使用的服务实体的可视化表示。 开发人员可以添加新的导航和页面、删除页面以及导航到相应的编辑工具。

Page Map 扩展以紧凑且独立于技术的表示法，读取并更新包含导航和页面信息的 app.json 文件。

该文件用作简单的基于文本的界面。 它是按需生成的，可以通过从“地图”节点的右键单击上下文菜单中选择“显示源代码”选项，从 SAP Fiori 侧边栏视图的应用程序建模器树视图中进行访问。

保存app.json时，应用程序的应用程序描述符（webapp/manifest.json）将自动更新，并且对webapp/manifest.json的更改将转换为app.json。

app.json 是虚拟的，不会写入项目文件夹。

Page Map 是 Application Modeler 的一部分，它提供了一种图形化的方式来展现和编辑应用的页面结构。在 Page Map 中，可以看到应用的各个页面及其相互之间的关系。开发者可以通过拖拽、编辑等操作来修改页面的结构。

app.json 是 SAP Fiori Tools 中的一个重要文件，它用于存储和管理应用的配置信息。这个文件通常会包括以下部分：

• "_version"：这个字段定义了 app.json 的版本信息。
• "sap.app"：这个字段包含了应用的元数据，比如应用的 id、title、description 等。
• "sap.ui5"：这个字段包含了 UI5 的配置信息，比如用到的模型、路由等。
• "sap.fiori"：这个字段包含了 Fiori 的配置信息，比如应用的类型等。
• "sap.platform.runtime"：这个字段包含了应用的运行时配置信息，比如应用的组件等。

以一个简单的 app.json 为例：

{
  "_version": "1.8.0",
  "sap.app": {
    "id": "com.example.app",
    "type": "application",
    "i18n": "i18n/i18n.properties",
    "title": "{{appTitle}}",
    "description": "{{appDescription}}",
    "applicationVersion": {
      "version": "1.0.0"
    }
  },
  "sap.ui5": {
    "dependencies": {
      "minUI5Version": "1.60.1",
      "libs": {
        "sap.ui.core": {},
        "sap.m": {},
        "sap.ushell": {},
        "sap.collaboration": {},
        "sap.ui.layout": {},
        "sap.uxap": {}
      }
    },
    "models": {
      "i18n": {
        "type": "sap.ui.model.resource.ResourceModel",
        "settings": {
          "bundleName": "com.example.app.i18n.i18n"
        }
      }
    },
    "routing": {
      "config": {
        "routerClass": "sap.f.routing.Router",
        "viewType": "XML",
        "viewPath": "com.example.app.view",
        "controlId": "app",
        "controlAggregation": "pages",
        "transition": "slide"
      },
      "routes": [
        {
          "pattern": "",
          "name": "home",
          "target": "home"
        }
      ],
      "targets": {
        "home": {
          "viewName": "Home",
          "viewLevel": 1
        }
      }
    }
  }
}