blocks|key|5l944|type|unstyled|text|文档+SDK+是一个独立的+SDK，不需要下载+x5+内核。|depth|inlineStyleRanges|entityRanges|entityMap|data|mutability^0^^$0|@$1|2|3|4|5|6|7|D|8|@]|9|@]]]|A|$B|-4|C|-4|3|-4]]

使用这个 SDK 是否还需要下载 X5 内核

公网版本和私有化版本有什么区别？

SDK 是否支持打开远程服务器文档？

使用这个 SDK 是否可以和 TBS SDK 一起集成？

App 首次初始化加载组件影响界面卡顿

文件缓存目录如何指定，是否可以删除

SDK 是否会上传文档内容到云端？

blocks|key|dko48|type|unstyled|text|公网指客户端网络环境，属于移动公共互联网环境，区别于专网，局域网或无网络情况的网络环境。|depth|inlineStyleRanges|entityRanges|entityMap|data|mutability^0^^$0|@$1|2|3|4|5|6|7|D|8|@]|9|@]]]|A|$B|-4|C|-4|3|-4]]

什么是公网？

blocks|key|2g362|type|unstyled|text|公网版本只能在公网环境下使用，SDK+授权打开文档需要网络环境，而私有化版本可以在任意网络下使用，打开文档不受网络限制。|depth|inlineStyleRanges|entityRanges|entityMap|data|mutability^0^^$0|@$1|2|3|4|5|6|7|D|8|@]|9|@]]]|A|$B|-4|C|-4|3|-4]]

blocks|key|dbr4u|type|unstyled|text|LicenseKey+跟客户端包名绑定，用于接入+SDK+后的授权校验等功能。在授权以后，请不要随意更改包名，若需要更换包名，需要重新申请+LicenseKey。|depth|inlineStyleRanges|entityRanges|entityMap|data|mutability^0^^$0|@$1|2|3|4|5|6|7|D|8|@]|9|@]]]|A|$B|-4|C|-4|3|-4]]

LicenseKey 有什么作用？

blocks|key|dl8oe|type|unstyled|text|查看+LicenseKey，需要账户登录以后，到客户端管理页面查看生成的+LicenseKey，请妥善保管+LicenseKey。|depth|inlineStyleRanges|entityRanges|entityMap|data|mutability^0^^$0|@$1|2|3|4|5|6|7|D|8|@]|9|@]]]|A|$B|-4|C|-4|3|-4]]

如何查看 LicenseKey？

blocks|key|fjnh9|type|unstyled|text|不支持，SDK+只支持打开本地文档，只能传入一个本地文档的路径。服务器文档需要先下载到本地，再调+SDK+打开。|depth|inlineStyleRanges|entityRanges|entityMap|data|mutability^0^^$0|@$1|2|3|4|5|6|7|D|8|@]|9|@]]]|A|$B|-4|C|-4|3|-4]]

blocks|key|8967h|type|unstyled|text|SDK+主要只支持+Android+接入，是将文档+API+和文档浏览引擎集成在一起的+SDK+包。|depth|inlineStyleRanges|entityRanges|entityMap|data|mutability^0^^$0|@$1|2|3|4|5|6|7|D|8|@]|9|@]]]|A|$B|-4|C|-4|3|-4]]

SDK 主要支持什么接入？

blocks|key|d3f4p|type|unstyled|text|SDK+集成支持的是32位、64位混合集成，也支持单独64位集成，不同位数包大小不一样，64位数+SDK+在5-10MB区间。个别小众格式单独集成，例如+DWG+格式。详情见+SDK+接入文档。|depth|inlineStyleRanges|entityRanges|offset|length|entityMap|0|LINK|mutability|MUTABLE|data|url|https://cloud.tencent.com/document/product/1645/83900^0|0|2G|8^^$0|@$1|2|3|4|5|6|7|K|8|@]|9|@$1|L|A|M|B|N]]]]|C|$D|$3|E|F|G|H|$I|J]]]]

SDK 集成有多大包大小增量？

blocks|key|6trqo|type|unstyled|text|请检查宿主（App）网络环境，是否正常打开联网功能，是否连接了代理，VPN+等网络技术，影响授权请求的正常进行。|depth|inlineStyleRanges|entityRanges|entityMap|data|mutability^0^^$0|@$1|2|3|4|5|6|7|D|8|@]|9|@]]]|A|$B|-4|C|-4|3|-4]]

SDK 集成后首次无法授权成功？

blocks|key|1oftn|type|unstyled|text|开发者如果接入了其他的文档解析方案，一般会集成+Poi+库，会跟文档+SDK+产生冲突。|depth|inlineStyleRanges|entityRanges|entityMap|data|mutability^0^^$0|@$1|2|3|4|5|6|7|D|8|@]|9|@]]]|A|$B|-4|C|-4|3|-4]]

Poi 库是否能和 SDK 一起集成？

blocks|key|6q9b8|type|unstyled|text|支持和+TBS+SDK+44286+版本（不支持文档+API+接口）以后一起集成。|depth|inlineStyleRanges|entityRanges|entityMap|data|mutability^0^^$0|@$1|2|3|4|5|6|7|D|8|@]|9|@]]]|A|$B|-4|C|-4|3|-4]]

blocks|key|d4rm7|type|unstyled|text|公网版本需要一直联网使用，离线授权版本，可以通过离线的方式授权，用户可以在专网或者无网络下打开文档。|depth|inlineStyleRanges|entityRanges|entityMap|data|mutability^0^^$0|@$1|2|3|4|5|6|7|D|8|@]|9|@]]]|A|$B|-4|C|-4|3|-4]]

使用 SDK 是否需要联网

blocks|key|7nu53|type|unstyled|text|请检查：|depth|inlineStyleRanges|entityRanges|entityMap|data|mutability^0^^$0|@$1|2|3|4|5|6|7|D|8|@]|9|@]]]|A|$B|-4|C|-4|3|-4]]

显示文件预览失败

blocks|key|4d655|type|unstyled|text|初始化接口错误码|depth|inlineStyleRanges|entityRanges|b7cns|文件打开接口错误码|n5nn|openFileReader+接口错误码为回调+actionType+==+ITbsReader.NOTIFY_ERRORCODE+时+args+的值，非0则显示文档预览失败。可按上述“显示文件预览失败”的处理方法进行排查。如未解决，请+联系我们。|offset|length|entityMap|0|LINK|mutability|MUTABLE|data|url|https://cloud.tencent.com/document/product/1645/83904^0|0|0|0|3B|4^^$0|@$1|2|3|4|5|6|7|O|8|@]|9|@]]|$1|A|3|4|5|B|7|P|8|@]|9|@]]|$1|C|3|4|5|D|7|Q|8|@]|9|@$1|R|E|S|F|T]]]]|G|$H|$3|I|J|K|L|$M|N]]]]

SDK 错误码

blocks|key|9qhs4|type|unstyled|text|首次加载组件会进入授权流程，initEngine+接口可在子线程调用，或调用+initEngineAsync+接口。|depth|inlineStyleRanges|entityRanges|entityMap|data|mutability^0^^$0|@$1|2|3|4|5|6|7|D|8|@]|9|@]]]|A|$B|-4|C|-4|3|-4]]

blocks|key|18u7h|type|unstyled|text|tempPath+为文件缓存目录，建议指定在+App+沙盒目录下，无需主动创建目录。|depth|inlineStyleRanges|entityRanges|f2q80|在关闭文件（closeFileReader+接口调用）后可以删除，删除后再次打开文件无法跳转到上次打开的位置。|entityMap|data|mutability^0|0^^$0|@$1|2|3|4|5|6|7|F|8|@]|9|@]]|$1|A|3|4|5|B|7|G|8|@]|9|@]]]|C|$D|-4|E|-4|3|-4]]

blocks|key|kp0b|type|unstyled|text|文档是本地存储读取，并解析文档渲染展示。除+SDK+初始化会进行授权请求，正常打开文件会上报文件打开次数，无其他敏感数据网络传输，详情请参见+隐私合规文档。|depth|inlineStyleRanges|entityRanges|offset|length|entityMap|0|LINK|mutability|MUTABLE|data|url|https://rule.tencent.com/rule/preview/b01dde7c-2c5b-487a-9bdd-3275dc716a83^0|0|1Z|6^^$0|@$1|2|3|4|5|6|7|K|8|@]|9|@$1|L|A|M|B|N]]]]|C|$D|$3|E|F|G|H|$I|J]]]]

腾讯浏览服务

数据隐私

TBS三方SDK自动化探索。 （1）读取三方内核版本号； （2）判断是否符合预期。 说明：出于用户的流量考虑，TBS宿主在逻辑上有后台流控，异常保护等诸多限制，反复测试情况下，经常出现无法下载、安装失败等问题，导致宿主环境异常，无法成功安装预设内核。 [YJWwWxL.png] 【三方配置方式】 解决了宿主的环境模拟问题，我们再来看看看三方如何配置环境。 第二，终端根据后台返回的结果，是否能够共享或下载指定内核并调起使用。

作者：张佳
团队：腾讯移动品质中心TMQ
【导读】
对于非宿主的合作伙伴来说，在TBS接入环节，“共享和下载内核”的能力是最重要的，它从根本上决定着APP是否能够使用预期的X5内核提供服务。 一旦出现问题，会导致无法加载X5内核或者优化策略失效，从而降低X5占比。但面临的一个问题是，SDK是跟随TBS版本持续优化的，每次SDK发布，都会有大批小伙伴更新apk来提测。 具体表现为，新的SDK在各种场景下是否能正常使用到内核，比如： 
首次安装三方，能共享宿主已有的内核 ；
共享A宿主内核后，若宿主升级到更高版本，三方能跟随升级； 
已共享A主内核后，若B宿主升级到更高版本 【自动化的思考】
1、是否重要？ 
是。前面有介绍，一旦SDK逻辑出问题，会导致TBS使用异常，X5占比降低。 
2、是不是重复工作？ 
用例可复用。 第二，终端根据后台返回的结果，是否能够共享或下载指定内核并调起使用。 
考虑到以上因素，我们选用UI自动化的测试方式，优点在于兼顾后台和终端，并且通过记录tbslog方便隔离分析。

TBS三方SDK自动化探索

TBS三方SDK自动化探索

自动化测试微信小程序。使用homebrew安装node，命令行：brew install node appium -v 因为，Android SDK Manager需要有Java的支持，如果没有安装java，则第一次在双击Andriod文件的时候，会提示下载安装java。更新刚配置的环境变量 X5内核应用自动化方式和普通混合应用有非常多的差异，接下来以微信小程序举例介绍怎幺来开展X5内核的自动化。driver.switch_to.context(输入待测试webview名字）) native界面： 

sdk/index.html
下载程序后，解压到Mac电脑的任意一个目录即可。 由于腾讯系QQ、微信等都是基于腾讯自研X5内核，不是google原生webview（其实就是进行了二次定制）。 实质上也是混合应用的一种，现在很多app产品也开始流行采用X5内核作为其内嵌web浏览服务，所以掌握X5内核混合应用自动化也是app自动化测试工程师必备技能。 X5内核应用自动化方式和普通混合应用有非常多的差异，接下来以微信小程序举例介绍怎么来开展X5内核的自动化。
打开微信，在任意好友窗口输入，然后点击它：debugx5.qq.com

? 然后：在打开的界面中选择信息->勾选是否打开TBS内核Inspector调试功能

?

Mac 环境下搭建 appium
1 安装homebrew
首先命令行检查是否安装：

自动化测试微信小程序

Android-腾讯X5接入详解与注意点。 9) 视频和文件格式的支持x5内核多于系统内核 10) 防劫持是x5内核的一大亮点 2. 运行环境 1)手机ROM版本高于或等于2.2版本 2)手机RAM大于500M，该RAM值通过手机 /proc/meminfo 文件的MemTotal动态获取 注：如果不满足上述条件，SDK会自动切换到系统WebView，SDK使用者不用关心该切换过程。//x5内核初始化完成的回调，为true表示x5内核加载成功，否则表示x5内核加载失败，会自动切换到系统内核。

Html5、ES6上有更完整支持；
8) 更强大：集成强大的视频播放器，支持视频格式远多于系统webview；
9) 视频和文件格式的支持x5内核多于系统内核
10) 防劫持是x5内核的一大亮点
2. WebView，SDK使用者不用关心该切换过程。 SDK尺寸指标
1)SDK提供的JAR包约250K
集成步骤
下载SDK
地址：https://x5.tencent.com/tbs/sdk.html
[image.png]
2.将下载的tbs jar x5内核
 QbSdk.setDownloadWithoutWifi(true);
 //搜集本地tbs内核信息并上报服务器，服务器返回结果决定使用哪个内核。 內核初始化完成的回调，为true表示x5内核加载成功，否则表示x5内核加载失败，会自动切换到系统内核。

Android-腾讯X5接入详解与注意点

2)手机RAM大于500M，该RAM值通过手机 /proc/meminfo 文件的MemTotal动态获取

Android-腾讯X5接入详解与注意点

Android 集成第三方 WebView 内核。从这里下载最新版本 X5 SDK QbSdk.PreInitCallback cb = new QbSdk.PreInitCallback() { public void onViewInitFinished(boolean arg0) { //x5内核初始化完成的回调，为true表示x5内核加载成功，否则表示x5内核加载失败，会自动切换到系统内核。WebSettings mWebSettings; // 设置可以访问文件  // 支持缩放 mWebView.setWebChromeClient(new WebChromeClient());// 清理缓存 if (mWebView !

腾讯 TBS X5
导入 tbs_sdk
从这里下载最新版本 X5 SDK
 导入 SDK 到项目
 File->Project Structure->+->Import .JAR/.AAR Package 选择下载好的 tbs_sdk.jar 导入
?
设置默认 project 依赖 tbs_sdk project
?
至此，tbs_sdk 就导入完成。 x5内核
 QbSdk.setDownloadWithoutWifi(true);
 //搜集本地tbs内核信息并上报服务器，服务器返回结果决定使用哪个内核。 內核初始化完成的回调，为true表示x5内核加载成功，否则表示x5内核加载失败，会自动切换到系统内核。 文件很大，如果你有确定针对的机型，就下载相应版本的包吧，这里我就用 crosswalk-23.53.589.4.aar 来演示了，这个包支持 x86、x64 以及 arm 等全类型 ABI，但代价就是这个包有

Android 集成第三方 WebView 内核

从这里下载最新版本 X5 SDK
 导入 SDK 到项目
 File->Project Structure->+->Import .JAR/.AAR Package->Next

Android 集成第三方 WebView 内核

[这里写图片描述] 我们可以很清晰的看到 1）进程总内存占用： 180M 2）JavaHeap： 48M 3）NativeHeap：native层的 so 中调用malloc或new创建的内存 —— 28M 4）Graphics：OpenGL和SurfaceFlinger相关内存 ——58M 5）Stack：线程栈——1.89M 6）Code：dex+so相关代码占用内存——37.75M 7）Other：蜜汁存在 上述6中内存占用除了两种不需要考虑，其他5中通通需要优化。 显然主进程的Code内存占用太多了，需要分析。

似乎有问题，需要再多分析一下~ 
Native Heap
目前能看到的NativeHeap大小是
应用启动：26M 此时已经初始化了 X5内核和IM SDK
UGC录音：26M->34M 退出之后时32M 各个场景下的使用情况是：
1）刚进入应用：38M
2）再使用UGC录音：38.28M
3）再使用视频直播（发起直播）：46M
4）打开应用内WebView（X5内核）：56M
以上是主进程的内存，占用相当多 这里需要考虑的是 X5 内核能否延时加载？因为没打开WebView的时候就已经占用了数M了。另外WebView关闭之后是否可以销毁。
直播相关SO，可以考虑直播退出之后从内存中卸载掉。 code内存占用太多，其中X5内核占用29M实在太多，需要考虑优化。 应用内的线程数量主要有X5内核，IMSDK和WNS贡献，外网线程创建的OOM crash 系WNS的bug，需要联系相关sdk开发人员。
最后是Native内存占用还没有详细分析，暂时看不到使用情况。

作者：杨超，腾讯移动客户端开发 工程师 
商业转载请联系腾讯WeTest获得授权，非商业转载请注明出处。
原文链接：http://wetest.qq.com/lab/view/359.html
WeT

使用这个 SDK 是否还需要下载 X5 内核

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐