Android WebView 在部分机型 Chromium 版本过低导致 H.265 硬解不支持。介绍使用 WebViewUpgrade 开源库实现免安装升级内核的方案，通过 Hook 系统服务切换至新版 Google WebView。文中对比了腾讯 X5、Crosswalk 等替代方案，详细说明了依赖添加、升级源选择、执行时机及验证步骤。强调必须在 WebView 初始化前执行，并提供了兼容性判断逻辑与落地建议。
Android 5.0 以后，WebView 升级需要去 Google Play 安装 APK，但即使安装了也不一定能正常工作。像华为、Amazon 等特殊机型的 WebView 的 Chromium 版本一般比较低，只能使用它自己的 WebView，无法使用 Google 的 WebView。
H.265 视频播放问题：
版本差异示例：
升级前： - 包名：com.huawei.webview - 版本：14.0.0.331 - UserAgent 中的 Chromium 版本：99.0.4844.88 (< 107，不支持 H.265)
升级后： - 包名：com.google.android.webview - 版本：122.0.6261.64 - UserAgent 中的 Chromium 版本：122.0.6261.64 (支持 H.265)
重要理解：Android 5.0 (API 21) 及更高版本，系统必须提供 H.265 (HEVC) 解码能力，但这指的是解码能力 (Decoder)，不区分软解或硬解，且主要针对 MediaCodec 等原生接口。
MediaCodec 能否成功创建并配置 video/hevc 解码器的测试WebViewUpgrade 是一个在 Android 5.0+ 上实现"免安装升级 WebView 内核"的开源库。它允许应用将内置或下载的 WebView APK 作为系统 WebView 的实现，从而解决部分机型（如华为、Amazon）系统 WebView Chromium 版本过低导致的 H.265/HEVC、ES6、现代视频能力不可用等问题。
WebViewUpgrade 通过在运行时 Hook WebViewUpdateService / PackageManagerService 的 Binder 调用，以 App 内 APK 作为 WebView 实现，实现内核的切换和升级。
| WebView 包名 | 系统版本 |
|---|---|
| com.google.android.webview | 122.0.6261.64 |
| com.android.webview | 113.0.5672.136 |
| com.huawei.webview | 14.0.0.331 |
| com.android.chrome | 122.0.6261.43 |
| com.amazon.webview.chromium | 118-5993-tv.5993.155.51 |
| 厂商 | 系统版本 |
|---|---|
| 华为 Mate30 | 12 |
| 小米 10 | 11 |
| VIVO NEX A | 10 |
| OPPO FIND X5 | 14 |
1. 前置检查：获取当前 WebView 包名与版本
2. 判断是否需要升级（对比目标版本）
3. 准备升级源（网络下载/内置/安装包）
4. 执行升级（必须在 WebView 首次初始化之前）
5. 监听进度与结果
6. 验证升级结果（包名/版本/H.265 能力）
WebViewUpgrade 支持三种升级源：
关键限制：必须在任何 WebView 实例化之前完成升级与切换，否则容易出现 UnsatisfiedLinkError: Shared library already opened 等链接错误。
推荐位置：在 Application.onCreate() 的最早时机执行。
| 方案 | 核心思路 | 适配/升级能力 | 优点 | 局限与风险 | 典型场景 |
|---|---|---|---|---|---|
| WebViewUpgrade（免安装替换内核） | 运行时 Hook WebViewUpdateService / PackageManagerService，以 App 内 APK 作为 WebView 实现 | 可切换到 com.google.android.webview / com.android.webview / com.huawei.webview 等；实测可把华为机型的 Chromium <107 升到 122.0.6261.64，从而支持 H.265 | 不依赖 Play/系统商店；对存量设备"即插即用"；对 H.265 提升明显 | 需严格在 WebView 首次初始化前执行；存在多进程/动态切换未完全支持、签名/ABI/so 路径等工程坑；国内部分厂商机型可能受限 | 面向大量存量用户、无法强依赖商店升级、且需快速补齐 HEVC/ES6/视频能力 |
| 腾讯 X5（TBS） | 接入腾讯浏览服务内核（com.tencent.smtt.sdk.WebView），与系统 WebView API 相似 | 可独立于系统更新内核；对 H.265 的支持取决于内核版本（免费版常见为 Chromium 89，不支持 H.265；部分渠道称可到 Chromium 95，需验证） | 兼容性与稳定性好；视频/文件能力增强；接入成本相对低 | 包体增大；内核并非最新；部分站点在 X5 下仍可能加载失败；与系统 WebView 存在差异需回归测试 | 面向国内中低端/碎片化机型、希望快速提升兼容与视频能力 |
| Crosswalk（已停更） | 将 Chromium/Blink 直接打进 APK 作为独立内核 | 一次性解决低版本系统兼容问题 | 历史项目中对低版本 Android 的 HTML5/性能有明显提升 | 项目自 2017 年起停更，内核版本停留在 Chromium 53；包体显著增加；内存占用高、白屏等问题较多 | 仅建议维护老项目或特定离线场景，不建议新项目采用 |
| GeckoView（Mozilla） | 使用 Gecko 引擎的独立组件（非系统 WebView 替代） | 可随 App 独立更新 | 标准支持与隐私特性好；可深度定制 | API 与系统 WebView 不同，迁移成本高；包体/内存开销大 | 需要长期稳定维护自有内核、对标准一致性与可定制性要求高的场景 |
| 系统 WebView 官方更新 | 通过 Google Play 或系统更新 Android System WebView / Chrome | 覆盖广、维护成本低 | 官方路径最稳；与系统组件一致 | 国内渠道/厂商机型可能不可用或更新滞后；无法覆盖所有存量设备 | 能依赖商店与系统更新的用户群体，作为首选基线方案 |
在 build.gradle 中添加：
// 不需要下载 APK 时使用 implementation 'io.github.jonanorman.android.webviewup:core:0.1.0'
// 需要下载 APK 使用 implementation 'io.github.jonanorman.android.webviewup:download-source:0.1.0'
UpgradeDownloadSource upgradeSource = new UpgradeDownloadSource(context, url,// WebView APK 的下载地址 file // 保存的目标文件);
将 WebView APK 放入 assets 目录，使用 UpgradeAssetSource。
直接指定目标包名（需设备可安装），使用 UpgradePackageSource。
// 1. 定义升级信息
UpgradeInfo info = new UpgradeInfo("com.google.android.webview",// 目标包名
"122.0.6261.64",// 目标版本
"https://raw.githubusercontent.com/.../com.google.android.webview_122.0.6261.64_armeabi-v7a.zip",// 下载地址
"网络");// 来源描述
// 2. 前置检查：获取当前 WebView 包名与版本
String curPkg = WebViewUpgrade.getSystemWebViewPackageName();
String curVersion = WebViewUpgrade.getSystemWebViewPackageVersion();
// 3. 判断是否需要升级
if(curPkg != null && curPkg.equals(info.packageName) && VersionUtils.compareVersion(curVersion, info.versionName) >= 0){
// 已满足，无需升级
return;
}
// 4. 创建升级源
UpgradeSource src = info.toUpgradeSource(context);
if(src == null) return;
// 5. 执行升级
WebViewUpgrade.upgrade(src);
// 检查状态
if(WebViewUpgrade.isProcessing()){
float progress = WebViewUpgrade.getUpgradeProcess(); // 更新进度 UI
}
if(WebViewUpgrade.isCompleted()){
// 升级完成，初始化 WebView
}
if(WebViewUpgrade.isFailed()){
Throwable error = WebViewUpgrade.getUpgradeError(); // 处理错误
}
WebViewUpgrade.setUpgradeCallback(new UpgradeCallback(){
@Override
public void onUpgradeProcess(float percent){ // 更新进度 UI }
@Override
public void onUpgradeComplete(){ // 升级完成，初始化 WebView 并加载页面 }
@Override
public void onUpgradeError(Throwable t){ // 记录日志/降级策略 }
});
# 通过 adb 命令验证
adb shell pm dump com.android.webview | grep version
# 或使用 dumpsys
dumpsys webviewupdate
# 或在代码中验证
String pkgName = WebViewUpgrade.getSystemWebViewPackageName();
String version = WebViewUpgrade.getSystemWebViewPackageVersion();
在 H5 页面中使用 JavaScript 检测：
// 方式 1：检测 MediaSource 支持
const isSupported = MediaSource.isTypeSupported('video/mp4; codecs="hev1.1.6.L93.B0"');
// 方式 2：检测 VideoDecoder 硬件加速支持（更精确）
const config = {
codec: 'hev1.1.6.L93.B0',
hardwareAcceleration: 'prefer-hardware'
};
VideoDecoder.isConfigSupported(config).then(result => {
if(result.supported){
// 支持 H.265 硬件解码
}
});
UnsatisfiedLinkError: Shared library already opened 等链接错误Application.onCreate() 的最早时机执行PackageInfo 需要手动补齐 nativeLibraryDir/ABI 等字段，处理不当会崩溃adb shell pm dump com.android.webview | grep version 或 dumpsys webviewupdate 校验当前包名/版本MediaSource.isTypeSupported('video/mp4; codecs="hev1..."')' 与（可选）VideoDecoder.isConfigSupported({hardwareAcceleration:true}) 验证硬解可用性针对需要快速补齐 H.265/HEVC、ES6/现代 Web API 的兼容性诉求，且无法保证用户通过商店或系统更新 WebView/Chrome 的场景，WebViewUpgrade 通常是"收益最高"的兜底方案：
com.google.android.webview 122.0.6261.64）分层策略：
在 Android 5.0+ 系统上，只有当设备的 WebView 内核版本足够新（如 Chromium ≥ 107）、MediaSource.isTypeSupported 和 VideoDecoder.isConfigSupported({hardwareAcceleration:true}) 均返回 true，且系统 MediaCodec 能成功创建 HEVC 解码器时，才能认为可以流畅地进行 H.265 硬件解码；否则，一律按软解或降级处理。
开始：WebView 播放 H.265
↓
API Level ≥ 21?
├─ 否 → 结论：系统不支持，走软解/降级
└─ 是 → WebView 内核版本 ≥ 阈值？
├─ 否 → 结论：系统不支持，走软解/降级
└─ 是 → JS 探测：MediaSource.isTypeSupported
├─ 返回 false → 结论：系统不支持，走软解/降级
└─ 返回 true → 是否支持 WebCodecs VideoDecoder？
├─ 否 → 结论：走软解 (FFmpeg/内置软解)
└─ 是 → JS 探测：VideoDecoder.isConfigSupported
├─ 返回 false → 结论：走软解 (FFmpeg/内置软解)
└─ 返回 true → 结论：支持 H.265 硬件解码 ✅ 流畅播放
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具，Keycode 信息在线工具，online
JavaScript 字符串转义/反转义；Java 风格 \uXXXX（Native2Ascii）编码与解码。 在线工具，Escape 与 Native 编解码在线工具，online
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具，JavaScript / HTML 格式化在线工具，online
Terser 压缩、变量名混淆，或 javascript-obfuscator 高强度混淆（体积会增大）。 在线工具，JavaScript 压缩与混淆在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online