Skip to content

fix(toolpkg): stop the parent WebView popup crash - #1506

Open
yoruuuchan wants to merge 1 commit into
AAswordman:devfrom
yoruuuchan:fix/toolpkg-webview-popup-crash
Open

yoruuuchan wants to merge 1 commit into
AAswordman:devfrom
yoruuuchan:fix/toolpkg-webview-popup-crash

Conversation

@yoruuuchan

@yoruuuchan yoruuuchan commented Nov 16, 2026 •

Copy link
Copy Markdown
Contributor

变更说明 / Description

侧边栏 ToolPkg 的 UI.WebView 在页面调用 window.open() 时会让整个 App 崩溃:onCreateWindow 把发起弹窗的父 WebView 自己塞进了 WebView.WebViewTransport,Chromium 判定为「父 WebView 承载自己的弹窗」,在主线程抛 IllegalArgumentException 直接杀进程。本 PR 不再伪造宿主,并默认关闭多窗口,window.open() 变成无操作而不是崩溃。

背景与动机 / Context and motivation

Issue #1434:任何使用 Compose DSL UI.WebView 的 ToolPkg,只要页面里有 window.open()(OAuth 登录、外链、分享都很常见)就会 100% 崩溃,属于通用问题。同文件 2258 行的 supportMultipleWindows 默认 true,保证每次调用都走到这段错误实现。

改动范围 / Changes

  • onCreateWindow 改为 return false,不再把父 WebView 交给 transport;保留 override 并加英文注释说明原因。
  • supportMultipleWindows 默认值从 true 改为 false,页面调用 window.open() 不再进入弹窗路径。
  • 不包含真正的弹窗承载(独立 WebView + Dialog 或新窗口)。按当前修复,弹窗请求会被丢弃,后续可以单独实现。
  • 未改动 javaScriptCanOpenWindowsAutomatically;多窗口关闭时它不参与弹窗路径,其他配置和加载流程保持不变。
  • 同文件另有 open PR fix(toolpkg): deliver WebView bridge arguments positionally #1424(fix/issue-1345-webview-js-bridge-args),它在本文档改的是 JS bridge 参数传递(约 70、166-225、1271-1410 行),与本 PR 改的 2019-2270 行不重叠,两个 PR 可以独立合并。

兼容性与风险 / Compatibility and risks

  • ToolPkg API:supportMultipleWindows 仍可显式传入,只是默认值由 true 变为 false。此前依赖默认值的插件本来就会崩溃,没有可用的旧行为被移除;显式开启的插件现在得到「不创建弹窗」而不是崩溃。
  • 页面加载、JS bridge、下载、文件选择等路径未改动。
  • 数据格式、安全、性能无影响。

关联 Issue / Related issue

Fixes #1434

#1315 报告的是同一个 IllegalArgumentException: Parent WebView cannot host its own popup window,疑似同根因;但该报告没有附出具体 WebView 调用点,本 PR 只修 Compose DSL 这一处,所以不自动关闭它。

验证方式 / Verification

检查或命令:
- git diff --check
- python -B ci/script/check_repo_hygiene.py --base upstream/dev --candidate HEAD
环境与变体:
- Windows + Python 3.12;未运行 Android 构建或单测(仓库 AGENTS.md 默认不跑编译/测试)
结果:
- git diff --check:无输出,退出码 0
- Repository hygiene: errors=0 warnings=0(1 个改动文件)
- CI(PR #1506 实际运行):Fast checks 通过(22s),Android JVM tests 通过(8m7s),Candidate checks 通过;Android build 按路径规则 skipping
- 未做真机验证:本机没有可用的 Android 设备和构建产物,window.open() 实测留给维护者/CI

证据 / Evidence

无(未在真机复现;修复点是单行逻辑,CI 会重新跑检查)。

检查清单 / Checklist

  • 我已记录可复现验证和未运行项原因 / Reproducible verification and reasons for unrun checks are recorded
  • 日常开发 PR 的目标分支为 dev;如目标为 main,我已说明这是维护者发布同步 / The target branch is dev for regular work; if it is main, I explained why this is a maintainer-led release sync
  • 我已确认 Candidate checks 覆盖改动范围,并会处理技术失败项 / Candidate checks covers the change scope and technical failures will be addressed
  • 最终 diff 无无关、临时、生成、二进制或敏感内容 / Final diff has no unrelated, temporary, generated, binary, or secret content
  • 已提供对应的回归、UI、文档/字符串或兼容性证据 / Relevant regression, UI, docs/strings, or compatibility evidence is provided

onCreateWindow handed the parent WebView back to Chromium as the popup
host, so every window.open() call threw
"IllegalArgumentException: Parent WebView cannot host its own popup
window" on the main thread and killed the app. Report the request as
unhandled instead, and default supportMultipleWindows to false so pages
that call window.open() become a no-op instead of a process crash.

Fixes AAswordman#1434

@CATMIAOZHI CATMIAOZHI left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

审计结论:✅ 批准合并

改动(1 个文件,+7/−6):修复 ToolPkg Compose DSL UI.WebView 在页面调用 window.open() 时整 App 崩溃的问题(Fixes #1434)——onCreateWindow 改为 return false、不再把父 WebView 自己塞进 WebViewTransport,同时 supportMultipleWindows 默认值由 true 改为 false。

通过的检查:

  • 根因判断正确:旧代码把发起弹窗的父 WebView 自身赋给 transport.webView,正是 Chromium 抛 IllegalArgumentException: Parent WebView cannot host its own popup window 的模式。已与项目内另外两处同类实现核对:BrowserWebViewSupport.kt(新建 popup session 承载)和 WebViewConfig.kt(新建 WebView(view?.context) 承载)都是新建 WebView 做宿主,只有本处把父 WebView 自己传了回去。
  • 双重防护合理:supportMultipleWindows 默认 false 后 onCreateWindow 正常不再被调用;显式传入 true 的插件仍由 return false 兜底,不再崩溃。
  • 兼容性说明属实:此前依赖默认值的插件本来就会 100% 崩溃,没有可用的旧行为被移除;supportMultipleWindows 仍可显式传入;examples/types/compose-dsl.d.ts 未写死该属性的默认值,无需同步文档。页面加载、JS bridge、下载、文件选择等路径未改动。
  • 与 #1424 无重叠:#1424 改的是同文件约 70、166-225、1271-1410 行的 JS bridge 参数传递,本 PR 改的是 2019-2270 行,可独立合并。
  • 目标分支为 dev,符合规范;单文件小改动,无无关内容;CI(Fast checks、Android JVM tests、Candidate checks)已通过。

问题:

  1. [P2] window.open() 被静默丢弃:当前实现既不记日志、也不触发任何事件回调,插件作者遇到 OAuth 登录"点开没反应"时无法区分是页面问题还是弹窗被丢弃。建议后续在 onCreateWindow 里记一条日志,或补一个 onWindowOpenRequest 回调供 ToolPkg 感知。不阻塞合并(作者已在 PR 描述中明确说明"弹窗请求会被丢弃,后续可以单独实现"这一取舍)。
  2. [question] 作者声明未做真机验证,window.open() 的实际行为留给维护者/CI。合并前是否方便在真机上验证一次:调用 window.open() 的页面不再崩溃、且原页面可继续正常使用?

后续可跟进(不阻塞):

  • 真正的弹窗承载(独立 WebView + Dialog 或新窗口)可后续单独实现,届时 supportMultipleWindows 默认值与 onCreateWindow 的 return false 需要一并改回。
  • #1315 报告的是同一个 IllegalArgumentException,作者已说明因缺少具体调用点而不自动关闭,维持现状即可。

由 水晴喵的muse 审计

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants