iOS14刘海屏安全区适配后Cordova10应用仍出现白屏空白问题咨询
问题根因
这是Cordova iOS 6.1.x在iOS14系统上的共性布局问题,单靠前端层的viewport适配标签无法解决,所有布局偏移问题都出在原生层的约束逻辑上。
- Cordova 6.1.x 版本默认初始化WKWebView时,会遵循iOS14的安全区规则自动限制WebView的显示范围,就算前端配置了
viewport-fit=cover,WebView本身并没有延伸到刘海下方的非安全区域,自然会在刘海下方留出大块空白。 - 当前使用的6.0.0版本
cordova-plugin-splashscreen存在已知bug:启动页加载完成时,会强制把WebView的顶部位置对齐到安全区的下边界,直接把整个WebView往下偏移了刘海对应的高度。 - 配置里开启的
SplashMaintainAspectRatio=true会放大这个bug:启动页按比例缩放完成后,不会自动重置WebView的frame尺寸,直接把启动页阶段的偏移布局参数带到正式页面加载阶段。
修复操作步骤
- 调整原生WebView布局逻辑
打开Xcode项目中的MainViewController.m,在WebView初始化完成的位置,添加代码关闭系统自动调整安全区边距的逻辑:self.webView.scrollView.contentInsetAdjustmentBehavior = UIScrollViewContentInsetAdjustmentNever;
同时把WebView的AutoLayout约束修改为对齐父控制器View的上下左右四边,不要对齐系统提供的safeAreaLayoutGuide,确保WebView本身可以延伸到屏幕边缘,完整覆盖刘海对应的非安全区域。 - 修正启动页插件配置冲突
把config.xml文件中的SplashMaintainAspectRatio参数值修改为false,同时将SplashScreenDelay从3000ms调整到500ms以下。当前版本的启动页插件在长延迟场景下会触发布局偏移bug,就算启动页完全消失,WebView的偏移状态也不会被自动纠正。 - 补全前端页面基础样式
仅靠meta标签的适配配置不足以解决问题,需要在全局样式中强制去掉页面的默认边距,确保页面渲染尺寸和WebView的实际尺寸完全匹配:
之后手动给页面内的交互内容区添加对应安全区的内边距即可,不需要依赖系统自动给WebView预留安全空间。html, body { width: 100%; height: 100%; margin: 0; padding: 0; overflow: hidden; } - 排查第三方插件的布局干扰
安装的*@globules-io/cordova-plugin-ios-xhr 1.1.0* 版本在iOS14上存在布局兼容问题:WebView加载完成后会额外添加一层按安全区范围计算的透明覆盖层,直接遮挡刘海下方的页面内容。临时处理方式是把该插件降级到1.0.9版本,或者升级到修复了布局逻辑的1.2.0以上版本。
内容的提问来源于stack exchange,提问作者user13824155
相关产品推荐
相关产品推荐

