AppHost1.0 发布

AppHost:大前端融合下的 Hybrid 开发解决方案

AppHost

目前移动端开发还处于一个高速发展的阶段,为了应对快速增长业务需求,移动开发需要更高迭代响应速度,从前期涌现出了以 React Native、Weex 为代表的 web 技术栈,到现在的 flutter 为代表的容器栈,这些跨度开发框架试图提高开发效率的同时,也拥有优秀的运行效率,目前看起来正在接近这个目标。
这些技术,加上 native 开发技术,在不同应用场景下,我们可以选择最合适的技术栈,而最古老的跨端技术方案 - Hybrid, 在中小型项目和不复杂的需求中,依然是最合适的选择,目前在网易严选主站,商品详情、促销活动、第三方页面展示还是用 Hybrid 实现的。 AppHost 提供的就是传统意义上用 web 技术为 native 开发业务功能的能力。

AppHost 是一套解决 H5 和 native 协作开发的整体框架和服务。试图解决 native 和 H5 目前迭代频繁、时间仓促造成质量不高,业务膨胀后代码混乱,两端联调困难,多端协作彼此割裂等痛点。
作为一种 JSBridge 的实现方法,AppHost 像一座桥,将 native 和 H5 开发打通
一边是提供设计良好的 native framework 和相关 protocol ,提高 native 接口的交付能力和开发质量;
一边是为 H5 开发的页面和 native 联调,提供辅助调试工具和性能调优工具,让前端开发者对 H5 in App 的调试体验像调试原生浏览器一样,从而提高质量和提升开发效率。

Hybrid 的接口开发生命周期

生命周期

这是实际工作中 JSBridge 面对的工作,很多是重复、乏味,又容易出错的。常见场景——“新需求里需要增加新的接口”的流程是这样的:

  1. 新增一个文件或者在旧文件上编写代码,新开接口和属性
  2. 在 Android、native 和 H5 共有的接口文档上补充 API 接口。如果有需要,需要升级 JSBridge 接口的版本号
  3. 将改动通知 Android、H5 等相关方
  4. 增加测试用例(testcase 应该 iOS 、Android、 QA、前端,共建测试用例)
  5. 如果有必要需要告知,QA 增加自动化测试用例
  6. 前端需要考虑版本号升级之后,需不需要对新旧 native App 做兼容实现

AppHost 处理负责 JSBridge 接口从 0 到 N 个、1岁到 5岁、出生到死亡周期,以及 JSBridge 之间的关系管理、对外提供数据支持等工作,所以它是解决方案,而不是个技术方案(如WebViewJavascriptBridge只是技术方案)。

AppHost 的功能总览

功能总览

分两部分,AppHost Core 为 native 开发提供基础模块和基本功能封装;AppHost Debug Service 为 native、H5 前端、QA 等人员提供调试服务。下面详细介绍功能。

AppHostCore

  1. webview 核心,包含常见需求的实现逻辑,包括
  • native 和 H5 的通讯协议,封装了 native 端解析、H5 端发送逻辑。native 开发人员只需要面向业务编码,然后通知 H5; H5 开发面向业务开发,只需关心两个接口。
  • 新增接口用继承 AppHostResponse 的方式实现,解决业务需求增长、代码无序膨胀的问题。特别的,支持业务接口的延迟加载,不使用的接口,不会初始化。
  • Cookie管理,最烦人的 Cookie 丢失和 Cookie 同步问题,已经内部妥善处理
  • 一些人性化的小优化。更合理的进度条、浏览历史滚动记忆、增强的 native 执行 js 代码能力、基本的 API 接口调用鉴权等等。
  1. JSBridge 接口管理
  • 独立于 App 的版本号,H5 使用特性嗅探实现新旧 App 的兼容,简单直观。
  • API 接口签名,可实现 API 参数粒度的接口升级和开关管理。
  1. 资源加载
  • 加载远程 URL,单向同步 Cookie 到 WKWebView。
  • 本地文件夹资源,可实现用离线包渲染动态页面。
  • 某些业务场景下,可实现 HTML 里的 xhr、js、css 资源请求拦截,不需要动用私有 webkit API。
  1. API 接口文档一体化和 testcase 自动化
    对于“native 为 H5 提供接口” 这件事情,如前述,需要多方的协调同步,很容易出现:接口文档过时、文档缺失、接口查找麻烦、接入新 API 不直观、测试不方便,QA 回归不充分,或者是多个环节重复写测试用例等坏情况。
    AppHost 的 API 文档模块,将这些环节需要的文档和测试用例,全部集中到开发阶段完成,后续 H5 查询的 API 文档、QA 走查用例、自动化测试,全部自动生成。保证接口文档的最新,省去多个环节的重复建设,内置的自动化测试支持,方便 QA 使用脚本回归测试。

AppHost Debug Service

  1. Remote Debugger 通过电脑浏览器提供 Debug Service
    电脑浏览器具有访问方便、可展示区域大、输入快捷方便、易于集成第三方调试工具的特点。相同的调试功能,理论上也可以集成在手机 App端,但是体验会大打折扣,是个低效的调试方案。
  2. 帮助系统和文档
    在浏览器端 Console ,实现了一个小型命令行程序,指导用户如何使用本 Remote Debugger;同时还提供 即时查询 API 接口 名称、参数解释、示例代码等功能,让你的工作流不需要切换到打开的API 文档文件或者浏览器,保持操作上下文。
  3. REPL(Read-Eval-Print Loop)环境
    Console 里实现了完整 webview 执行环境,将传统语言的探索、调试新特性的体验带到 Remote Debugger,如同 Bash 的shell prompt和 ruby 的irb那样。在这里输入的所有命令如同在远端 webview 的 console 里执行一样。当然还有Off mobileOn mobile来切换当前命令是本地执行还是远端 webview 执行。
  4. 辅助功能
    Console 提供了左侧快捷命令;内置了命令的历史记忆,实现上下箭头遍历;支持:clear,清除当前界面等功能
  5. 扩展性
  • 和 Safari 的 Develop 工具配合
    我们知道 Safari Develop 工具是在页面打开后才会出现。如果我们有个页面由 302 跳转,我们想抓到想要的请求是做不到的。接入 AppHost 之后,我们保持Safari Develop 工具打开的状态,在 Remote Debugger 输入命令 ,让当前 webview 加载初始 URL,这样我们就可以抓到从 302 跳转开始后的网络请求了。
  • 集成 weinre。
    通过:weinre -- 命令,不需要改动被调试页面的源码,即可提供 weinre 调试服务,而且一次注入当前 App 启动后全程有效,后续页面无需再注入。用这个特性,甚至可以调试第三方页面。
  • 支持 console.log。这个无需赘言,曾经的` https://jsconsole.com/ 是首选的远程调试服务。AppHost 内置此功能。
  1. 演示
    6.1 基本操作演示
    Debugger 整体使用

    6.2 查看严选首页的 onload 事件时间
    查看当前 H5 页面的 timing 数据

    6.3 使用 weinre 调试严选页面
    weinre服务

AppHost 愿景目标

AppHost 来自作者近年 webview 开发实践总结,真切的感受到这套设计在面对业务快速发展、技术重构需求、多端协作等方面的优越性,特整理分享出来,不仅面向我们以后的业务开发,也希望抛砖引玉,和各位同行共享知识,以

  1. 指导 native 端业务成长、保持 App 可扩展、可维护
  2. 辅助 H5 快速开发、性能调优,提高产品体验

在此,希望 AppHost 能帮你解决在 webview 相关开发过程中遇到的常见问题,让你更多的时间花在如何完善业务逻辑,加快 App 成长上面,为你的开发工作带来切实的帮助,避免 996,享受工作和生活乐趣。

采用AppHost 的 App 有哪些?

目前 AppHost 只有 iOS 端。其中 AppHost Core 在网易有钱上使用了 3 年多,支持了网易有钱的不断增长的业务需求,期间解决了很多 WKWebView 遇到的通有的问题。 AppHost Debug Service 目前还没有在线上系统中使用,目前正逐步将 AppHost 整体接入网易严选和网易推手。

使用指南

详细的技术方案和接入方式见以下链接

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

推荐阅读更多精彩内容

  • 链接:https://www.jianshu.com/p/fd61e8f4049e 一、简介 这部分主要介绍下 W...
    柒黍阅读 1,781评论 0 4
  • 关于 android Webview 基本使用 加载html四种方式 简单使用 在AndroidManifest....
    小面包屑阅读 5,379评论 2 13
  • 这篇博客主要来介绍 WebView 的相关使用方法,常见的几个漏洞,开发中可能遇到的坑和最后解决相应漏洞的源码,以...
    Shawn_Dut阅读 7,209评论 3 55
  • 2018年12月28日是今年最后的两天了,雪公子频频到访,今天雾仙女也翩然而至。 到处朦朦胧胧,飘飘渺渺,...
    天山青鸟阅读 340评论 0 0
  • 新年来上班的第一天,超级想辞职。忘不了临走时妈妈不舍的眼光,老妈年龄太大,最小的我是她最放心不下的。 ...
    一个碎碎念的人阅读 161评论 0 0