(已过时)静态集成腾讯TBS X5内核WebView，从微信提取新版30M浏览器内核打包进apk
2022-02-11更新：新版本TBS SDK已恢复支持静态集成的方法，无需在使用本文的方法了。
测试新SDK(ver:44153 date:2022-1-17)已提供QbSdk.installLocalTbsCore方法，没翻到此方法的官方文档，应该是还没有打算公开。
请直接下载最新sdk，然后调用QbSdk.installLocalTbsCore进行静态集成。
参考文章：https://blog.csdn.net/qq_34205629/article/details/122375262
以下内容已过时
以下内容已过时
以下内容已过时
由于X5内核打包后有30多M，x5官网文档也着重提醒：“由于内核体积较大，官网SDK默认为静默下载方案，首次使用需要在网络中静默下载约30M的内核，可能存在一定的加载失败率，目前线上加载成功率约为90%。如果您有业务需要强依赖X5内核相关功能，请使用静态集成方式进行集成”。
当某些特殊app必须可靠加载X5内核时（非普通用户使用，没有装微信），等待网络慢慢下载还不一定成功，那就太废了；似乎静态集成给了一条活路。
关键就在于这个“静态集成”，整个x5官网，除了常见问题中有提到，其他任何地方都找不到如何静态集成，更找不到SDK；后面发现是早年有提供文档和下载，不过后面就关闭了，文档也删了；也许是用的人多，又不挣钱，KPI下的产物吧，没利谁给你免费维护。
经过搜罗历史资料（GitHub搜代码真稳的一比），结合下载到的老版本静态集成SDK，经过一番摸索，实现了：用老版本的jar + 最新的TBS X5内核，进行静态集成，将内核直接打包进APK。
前情提要
本篇文章只针对X5内核的静态集成，将30多M内核直接打包进Apk，TBS X5官网已经没有相关资料了；如果你不是要把内核打包进Apk，请直接阅读官网 https://x5.tencent.com/ 文档就行了，不用折腾。
第一步：下载老版本SDK得到jar
获取SDK
当前时间：2020-08-07，能找到的最新的一个静态集成SDK，看里面文件名时间是2017-10-11，虽然老了点，但是能用来加载最新的X5内核，没有问题。
下载后，只需要提取里面的tbs_sdk_thirdapp_v3.5.0.1063_43500_staticwithdownload_withoutGame_obfs_20171011_195714.jar，另外一个apk文件是内核（这个内核太老，就不要了）。
如果上面地址失效了，我在github里面存了一份jar，地址：
https://github.com/xiangyuecn/Docs/blob/master/H5/静态集成腾讯TBS X5内核WebView，从微信提取新版30M浏览器内核打包进apk_files/tbs_sdk_thirdapp_v3.5.0.1063_43500_staticwithdownload_withoutGame_obfs_20171011_195714.jar
SHA1: BB40F495C4CC39F41DBE34124F443B3EC43073EC
集成SDK
把得到的这个tbs_sdk_*.jar copy到项目的libs目录中（如果你已经导入了新版的tbs_sdk_*.jar，把新版删掉就行，它们没有QbSdk.preinstallStaticTbs静态内核加载方法）。
这样SDK就集成好了（见文末图），此时就算不集成静态内核也能正常运行，就是x5加载不太稳定。
步骤二、下载提取最新TBS X5内核
有两种方法，一个是从微信里面提取；另外一个就是app内访问tbs调试页面，然后安装新内核，再提取。
方法1：从微信中提取
微信中打开http://debugtbs.qq.com，进入界面后点击拷贝内核按钮，会弹出保存的路径（参考顶上【图3】），打开这个路径后提取里面的core_private/x5.debug.tbs这个文件（如果没有这个文件，就把弹出的路径中所有文件都copy出来，把30M以上文件都改成zip，能打开的就是了），其实这个是一个apk/zip文件，30多M，解压后得到一堆so和jar等文件，先复制出来再说，文件名加一个zip后缀。
X5官网中 关于TBS -> 平台适配 中已经写明了只支持armeabi、armeabi-v7a、arm64-v8a 这3种架构，因此对于x86等架构是不支持的（AS模拟器），抛开模拟器，大部分似乎只需提供armeabi架构就ok了。
微信中提取出来的这个内核的架构可能是arm64-v8a，如果你要armeabi架构，请用下面方法2来获取内核。
方法2：App内内访问tbs调试页安装新内核
集成了上面的老版本SDK后，你的App就可以通过访问http://debugtbs.qq.com页面来手动下载最新
X5内核（如果下载不了，尝试改回新版本SDK下载，然后再改回来）。点击安装线上内核（参考顶上【图1】），它会自动识别App的架构，下载到armeabi或者arm64-v8a架构的TBS内核包，下载完后重启App就可以进行内核提取操作了。
这就有两种途径获取到内核包了，一个是在安装时监控App的网络请求，得到下载地址；另外一个就是和微信里面一样，点击拷贝内核按钮，参考上面微信的流程。
这里提供我拿到的一个内核下载地址：
http://tbs.imtt.qq.com/release/tbs_core_045318_20200714112122_nolog_fs_obfs.tbs
30多M，内核版本：45318（20200714112122），Chrome 77
步骤三、集成内核到App中
解压内核得到so
你提取到内核文件就是一个apk文件，直接zip解压就行了，里面有lib + assets 两个目录，我们要把这两个目录内的所有文件合到一起放到一个目录再操作：
lib目录内可能是armeabi 或者 arm64-v8a，不同架构是因为是根据你App架构（或微信） + 手机支持的架构由TBS自动下载的，如果你需要的架构类型和lib里面的不同，那么请参考上面重新提取内核。
将lib/arm*内的so文件复制出来，和assets/webkit内的文件放到一起，总共一起共40来个文件。
so改名
将刚才复制到一起的一堆文件，文件名统统加上libtbs.前缀 + .so后缀，比如abc.so文件，改名后变成libtbs.abc.so.so，jar、conf文件也不例外。
附：CMD命令行批量改名
::直接在当前这堆文件的目录执行下面代码，批量改名
for /F %i in ('dir /A:-D /B') do move %i "libtbs.%i.so"
集成内核
将改好名的所有文件，copy到项目的src/main/jniLibs/armeabi目录中（如果是arm64-v8a的一样copy），这样内核就集成好了（见文末图）。下面我们只需要在app运行时激活这个内核就ok了。
记得build.gradle中配置上ndk，如
defaultConfig {
...
ndk {abiFilters "armeabi","x86"} //真机 + 模拟器，谈性能？不如喂狗
}
激活X5内核
不要用QbSdk.initX5Enviroment方法，改用QbSdk.preinstallStaticTbs方法。
在显示webview前，你要先把X5内核安装好（我管他叫激活）。代码就一句话，你最好在当前Activity（你得激活完后再手动创建WebView）里面，或者在Application（似乎没有Activity里面激活来的稳定）里面执行：
//此方法非常耗时，应当开个线程
QbSdk.preinstallStaticTbs(getApplicationContext());
//这里就可以安全的创建WebView了，只要你的ABI架构没有问题，那么这里一定能加载到X5内核
简单点就在Activity里面激活就行，省得死活加载不了，比如这样子：
public class MyActivity extends Activity {
@Override
protected void onCreate(Bundle state) {
super.onCreate(state);
/*注意，你的布局里面不要有任何X5相关的东西，只留一个来容器放X5的WebView即可
<LinearLayout
android:id="@+id/webviewBox"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="vertical" />
*/
setContentView(R.layout.mylayout);
//X5的WebView用动态创建，当内核准备好时，在创建，可能是异步也可能是同步操作
if(QbSdk.canLoadX5(getApplicationContext())){
Log.i("TBS_X5","已安装好，直接显示");
createWebview();
}else{
Log.i("TBS_X5","新安装");
new Thread(new Runnable() {
@Override
public void run() {
boolean ok=QbSdk.preinstallStaticTbs(getApplicationContext());
Log.i("TBS_X5","安装成功："+ok);
runOnUiThread(new Runnable() { @Override public void run() {
createWebview();
}});
}
}).start();
}
}
private void createWebview(){
//手动创建WebView，显示到容器中，这样就能保证WebView一定是在X5内核准备好后创建的
WebView webView = new WebView(getApplicationContext());
LinearLayout.LayoutParams css=new LinearLayout.LayoutParams(LinearLayout.LayoutParams.MATCH_PARENT,LinearLayout.LayoutParams.MATCH_PARENT);
((LinearLayout)findViewById(R.id.webviewBox)).addView(webView, css);
//...其他代码
}
}
/*如果放到Application.onCreate里面激活，似乎会有点问题，测试中发现后面Activity没有加载到X5内核，移到Activity就瞬间好了。这里还是放一个例子吧
public class MyApp extends Application{
public static Boolean X5Ok=null;
@Override
public void onCreate(){
super.onCreate();
new Thread(new Runnable() {
@Override
public void run() {
//Application里安装就算OK了也不保证一定能用
X5Ok=QbSdk.preinstallStaticTbs(getApplicationContext());
}
}).start();
}
}
*/
其他的一些配置，参考官网就OK
权限
<uses-permission ....
抱歉，先毛权限也不给。你App本来需要什么权限，就给什么权限（网络、录音、摄像头），不用管X5官网的那一坨。
等他崩溃再一个个给，似乎只要INTERNET、ACCESS_NETWORK_STATE权限就够了。
包名替换
Java文件中：android.webkit.WebView -> com.tencent.smtt.sdk.WebView。
布局文件中：<WebView /> -> <com.tencent.smtt.sdk.WebView />
详细的包名替换阅读X5官网。
WebView网页权限
当网页访问摄像头、麦克风时，X5默认会弹一个确认对话框，自己的App网页就没有这么多条条框框了，可以静默授权：
//webkit是 WebChromeClient.onPermissionRequest 处理网页授权
//x5是 IX5WebChromeClientExtension.onPermissionRequest 处理网页授权
webView.setWebChromeClientExtension(new IX5WebChromeClientExtension() {
...
@Override
public boolean onPermissionRequest(String s, long l, MediaAccessPermissionsCallback callback) {
你的App摄像头、录音权限申请( 申请成功回调{
long allowed = 0;
allowed = allowed | MediaAccessPermissionsCallback.ALLOW_AUDIO_CAPTURE | MediaAccessPermissionsCallback.ALLOW_VIDEO_CAPTURE;
boolean retain = true;
callback.invoke(s, allowed,retain);
});
return true;
}
...
});
首次初始化冷启动优化
用不着，QbSdk.initX5Enviroment方法也用不着。
混淆、文件、视频
阅读X5官网文档。
结束语
欢迎关注我的GitHub:
H5、Hybrid App录音库，支持mp3、wav、语音识别：https://github.com/xiangyuecn/Recorder
省市区镇数据，提供坐标、边界，和shp、geojson、sql支持：https://github.com/xiangyuecn/AreaCity-JsSpider-StatsGov
如果本篇文章对你有帮助，您也可以到上面仓库中对作者进行打赏~
