likes
comments
collection
share

SAP UI5 应用元数据文件 manifest.json 的加载和解析原理讲解试读版

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

一套适合 SAP UI5 初学者循序渐进的学习教程

本专栏计划的文章数在 300 篇左右，到 2022年9月22日为止，目前已经更新了 133 篇，专栏完成度为 44.3%.

作者简介

Jerry Wang，2007 年从电子科技大学计算机专业硕士毕业后加入 SAP 成都研究院工作至今。Jerry 是 SAP 社区导师，SAP 中国技术大使。在长达 15 年的 SAP 标准产品开发生涯里，Jerry 曾经先后参与 SAP Business ByDesign, SAP CRM, SAP Cloud for Customer, SAP S/4HANA, SAP Commerce Cloud(电商云)等标准产品的研发工作。

Jerry 工作中使用 ABAP, Java, JavaScript 和 TypeScript 进行开发, 对包括 SAP UI5 在内的多款 SAP 自研框架有深入的研究。

教程目录

说明

Jerry 从 2014 年加入 SAP成都研究院 CRM Fiori 开发团队之后开始接触 SAP UI5，曾经在 SAP 社区和 汪子熙 微信公众号上发表过多篇关于 SAP UI5 工作原理和源码解析的文章。

在 Jerry 这篇文章 对 SAP UI5 一无所知的新手，从哪些材料开始学习比较好？ 曾经提到，Jerry 也是从 SAP UI5 菜鸟一路走过来，深知只有 ABAP 开发背景的开发者，向 SAP UI5 开发领域转型的不易，因此我在业余时间设计了这份适合 SAP UI5 不同水平的学习者的学习教程，把开发一个完整的 SAP UI5 应用的流程，拆分成若干个步骤，力求每个步骤里，把涉及到的知识点都涵盖到。

这些知识点可能不像我的 UI5 源码分析系列文章那么深入，但力求做到深入浅出，重要的知识点都配上详细的截图来辅助文字的介绍，便于教程学习者的理解。

本教程每一个步骤的源代码，都存放在我的 Github 上，分别用文件夹 01，02，03 等等来标识，例如步骤 1 的源代码在这里。

SAP UI5 应用元数据文件 manifest.json 的加载和解析原理讲解试读版

每一个步骤均是前一步骤的基础上，添加了若干新特性。建议零基础或者对 SAP UI5 知之甚少的 SAP UI5 初学者，按照顺序从第一个步骤开始循序渐进地学习，把这些代码下载到本地，配合教程的文字讲解，自己动手，以加深理解。

对于已经有一定基础的 SAP UI5 开发人员，可以通过本文的目录，跳过前面一部分比较基础的章节，直接挑选对自己工作项目有关，或者包含某些知识点自己尚未掌握的章节来有针对性地学习。

大家如果对教程的每个步骤有任何疑问，欢迎在教程对应的步骤文章里给我评论，进行留言。我虽然平时开发工作很忙，但是保证会定期查看大家给我留下的评论，对于里面涉及到的技术疑问，我一定会抽时间做出解答。

本教程第 9 个步骤，我们学习了 SAP UI5 里 Component 的用法，其中提到，Component.js 的 metadata 区域即下图第 8 行开始，用于定义这个 Component 的元数据，比如 rootView，指定了该 Component 被加载之后，第一个需要被加载并渲染的 XML 视图名称，在下图例子里的名称为 sap.ui5.walkthrough.view.App.

SAP UI5 应用元数据文件 manifest.json 的加载和解析原理讲解试读版

这个名称里的 sap.ui5.walkthrough 是本教程一直使用的开发 SAP UI5 应用的命名空间，view.App 的意思是项目文件夹里有一个名叫 view 的文件夹，里面有一个 App.view.xml 文件，如下图所示：

SAP UI5 应用元数据文件 manifest.json 的加载和解析原理讲解试读版

这种方式将 Component 的元数据同其业务逻辑，比如 init 等钩子函数的实现放置在同一处，从设计层面上说没有遵循单一职责(Single Responsibility)和关注点分离(Seperation of Concerns)的准则。从道理上讲，定义 Component rootView，包括本教程后续要介绍的 SAP UI5 路由规则等声明，这些都算是静态配置，因此可以单独抽取出来，放到一个专门用于维护元数据的 JSON 文件里。

在 SAP UI5 实际项目开发中，我们采取一个名为 manifest.json 的 JSON 文件来维护 SAP UI5 Component 元数据。本教程从步骤 10 开始，也采取了这种正式的实现方法。

如下图所示，之前维护在 Component.js metadata 字段里的元数据，比如 rootView 的定义，如今已经抽取出来放在 manifest.json 文件里单独定义了。

SAP UI5 应用元数据文件 manifest.json 的加载和解析原理讲解试读版

本步骤余下步骤介绍这个 manifest.json 文件运行时是如何被 SAP UI5 框架加载并解析的。