Android WebView 版本升级方案详解

Android WebView 版本升级方案详解 | 极客日志

升级前： - 包名：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)

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

方案	核心思路	适配/升级能力	优点	局限与风险	典型场景
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	覆盖广、维护成本低	官方路径最稳；与系统组件一致	国内渠道/厂商机型可能不可用或更新滞后；无法覆盖所有存量设备	能依赖商店与系统更新的用户群体，作为首选基线方案

// 不需要下载 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 // 保存的目标文件);

// 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();

// 方式 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 硬件解码
    }
});

开始：WebView 播放 H.265
↓
API Level ≥ 21?
├─ 否 → 结论：系统不支持，走软解/降级
└─ 是 → WebView 内核版本 ≥ 阈值？
    ├─ 否 → 结论：系统不支持，走软解/降级
    └─ 是 → JS 探测：MediaSource.isTypeSupported
        ├─ 返回 false → 结论：系统不支持，走软解/降级
        └─ 返回 true → 是否支持 WebCodecs VideoDecoder？
            ├─ 否 → 结论：走软解 (FFmpeg/内置软解)
            └─ 是 → JS 探测：VideoDecoder.isConfigSupported
                ├─ 返回 false → 结论：走软解 (FFmpeg/内置软解)
                └─ 返回 true → 结论：支持 H.265 硬件解码 ✅ 流畅播放

Android WebView 版本升级方案详解

Android WebView 版本升级方案详解

问题背景

WebView 版本差异带来的问题

典型问题场景

Android 系统对 H.265 的支持要求

WebViewUpgrade 项目介绍

项目概述

核心原理

GitHub 仓库

支持的内核版本

已测试机型

待开发功能

升级方法详解

升级流程

升级源类型

升级时机要求

替代方案对比

方案对比表

选型建议

接入与使用步骤

1. 添加依赖

2. 准备内核包与来源

方式 A：下载源

方式 B：内置源

方式 C：安装包源

3. 执行升级（务必在任何 WebView 实例化之前）

完整示例代码

4. 监听进度与结果

方式 A：轮询方式

方式 B：回调方式

5. 验证结果

验证包名和版本

验证 H.265 能力

注意事项与限制

关键限制

上线前验证清单

合规与风控

总结与建议

核心结论

更稳妥的落地策略

判断逻辑总结

流程图

微信扫一扫，关注极客日志

更多推荐文章

相关免费在线工具