如何在 SAP UI5 应用中集成第三方库 :一个在移动设备上查看 Web 应用打印调试信息的小技巧

这是 Jerry 2021 年的第 43 篇文章,也是汪子熙公众号总共第 320 篇原创文章。

做 Web 开发的程序员,无论使用 SAP UI5,还是 Angular,React,Vue,每天都离不开 Chrome / Firefox 开发者工具。

Jerry 2018 年的时候,曾经写过一篇关于 Chrome 开发者工具的文章:Jerry 和您聊聊 Chrome 开发者工具

这些开发者工具虽然好用,但是当 Web 应用在移动设备上运行时,想直接在手机浏览器上查看其使用 console.log 打印出的日志和调试信息,是一件比较麻烦的事情。

比如 Jerry 之前写过一篇文章:在 Windows 笔记本上调试运行在 iOS 设备上的前端应用,介绍了如何通过远程连接的方式,直接在 Windows 电脑上,对运行在 iOS 设备 Safari 浏览器里的 Web 应用进行单步调试:

当然,如果仅仅需要在移动设备比如手机上运行一下 Web 应用,然后想查看其打印的调试信息,用上述远程调试的方式就未免大材小用了。

vConsole 是腾讯发布的一个工具库,从其获得的超过一万三千个 stars,就知道这个库的受欢迎程度:

vConsole 的一种用法是,将其库文件下载到本地后,在网页的 script 标签里引用。创建一个 VConsole 实例后,仍然采用正常的 console.log 打印调试信息或者日志。

此时渲染出的网页右下角,会出现一个绿色的 vConsole 按钮:

点击之后,能打开一个类似 Chrome 开发者工具的面板,从而在里面能够看到应用程序使用 console.log 打印出的调试信息。

然而,Jerry 的 SAP 技术交流群里,有个朋友想在 SAP UI5 应用里使用 vConsole,但是发现不工作。

这位朋友直接按照 vConsole 的教程,在 SAP UI5 应用的 index.html 里通过 script 标签引入 vConsole.

这种引入第三方库文件的做法可以工作于 Angular,React 或者 Vue,然而并不是 SAP 推荐的在 SAP UI5 里使用第三方库的方式。因为绝大多数标准的 SAP UI5 应用的使用场景,都是通过 Fiori Launchpad 作为入口来访问的。这种情况下,SAP UI5 应用的入口是 Component.js, 而不是 index.html.

正确的做法:

(1)在 SAP UI5 工程里,新建一个 lib 文件夹,把 vConsole 库文件放进去。

(2)在需要使用 vConsole 功能的控制器实现里,使用 sap.ui.define 声明 VConsole 的依赖路径。如下图标号 2 所示。这个依赖路径分为两部分,前半部分 sap/ui/demo/CombineLatest 是将该 SAP UI5 应用的命名空间 sap.ui.demo.CombineLatest 里所有的 . 替换成 / 的结果,后半部分就是 VConsole 库文件在 SAP UI5 应用中的相对路径。

(3)~(4):通过 sap.ui.define 声明的 vConsole 依赖,加载完毕后,即可在 SAP UI5 应用控制器的 JavaScript 代码里正常使用了。

最后试试效果,在手机上访问这个 SAP UI5 应用:

点击右下角的 vConsole 按钮。看到了期望中的由代码 console.log 打印出的 Hello World:

除了 Log 之外,这个 VConsole 还提供了一些其他的实用面板。

System 面板:显示当前访问应用的 Url,客户端版本,使用的网络类型:

Element 面板:能查看该应用在手机上渲染出的原生 HTML 代码。比如安卓手机上访问 SAP UI5 应用,能看到 HTML 源代码里包含 data-sap-ui-os="Android8.0.0" 的 UI5 自定义属性。

当然,在 SAP UI5 应用里使用第三方库,绝对不止本文所提到的这一种方式。

Jerry 之前曾经写过一篇文章,如果需要在 SAP UI5 里引入一个由第三方库实现的调用设备摄像头拍照的功能,也可以将第三方库封装成一个 SAP UI5 自定义控件(Custom Control). 实现细节参考我的文章:如何在SAP UI5应用里添加使用摄像头拍照的功能

本文例子的源代码:

https://github.com/wangzixi-diablo/ui5-toolset/tree/main/combineLatest

感谢阅读。

更多Jerry的原创文章,尽在:"汪子熙":


更多阅读

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 159,117评论 4 362
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,328评论 1 293
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 108,839评论 0 243
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 44,007评论 0 206
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,384评论 3 287
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,629评论 1 219
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,880评论 2 313
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,593评论 0 198
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,313评论 1 243
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,575评论 2 246
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,066评论 1 260
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,392评论 2 253
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,052评论 3 236
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,082评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,844评论 0 195
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,662评论 2 274
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,575评论 2 270

推荐阅读更多精彩内容