技术指南

X5内核,解决系统webview兼容性差、加载速度慢、功能缺陷等问题

解决一切令开发者们头疼的问题,让开发者快速而轻松地开启开发之旅

解决系统webview兼容性差、加载速度慢等问题
让开发者快速而轻松地开启开发之旅

合作方X5内核下问题自查文档【网络类不附日志以后将不再处理】

【Step1】 确定问题类型。

1 页面问题:打不开白屏问题,打开异常慢问题,或者进入到错误页面。转 step2

2 ANR crash 问题。 转step7

3 证书问题 转 step 8

4 webview 设置问题。 转 step 10 //Todo

5 缓存问题。 转step15 //Todo

6 …. //Todo

【Step2】如何对比系统内核

1 对比系统webview是否打开或打开慢,或打不开。

2 webview 打开 http://debugtbs.qq.com 切换系统内核,切换后重启应用,一直有效。

3 webveiw loadurl 问题url,观察现象是否系统内核可以打开。

4 如果问题url 可以通过微信打开,微信中可以聊天框内输入debugtbs.qq.com切换。

5 如果系统内核可以打开 转 step3 , 系统内核同样打不开,可以基本确定跟X5内核无关,建议排查证书配置问题。转step4

【step3】怀疑x5问题,收集x5问题下的日志数据及截图或视频。

1 确定系统内核可以打开,切换回x5内核不可以打开。

2 如进入错误页面,点击诊断网络,截图,收集信息 error_page_result.png(图片格式不限)

3 如白屏,insspect 自主分析,排除相关js获取其他问题。转step4

【step4】inspect自主分析。

1 确保在使用X5内核的情况下,开启inspect功能,webview loadurl http://debugx5.qq.com

2 选择 [信息],勾选打开TBS内核Inpector 调试功能。)

3 调试手机USB连接PC电脑, 电脑打开chrome浏览器进入 chrome://inspect界面,确定手机正常连接

4 webview打开 问题url ,通过chrome浏览器上的inspector调试工具检查,排除相关js错误或者服务器证书异常,引起白屏。

5 如果问题依旧无法排查,请截图chrome://inspect结果 inspect_page_result.png(图片格式不限)。转 step5

【step5】X5内核下问题处理

1 x5内核下打开慢或打不开? 打开debugx5.qq.com ,选择 [代理]下 勾选http2云加速,或者强制直连选项排查问题页面是否打开或者打开慢。

2 当系统内核可以打开网页,微信和合作方app均无法打开网页,inpect 和 错误页面没有信息。可收集 x5内核日志待内核开发分析,如何抓取debugx5.qq.com网络日志 转 step6

【step6】抓取网络日志。

Step1 合作方App需要用webview打开http://debugx5.qq.com

Step2 日志功能开启功能 如图:

Step3 复现问题场景

访问出问题的页面,待复现问题出现。

Step4 日志上传:

再次进入 http://debugx5.qq.com

选择[代理] tab页面 点击日志功能栏:[日志功能关闭并上传] 提示toast上传成功。

如图:

Step5 提供guid给跟进问题的开发:

选择[信息]tab页面,下方有Guid信息如下:

Step 6 转 step14

【step7】ANR 问题,crash问题。

1 查看堆栈,明确问题产生来自内核堆栈,内核堆栈会有smtt 和 libmttwebveiw的字样。

2 java层堆栈,明确是内核调用即可, C层堆栈,收集堆栈信息如:

#01 pc 0239d5d5 /data/data/com.tencent.mobileqq/app_tbs/core_share/libmttwebview.so

#02 pc 0283c8ef /data/data/com.tencent.mobileqq/app_tbs/core_share/libmttwebview.so

#03 pc 028324df /data/data/com.tencent.mobileqq/app_tbs/core_share/libmttwebview.so

#04 pc 02833835 /data/data/com.tencent.mobileqq/app_tbs/core_share/libmttwebview.so

….

3 堆栈信息需要我们解栈,需要上报内核版本号。本地查看内核版本号可以再debugtbs.qq.com中查看版本信息,截图。

4 转Step14

【step14】上报我们一起帮你解决。

1 收集 error_page_result.png , inspect_page_result.png。

2 收集网络日志后将GUID 和QUA复制到userinfo.txt中。

3 清晰表述问题的复现步骤 1234,和复现环境,宿主,网络等信息。

4 ANR问题,Crash问题 收集堆栈信息文件,crash率占比,问题严重性(影响用户数占比),如果有复现路径,请一定告知复现路径。

debugtbs.qq.com 例子:

debugx5.qq.com 例子:

Debugx5.qq.com [信息页]