Android 10 WebView 踩坑实录
项目要求支持 8K 高清视频（H265编码）播放，拿到板子后却发现使用 App 可以播放 8K 高清视频，但使用浏览器却不行，即使安装上最新的 Chrome for Android 也不行。根据以往的浏览器内核开发经验，在 Android 平台上，Chromium WebView 最终是调用系统框架层的 MediaPlayer 进行播放。理论上只要系统框架层能够支持 8K 高清播放，那么浏览器应该也支持。实际情况却并非如此，而且 Android 10 预编译 WebView 没任何日志输出，所以需要下载源码编译 Chromium WebView，找出问题所在。
版本选择坑
Chromium 源码更新非常平凡，而且架构也经常变化，不像我们做项目，一套代码恨不得修修补补用上十几年。上一个项目是基于 Chromium V53 进行定制的，这次并不想采用最新的 Chromium 版本，大概浏览了一下最新源码，和 V53 差别太大，以往的定制工作要移植过来相当麻烦。首先想到的是直接使用 V53 的源码，但无法应用到 Android 10 上，主要是 Android 10 的 WebView API 接口发生了一些变化。最终令我放弃的是 Android 10 框架层移除了 HardwareCanvas 类，要知道，在 Android 5.1 中，WebView 中有一个重要的绘制方法：
public void callDrawGlFunction(Canvas canvas, long nativeDrawGLFunctor) {
if (!(canvas instanceof HardwareCanvas)) {
// Canvas#isHardwareAccelerated() is only true for subclasses of HardwareCanvas.
throw new IllegalArgumentException(canvas.getClass().getName()
+ " is not hardware accelerated");
}
((HardwareCanvas) canvas).callDrawGLFunction2(nativeDrawGLFunctor);
}不能使用 V53，接下来考虑 Android 10 中预编译的 Chromium Webview 版本，使用 WebView Shell，查看版本号为 74.0.3729.183：
然而，这里有一个巨大的坑。等我费了九牛二虎之力把代码下载下来，把 Chromium WebView 编译出来并安装到系统，结果浏览器启动就崩溃，查看系统日志，有如下错误信息：
03-05 00:41:09.457 3299 4011 W WebViewUpdater: creating relro file timed out
03-05 00:41:09.458 12565 12565 E WebViewFactory: Chromium WebView package does not exist
03-05 00:41:09.458 12565 12565 E WebViewFactory: android.webkit.WebViewFactory$MissingWebViewPackageException: Failed to load WebView provider: No WebView installed
03-05 00:41:09.458 12565 12565 E WebViewFactory: at android.webkit.WebViewFactory.getWebViewContextAndSetProvider(WebViewFactory.java:339)
03-05 00:41:09.458 12565 12565 E WebViewFactory: at android.webkit.WebViewFactory.getProviderClass(WebViewFactory.java:402)
03-05 00:41:09.458 12565 12565 E WebViewFactory: at android.webkit.WebViewFactory.getProvider(WebViewFactory.java:252)
03-05 00:41:09.458 12565 12565 E WebViewFactory: at android.webkit.WebView.getFactory(WebView.java:2551)
03-05 00:41:09.458 12565 12565 E WebViewFactory: at android.webkit.WebView.setWebContentsDebuggingEnabled(WebView.java:1974)
03-05 00:41:09.458 12565 12565 E WebViewFactory: at org.chromium.webview_shell.WebViewBrowserActivity.onCreate(WebViewBrowserActivity.java:230)
03-05 00:41:09.458 12565 12565 E WebViewFactory: at android.app.Activity.performCreate(Activity.java:7802)
03-05 00:41:09.458 12565 12565 E WebViewFactory: at android.app.Activity.performCreate(Activity.java:7791)
03-05 00:41:09.458 12565 12565 E WebViewFactory: at android.app.Instrumentation.callActivityOnCreate(Instrumentation.java:1306)
03-05 00:41:09.458 12565 12565 E WebViewFactory: at android.app.ActivityThread.performLaunchActivity(ActivityThread.java:3245)
03-05 00:41:09.458 12565 12565 E WebViewFactory: at android.app.ActivityThread.handleLaunchActivity(ActivityThread.java:3409)
03-05 00:41:09.458 12565 12565 E WebViewFactory: at android.app.servertransaction.LaunchActivityItem.execute(LaunchActivityItem.java:83)
03-05 00:41:09.458 12565 12565 E WebViewFactory: at android.app.servertransaction.TransactionExecutor.executeCallbacks(TransactionExecutor.java:135)
03-05 00:41:09.458 12565 12565 E WebViewFactory: at android.app.servertransaction.TransactionExecutor.execute(TransactionExecutor.java:95)
03-05 00:41:09.458 12565 12565 E WebViewFactory: at android.app.ActivityThread$H.handleMessage(ActivityThread.java:2016)
03-05 00:41:09.458 12565 12565 E WebViewFactory: at android.os.Handler.dispatchMessage(Handler.java:107)
03-05 00:41:09.458 12565 12565 E WebViewFactory: at android.os.Looper.loop(Looper.java:214)
03-05 00:41:09.458 12565 12565 E WebViewFactory: at android.app.ActivityThread.main(ActivityThread.java:7368)
03-05 00:41:09.458 12565 12565 E WebViewFactory: at java.lang.reflect.Method.invoke(Native Method)
03-05 00:41:09.458 12565 12565 E WebViewFactory: at com.android.internal.os.RuntimeInit$MethodAndArgsCaller.run(RuntimeInit.java:492)
03-05 00:41:09.458 12565 12565 E WebViewFactory: at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:930)
03-05 00:41:09.459 12565 12565 D AndroidRuntime: Shutting down VM查看了一下框架层代码，一个合格的 WebView Provider，首先其 targetSdk 版本号要大于或等于 29，而查看 chromium v74 源码的 build/config/android/sdk.gni 文件：
# The default SDK release used by public builds. Value may differ in
# internal builds.
default_android_sdk_release = "p"
# SDK releases against which public builds are supported.
public_sdk_releases = [ "p" ]Android 10 的代号为 Q，也就是说这个版本的 Chromium WebView 实际上只支持到 Android 9，也不知道 Google 使用了什么魔法。可能是当时 Android 10 在开发过程中，使用了内部的 SDK 进行构建。
这个时候，我还是不想使用最新版本，那就采用正式支持 Android Q 的最早版本吧。方法就是查看这个 sdk.gni 的修改记录，看看哪个提交从 "p" 修改到 "q"。因为代码的分支超级多，必须要查看所有分支的 git 提交：
$ git log -p --all -G 'sdk' sdk.gni查到 commit id 为 c2481863282a401926e0ee479334c68ec362d302 ，接下来查询哪些分支包含这个提交：
$ git branch -a --contains c2481863282a401926e0ee479334c68ec362d302
remotes/branch-heads/3967
remotes/branch-heads/3968
remotes/branch-heads/3969
remotes/branch-heads/3970
remotes/branch-heads/3971
remotes/branch-heads/3972
remotes/branch-heads/3973
remotes/branch-heads/3974
remotes/branch-heads/3975
remotes/branch-heads/3976
remotes/branch-heads/3977
remotes/branch-heads/3978
remotes/branch-heads/3979
remotes/branch-heads/3980
remotes/branch-heads/3981
remotes/branch-heads/3982
remotes/branch-heads/3983
remotes/branch-heads/3984
remotes/branch-heads/3985
remotes/branch-heads/3986
remotes/branch-heads/3987
remotes/branch-heads/3987_100
remotes/branch-heads/3987_137
remotes/branch-heads/3987_158
remotes/branch-heads/3987_87
remotes/branch-heads/3988
remotes/branch-heads/3989
remotes/branch-heads/3990
remotes/branch-heads/3991
remotes/branch-heads/3992
remotes/branch-heads/3993
remotes/branch-heads/3994
remotes/branch-heads/3995
remotes/branch-heads/3996
remotes/branch-heads/3997
remotes/branch-heads/3998
remotes/branch-heads/3999
remotes/branch-heads/4000
remotes/branch-heads/4001
remotes/branch-heads/4002
remotes/branch-heads/4003
remotes/branch-heads/4004
remotes/branch-heads/4005
remotes/branch-heads/4006
remotes/branch-heads/4007
remotes/branch-heads/4008
remotes/branch-heads/4009
remotes/branch-heads/4010
remotes/branch-heads/4011
remotes/branch-heads/4012包含这个提交的分支非常多，数字越大，表明分支代码越新，所以这里搜索这中间的一个稳定发布版本即可。访问如下链接：
https://chromiumdash.appspot.com/releases?platform=Android
这里包含了所有曾经发布过的版本，最终我选择的是 V80.0.3987.165 。在趟过 代码下载坑、编译坑、安装坑后，终于成功运行起来：
代码下载坑
由于众所周知的原因， Chromium 源码不能直接下载，我是挂了代理进行下载。然而在下载时经常出现如下错误：
remote: Counting objects: 867615, done
remote: Finding sources: 100% (10514569/10514569)
error: RPC failed; curl 56 GnuTLS recv error (-9): Error decoding the received TLS packet.
fatal: the remote end hung up unexpectedly
fatal: early EOF
fatal: index-pack failedGit 没有断点续传机制，下载失败了需要重来，碰到 Chromium 这样的超级大库，下载到十几 G 的时候断掉，想死的心都有。上网查了很多方法都不管用，后来在一个帖子中找到解决方法：
git config --global http.postBuffer 5242880000
git config --global https.postBuffer 5242880000
sudo ifconfig eth0 mtu 9000网上的指导一般是将 http.postBuffer 设为一个比较大的值，对于 Chromium 这样单个 git 库超过 30 G 的还是不够，我将缓冲设成 5G 大小，终于不再出错。另外有指导将 MTU 大小设置为 14000，但在 Ubuntu 上无法设成功，我尝试出来的最大值为 9000。
源码 clone 成功后，执行 gclient runhooks 命令又出现如下错误：
NOTICE: You have PROXY values set in your environment, but gsutilin depot_tools does not (yet) obey them.
Also, --no_auth prevents the normal BOTO_CONFIG environmentvariable from being used.
To use a proxy in this situation, please supply those settingsin a .boto file pointed to by the NO_AUTH_BOTO_CONFIG environmentvariable.这是使用了代理的原因，解决的方法很简单，创建一个文本文件（比如 $HOME/.boto），内容为：
[boto]
proxy=代理IP
proxy_port=代理端口然后设置环境变量 NO_AUTH_BOTO_CONFIG 指向这个文件：
export NO_AUTH_BOTO_CONFIG=$HOME/.boto至此，终于解决了源码下载和二进制文件下载的问题。
代码编译坑
编译代码过程中，出现如下错误：
FAILED: gen/build/android/buildhooks/build_hooks_android_java.javac.jar gen/build/android/buildhooks/build_hooks_android_java.javac.jar.info
python ../../build/android/gyp/javac.py --depfile=gen/build/android/buildhooks/build_hooks_android_java__compile_java.d --generated-dir=gen/build/android/buildhooks/build_hooks_android_java/generated_java --jar-path=gen/build/android/buildhooks/build_hooks_android_java.javac.jar --java-srcjars=\[\] --java-version=1.8 --full-classpath=@FileArg\(gen/build/android/buildhooks/build_hooks_android_java.build_config:deps_info:javac_full_classpath\) --interface-classpath=@FileArg\(gen/build/android/buildhooks/build_hooks_android_java.build_config:deps_info:javac_full_interface_classpath\) --processorpath=@FileArg\(gen/build/android/buildhooks/build_hooks_android_java.build_config:javac:processor_classpath\) --processors=@FileArg\(gen/build/android/buildhooks/build_hooks_android_java.build_config:javac:processor_classes\) --java-srcjars=@FileArg\(gen/build/android/buildhooks/build_hooks_android_java.build_config:deps_info:owned_resource_srcjars\) --bootclasspath=@FileArg\(gen/build/android/buildhooks/build_hooks_android_java.build_config:android:sdk_interface_jars\) --chromium-code=1 --errorprone-path bin/errorprone @gen/build/android/buildhooks/build_hooks_android_java.sources
Traceback (most recent call last):
File "../../build/android/gyp/javac.py", line 595, in
sys.exit(main(sys.argv[1:]))
File "../../build/android/gyp/javac.py", line 590, in main
add_pydeps=False)
File "/data/chromium/chromium_v74.0.3729.183/src/build/android/gyp/util/build_utils.py", line 653, in CallAndWriteDepfileIfStale
pass_changes=True)
File "/data/chromium/chromium_v74.0.3729.183/src/build/android/gyp/util/md5_check.py", line 87, in CallAndRecordIfStale
function(*args)
File "/data/chromium/chromium_v74.0.3729.183/src/build/android/gyp/util/build_utils.py", line 638, in on_stale_md5
function(*args)
File "../../build/android/gyp/javac.py", line 584, in
lambda: _OnStaleMd5(options, javac_cmd, java_files, classpath),
File "../../build/android/gyp/javac.py", line 350, in _OnStaleMd5
stderr_filter=ProcessJavacOutput)
File "/data/chromium/chromium_v74.0.3729.183/src/build/android/gyp/util/build_utils.py", line 227, in CheckOutput
raise CalledProcessError(cwd, args, stdout + stderr)
util.build_utils.CalledProcessError: Command failed: ( cd /data/chromium/chromium_v74.0.3729.183/src/out/Default; bin/errorprone -g -encoding UTF-8 -sourcepath : -XepDisableAllChecks -source 1.8 -target 1.8 -Xlint:unchecked -Werror -bootclasspath lib.java/third_party/android_tools/android.interface.jar:/usr/lib/jvm/java-8-openjdk-amd64/jre/lib/rt.jar -d /tmp/tmpzNZrEr/classes @/tmp/tmpzNZrEr/files_list.txt )
-Xbootclasspath/p is no longer a supported option.
Error: Could not create the Java Virtual Machine.
Error: A fatal exception has occurred. Program will exit. 原因是 Ubuntu 20.04 使用的 JDK 版本为 11，但这个版本的 Chromium 编译需要 JDK 8，解决的方法就是将 JDK 切换到 JDK：
$ java --version
openjdk 11.0.18 2023-01-17
OpenJDK Runtime Environment (build 11.0.18+10-post-Ubuntu-0ubuntu120.04.1)
OpenJDK 64-Bit Server VM (build 11.0.18+10-post-Ubuntu-0ubuntu120.04.1, mixed mode, sharing)
$ sudo update-alternatives --config java
[sudo] password for alex:
There are 2 choices for the alternative java (providing /usr/bin/java).
Selection Path Priority Status
------------------------------------------------------------
* 0 /usr/lib/jvm/java-11-openjdk-amd64/bin/java 1111 auto mode
1 /usr/lib/jvm/java-11-openjdk-amd64/bin/java 1111 manual mode
2 /usr/lib/jvm/java-8-openjdk-amd64/jre/bin/java 1081 manual mode
Press to keep the current choice[*], or type selection number: 2
update-alternatives: using /usr/lib/jvm/java-8-openjdk-amd64/jre/bin/java to provide /usr/bin/java (java) in manual mode
$ java -version
openjdk version "1.8.0_362"
OpenJDK Runtime Environment (build 1.8.0_362-8u362-ga-0ubuntu1~20.04.1-b09)
OpenJDK 64-Bit Server VM (build 25.362-b09, mixed mode) JDK 切换后，成功编译出 system_webview_apk。
WebView 安装坑
编译出 system_webview_apk 后进行安装，出现如下错误：
Failure [INSTALL_FAILED_UPDATE_INCOMPATIBLE: Package com.android.webview signatures do not match previously installed version; ignoring!]
- Performing Streamed Install这是由于 Chromium 编译所使用的证书和 Android 10 的 platform 证书不一致导致的。解决这一问题的方法就是将两边的证书弄成一样。
第一步，查看 Android 10 中 weview.apk 的签名信息。使用压缩工具解压出 apk 中的 META-INF/WEBVIEW-.RSA 文件，然后使用如下命令查看签名信息：
$ keytool -printcert -file META-INF/WEBVIEW-.RSA第二步，确定 Android 10 使用的证书。一般使用 build/target/product/security/ 下的证书，也有的产品使用自定义的证书，一般放在 device 下的产品目录。如果确定呢？查看一下证书的签名信息，对得上就是的。
openssl x509 -in testkey.x509.pem -noout -fingerprint第三步，导入 keystore。Chromium 中使用的是 Java 应用的比较广的 keystore 格式，所以需要将 Android 10 中的证书导入进来。
# 私钥格式 pkcs8 转 PEM
$ openssl pkcs8 -inform DER -nocrypt -in $ANDROID_SOURCE/build/target/product/security/testkey.pk8 -out testkey.pem
# 证书从 PEM 转 pkcs12
$ openssl pkcs12 -export -in $ANDROID_SOURC/build/target/product/security/testkey.x509.pem -inkey testkey.pem -out testkey.p12 -name "android_testkey"
Enter Export Password: (输入密码android，默认是android，如是自己制作的key，输入对应的密码)
Verifying - Enter Export Password: (输入密码android)
# 生成 keystore
$ keytool -importkeystore -deststorepass android -destkeypass android -srckeystore testkey.p12 -srcstoretype pkcs12 -srcstorepass android -destkeystore AOSP.keystore -alias android_testkey第四步，修改 gn args，使用自己的 keystore，修改 out/Default/args.gn 文件，加入如下行：
# 假设 AOSP.keystore 文件位于 chromium src 目录下
android_keystore_path = "//AOSP.keystore"
android_keystore_name = "android_testkey"
android_keystore_password = "android"第五步，重新 build system_webview_apk
autoninja -C out/Default system_webview_apk再次安装，可以成功。
可以预料，后面还会继续踩坑。没办法，只能遇坑填坑，这不就是程序员的工作职责吗？
欢迎关注后续进展！