You need to enable JavaScript to run this app.
最新活动
大模型
产品
解决方案
定价
生态与合作
支持与服务
开发者
了解我们

iOS Safari中从非根路由安装的PWA导航后出现Safari UI控件的问题排查与解决咨询

iOS Safari中从非根路由安装的PWA导航后出现Safari UI控件的问题排查与解决咨询

问题描述

我最近在用Next.js开发一个Progressive Web App,在iOS Safari 26.2版本上测试时碰到了一个奇怪的体验问题:

  • 当从根路由/通过“添加到主屏幕”功能安装APP后,以独立模式运行时,所有导航操作都不会触发Safari的浏览器控件,体验完全符合预期;
  • 但如果先导航到/dashboard页面,再从这个页面完成“添加到主屏幕”的安装操作,之后在APP内导航到/messenger时,Safari的顶部地址栏和底部工具栏会短暂显示出来,直接破坏了独立模式的沉浸式体验。

而且这个问题只在从非根路由安装的场景下复现,从根路由安装就完全正常。

我已经完成的验证项

  • 确认是通过iOS官方的“添加到主屏幕”功能完成的PWA安装,并非直接在Safari浏览器中打开网页;
  • Web App Manifest配置文件中已明确设置display: standalone
  • 页面间的导航全部使用Next.js的客户端路由(未使用刷新页面的服务端跳转);
  • 仅在iOS Safari 26.2版本中能复现该问题,其他版本暂未发现类似情况。

想请教的问题

为什么从非根路由安装的PWA,在后续导航时会触发Safari浏览器控件的显示?有没有可靠的方法能确保,无论用户从哪个路由页面安装PWA,APP都能稳定保持在独立模式下运行?

火山引擎 最新活动