SAP|SAP UI5 初学者教程之八 - 多语言的支持试读版

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

  • SAP UI5 本地开发环境的搭建
  • SAP UI5 初学者教程之一:Hello World
  • SAP UI5 初学者教程之二:SAP UI5 的引导过程 Bootstrap
  • SAP UI5 初学者教程之三:开始接触第一个 SAP UI5 控件
  • SAP UI5 初学者教程之四:XML 视图初探
  • SAP UI5 初学者教程之五:视图控制器初探
  • SAP UI5 初学者教程之六 - 了解 SAP UI5 的模块(Module)概念
  • SAP UI5 初学者教程之七 - JSON 模型初探
说明 Jerry 从 2014 年加入 SAP成都研究院 CRM Fiori 开发团队之后开始接触 SAP UI5,曾经在 SAP 社区和“汪子熙”微信公众号上发表过多篇关于 SAP UI5 工作原理和源码解析的文章。
在 Jerry 这篇文章 对 SAP UI5 一无所知的新手,从哪些材料开始学习比较好? 曾经提到,Jerry 也是从 SAP UI5 菜鸟一路走过来,深知只有 ABAP 开发背景的开发者,向 SAP UI5 开发领域转型的不易,因此我在业余时间设计了这份适合 SAP UI5 初学者的学习教程,把开发一个完整的 SAP UI5 应用的流程,拆分成若干个步骤,力求每个步骤里,把涉及到的知识点都涵盖到。这些知识点可能不像我的 UI5 源码分析系列文章那么深入,但力求浅显易懂,便于 SAP UI5 初学者理解。
本教程每一个步骤的源代码,都存放在我的 Github 上,分别用文件夹 01,02,03 等等来标识。
SAP|SAP UI5 初学者教程之八 - 多语言的支持试读版
文章图片

每一个步骤均是前一步骤的基础上,添加了若干新特性。建议零基础或者对 SAP UI5 知之甚少的初学者,按照顺序从第一个步骤开始循序渐进地学习,把这些代码下载到本地,配合教程的文字讲解,自己动手,以加深理解。
大家如果对教程的每个步骤有任何疑问,欢迎在教程对应的步骤文章里给我评论,进行留言。
从本步骤开始,我们将 SAP UI5 控件的文本,通过单独的资源文件(Resources files)维护,以达到对多语言的支持(internationalization,简称 i18n)。
先看本文描述的步骤完成后的实现效果:
SAP|SAP UI5 初学者教程之八 - 多语言的支持试读版
文章图片

点击 Say Hello 按钮,能看到下列的消息弹出框:
SAP|SAP UI5 初学者教程之八 - 多语言的支持试读版
文章图片

通过浏览器 url 参数 ?sap-language=zh 指定加载该应用的中文版本,则英语版本里 Button 和弹出对话框的 Hello 字符,变成了对应的中文内容:你好。
SAP|SAP UI5 初学者教程之八 - 多语言的支持试读版
文章图片

本步骤的实现代码,位于我的 Github 里。
使用方法和本教程之前的步骤一致:代码克隆到本地后,进入 08 文件夹,首先执行 npm install 安装依赖,然后执行命令行 ui5 serve:
SAP|SAP UI5 初学者教程之八 - 多语言的支持试读版
文章图片

当我们看到 Server started 的提示信息后,访问 url:
http://localhost:8080/webapp/...
即可看到 UI 界面:
SAP|SAP UI5 初学者教程之八 - 多语言的支持试读版
文章图片

下面是本步骤的详细实现细节。
(1) webapp 下新建一个文件夹 i18n,里面新建一个文件 i18n.properties.
SAP|SAP UI5 初学者教程之八 - 多语言的支持试读版
文章图片

这个文件的内容是键值对(key-value pair)的集合,键值对之间通过回车区分。
第2行的语法{0} 意思是该值支持一个输入参数,运行时,{0}会被实际的输入参数替换。
注意,理论上文件夹的名称 i18n 和 文件 i18n.properties 的名称可以任意指定,只需要和后续步骤代码里使用到的路径保持一致即可。但是,按照惯例,我们一般使用默认的文件夹名称 i18n.
【SAP|SAP UI5 初学者教程之八 - 多语言的支持试读版】关于剩下的详细步骤,请参考我的教程:SAP UI5 初学者教程之八 - 多语言的支持

    推荐阅读