WebToApp 双引擎终极解析browser_kernel.c 如何统一 WebView 与 GeckoView 的行为【免费下载链接】web-to-appThe most full featured web-to-app toolkit on Android, a complete APK workshop that runs entirely on your phone项目地址: https://gitcode.com/GitHub_Trending/web/web-to-appWebToApp 是一款功能最全的 Android「Web 转 App」工具包你可以在手机上把任意网站打包成独立 APK。它内置了双引擎抽象层系统 WebView 和 GeckoViewFirefox 内核由原生文件 browser_kernel.c 和 Kotlin 门面 BrowserKernel.kt 统一两者的行为差异让上层界面完全不感知底层用的是哪个内核。一、为什么需要双引擎抽象Android 上常见的网页容器只有系统 WebViewChromium 系但它的「指纹」特征明显User-Agent 里带着wv标记页面上还能通过navigator.webdriver、window.chrome缺失等信号判断出自己跑在 WebView 里一些网站会因此降权甚至拒绝服务。WebToApp 的解法是引入第二条腿——可下载约 80MB的 GeckoView 运行时见 EngineType.kt引擎特点体积系统 WebView免下载功能最全广告拦截、用户脚本、NativeBridge0 MBGeckoView (Firefox)货真价实的 Firefox 指纹原生 ECH/TRR≈80 MB问题随之而来两个引擎的 API 完全不同——WebView 有addJavascriptInterface、请求拦截GeckoView 没有GeckoView 有原生媒体会话WebView 要靠WebChromeClient。如果上层代码写if (isGecko) ... else ...几百处分支会立刻失控。双引擎抽象就是为此而生的把两个引擎压缩成一个统一接口。二、统一接口BrowserEngine 与 BrowserSurface2.1 一个接口抹平两个内核BrowserEngine.kt 定义了所有引擎必须实现的最小契约loadUrl、goBack/canGoBack、evaluateJavascript、clearCache等 10 来个方法。GeckoView 侧由 GeckoViewEngine.kt 实现系统 WebView 侧则由WebViewManager直接承担。创建引擎统一走 EngineManager.kt 的createEngine(type, adBlocker)宿主 UI 只认识EngineType枚举不认识具体实现。2.2 BrowserSurface上层唯一接触点真正让「行为一致」落地的是 BrowserSurface.kt——一个同时持有WebView?和BrowserEngine?的门面类。所有操作都是同一个套路fun goBack() { engine?.goBack() ?: webView?.goBack() }前进/后退、页内查找findInPage、JS 执行、生命周期onResume/onPause、销毁回收全部走这一层。上层无论是浏览器界面 ShellActivity 还是导出的独立 App 壳调用方式完全相同——这就是「统一行为」的第一层含义调用面统一。三、browser_kernel.cC 语言层的双引擎行为内核如果说BrowserSurface统一的是「怎么调」那 browser_kernel.c 统一的是「长什么样」——它负责让任意引擎里的页面在指纹探测眼里都一致。3.1 内核 JS一段内置的指纹伪装脚本文件里最重的部分是第 9~327 行的一段约 300 行 JSKERNEL_JS。它被编译进.so页面加载后注入执行做四件关键事抹掉自动化/容器痕迹navigator.webdriver恒为false删除__selenium_unwrapped、__webdriver_evaluate等数十个自动化标记L29-L51伪造 Chrome 运行时补齐window.chrome.app/runtime/loadTimes/csi、navigator.plugins五个 PDF 插件、navigator.vendor Google Inc.L99-L157加固伪装HookFunction.prototype.toString让被替换过的函数仍显示[native code]连Error.prepareStackTrace里的WebView/wv字样都会替换成chromeL297-L325补齐硬件画像hardwareConcurrency、deviceMemory、WebGL 渲染器伪装成 Adreno 640等避免低端机参数暴露。3.2 原生 UA 清洗sanitize_user_agentL329-L374用纯 C 逐字符扫描剔除 WebView 特有的wv标记和Version/x.x段nativeBuildChromeUserAgent进一步把不含Chrome/的 UA 改写为Chrome/131.0.0.0产出一个看起来就是桌面/手机 Chrome 的 User-Agent。3.3 优雅降级没有 .so 也能跑Kotlin 侧 BrowserKernel.kt 在init中System.loadLibrary(browser_kernel)失败时不崩溃而是自动回退UA 清洗走 Kotlin 正则版L154-L168内核 JS 走精简版L170-L194。同一份伪装能力原生优先、Kotlin 兜底——这是第二层「行为统一」。四、同一策略在两种引擎下的落地差异抽象层统一了行为但并非抹掉一切。设计上的核心取舍是能力系统 WebViewGeckoView指纹伪装内核 JS UA 清洗✅ 主战场➖ 不需要——它本就是真 Firefox广告拦截 / 用户脚本 / Chrome 扩展✅❌ 依赖请求拦截与 JS 注入ECH加密 SNI经本地 MITM 桥✅ 内核原生 TRR ECHTLS 指纹可伪装MITM 桥原生 Firefox JA3「最强伪装」换句话说系统 WebView 引擎靠 browser_kernel.c「装成 Chrome」GeckoView 引擎靠内核本身「就是 Firefox」两条路线殊途同归——网站看到的始终是一个可信的浏览器。完整的特性对照与选型建议见官方文档 browser-kernel.md。五、总结4 层架构一套心智模型接口层BrowserEngine定契约两个内核各自实现 门面层BrowserSurface让上层代码零分支 原生层browser_kernel.c提供指纹 JS UA 清洗Kotlin 兜底 策略层WebView 伪装成 ChromeGeckoView 保持真身想上手体验通过⋮ → 浏览器内核下载 GeckoView 运行时BrowserKernelScreen.kt再在构建 APK 对话框中选择内核即可BuildApkScreen.kt。依赖广告拦截、用户脚本或资源加密打包选系统 WebView需要真实 Firefox 指纹选 GeckoView——而无论选哪个WebToApp 给你的行为都是一致的。【免费下载链接】web-to-appThe most full featured web-to-app toolkit on Android, a complete APK workshop that runs entirely on your phone项目地址: https://gitcode.com/GitHub_Trending/web/web-to-app创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 WebToApp 双引擎终极解析：browser_kernel.c 如何统一 WebView 与 GeckoView 的行为
WebToApp 双引擎终极解析browser_kernel.c 如何统一 WebView 与 GeckoView 的行为【免费下载链接】web-to-appThe most full featured web-to-app toolkit on Android, a complete APK workshop that runs entirely on your phone项目地址: https://gitcode.com/GitHub_Trending/web/web-to-appWebToApp 是一款功能最全的 Android「Web 转 App」工具包你可以在手机上把任意网站打包成独立 APK。它内置了双引擎抽象层系统 WebView 和 GeckoViewFirefox 内核由原生文件 browser_kernel.c 和 Kotlin 门面 BrowserKernel.kt 统一两者的行为差异让上层界面完全不感知底层用的是哪个内核。一、为什么需要双引擎抽象Android 上常见的网页容器只有系统 WebViewChromium 系但它的「指纹」特征明显User-Agent 里带着wv标记页面上还能通过navigator.webdriver、window.chrome缺失等信号判断出自己跑在 WebView 里一些网站会因此降权甚至拒绝服务。WebToApp 的解法是引入第二条腿——可下载约 80MB的 GeckoView 运行时见 EngineType.kt引擎特点体积系统 WebView免下载功能最全广告拦截、用户脚本、NativeBridge0 MBGeckoView (Firefox)货真价实的 Firefox 指纹原生 ECH/TRR≈80 MB问题随之而来两个引擎的 API 完全不同——WebView 有addJavascriptInterface、请求拦截GeckoView 没有GeckoView 有原生媒体会话WebView 要靠WebChromeClient。如果上层代码写if (isGecko) ... else ...几百处分支会立刻失控。双引擎抽象就是为此而生的把两个引擎压缩成一个统一接口。二、统一接口BrowserEngine 与 BrowserSurface2.1 一个接口抹平两个内核BrowserEngine.kt 定义了所有引擎必须实现的最小契约loadUrl、goBack/canGoBack、evaluateJavascript、clearCache等 10 来个方法。GeckoView 侧由 GeckoViewEngine.kt 实现系统 WebView 侧则由WebViewManager直接承担。创建引擎统一走 EngineManager.kt 的createEngine(type, adBlocker)宿主 UI 只认识EngineType枚举不认识具体实现。2.2 BrowserSurface上层唯一接触点真正让「行为一致」落地的是 BrowserSurface.kt——一个同时持有WebView?和BrowserEngine?的门面类。所有操作都是同一个套路fun goBack() { engine?.goBack() ?: webView?.goBack() }前进/后退、页内查找findInPage、JS 执行、生命周期onResume/onPause、销毁回收全部走这一层。上层无论是浏览器界面 ShellActivity 还是导出的独立 App 壳调用方式完全相同——这就是「统一行为」的第一层含义调用面统一。三、browser_kernel.cC 语言层的双引擎行为内核如果说BrowserSurface统一的是「怎么调」那 browser_kernel.c 统一的是「长什么样」——它负责让任意引擎里的页面在指纹探测眼里都一致。3.1 内核 JS一段内置的指纹伪装脚本文件里最重的部分是第 9~327 行的一段约 300 行 JSKERNEL_JS。它被编译进.so页面加载后注入执行做四件关键事抹掉自动化/容器痕迹navigator.webdriver恒为false删除__selenium_unwrapped、__webdriver_evaluate等数十个自动化标记L29-L51伪造 Chrome 运行时补齐window.chrome.app/runtime/loadTimes/csi、navigator.plugins五个 PDF 插件、navigator.vendor Google Inc.L99-L157加固伪装HookFunction.prototype.toString让被替换过的函数仍显示[native code]连Error.prepareStackTrace里的WebView/wv字样都会替换成chromeL297-L325补齐硬件画像hardwareConcurrency、deviceMemory、WebGL 渲染器伪装成 Adreno 640等避免低端机参数暴露。3.2 原生 UA 清洗sanitize_user_agentL329-L374用纯 C 逐字符扫描剔除 WebView 特有的wv标记和Version/x.x段nativeBuildChromeUserAgent进一步把不含Chrome/的 UA 改写为Chrome/131.0.0.0产出一个看起来就是桌面/手机 Chrome 的 User-Agent。3.3 优雅降级没有 .so 也能跑Kotlin 侧 BrowserKernel.kt 在init中System.loadLibrary(browser_kernel)失败时不崩溃而是自动回退UA 清洗走 Kotlin 正则版L154-L168内核 JS 走精简版L170-L194。同一份伪装能力原生优先、Kotlin 兜底——这是第二层「行为统一」。四、同一策略在两种引擎下的落地差异抽象层统一了行为但并非抹掉一切。设计上的核心取舍是能力系统 WebViewGeckoView指纹伪装内核 JS UA 清洗✅ 主战场➖ 不需要——它本就是真 Firefox广告拦截 / 用户脚本 / Chrome 扩展✅❌ 依赖请求拦截与 JS 注入ECH加密 SNI经本地 MITM 桥✅ 内核原生 TRR ECHTLS 指纹可伪装MITM 桥原生 Firefox JA3「最强伪装」换句话说系统 WebView 引擎靠 browser_kernel.c「装成 Chrome」GeckoView 引擎靠内核本身「就是 Firefox」两条路线殊途同归——网站看到的始终是一个可信的浏览器。完整的特性对照与选型建议见官方文档 browser-kernel.md。五、总结4 层架构一套心智模型接口层BrowserEngine定契约两个内核各自实现 门面层BrowserSurface让上层代码零分支 原生层browser_kernel.c提供指纹 JS UA 清洗Kotlin 兜底 策略层WebView 伪装成 ChromeGeckoView 保持真身想上手体验通过⋮ → 浏览器内核下载 GeckoView 运行时BrowserKernelScreen.kt再在构建 APK 对话框中选择内核即可BuildApkScreen.kt。依赖广告拦截、用户脚本或资源加密打包选系统 WebView需要真实 Firefox 指纹选 GeckoView——而无论选哪个WebToApp 给你的行为都是一致的。【免费下载链接】web-to-appThe most full featured web-to-app toolkit on Android, a complete APK workshop that runs entirely on your phone项目地址: https://gitcode.com/GitHub_Trending/web/web-to-app创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考