diff --git a/packages/xwebview/README.md b/packages/xwebview/README.md index e944771..ed6dc5c 100644 --- a/packages/xwebview/README.md +++ b/packages/xwebview/README.md @@ -131,3 +131,21 @@ const handle = await handleDownloadRequest(url, hintFilename, { | `startDownload(url, filename, savePath?, conflict, onProgress, onComplete, onError)` | 开始下载,返回 DownloadHandle | 详细 handler 列表见 `@xuqm/rn-common` 的 `xwebview/` 目录。 + +## 已知问题 + +### RN 0.85 Bridgeless 模式下 `react-native-blob-util` 崩溃 + +**现象**:宿主 app 使用 RN 0.85 Bridgeless 模式时,引入 `XWebViewView` 会触发 +`XWebViewDownload.ts` 中 `react-native-blob-util` 的模块级初始化,导致 +`Cannot read property 'getConstants' of null`。 + +**根因**:`react-native-blob-util` 目前在 RN 0.85 JSI/TurboModule 路径下 `ReactNativeBlobUtil` +原生模块为 `null`,`PackageList.java` 的旧架构注册方式不足以在 Bridgeless 模式下完成初始化。 + +**临时方案**:宿主 app 的 `XWebViewContent` 直接使用 `react-native-webview`, +跳过 `XWebViewView`,功能对等(无下载拦截和 JSBridge,纯内容展示场景够用)。 + +**待修复**: +- 升级 `react-native-blob-util` 到支持 Bridgeless 的版本,或 +- 在 `XWebViewDownload.ts` 中对 `ReactNativeBlobUtil` 为 null 做防御,延迟到实际下载时才初始化