uni-app 在ios 18无法 适配ios底部黑色条

uni-app 在ios 18无法 适配ios底部黑色条

类别 信息
产品分类 uniapp/App
PC开发环境 Windows
PC版本号 22H2
HBuilderX 正式
HBuilderX版本 4.76
手机系统 iOS
手机版本号 iOS 18
手机厂商 苹果
手机机型 16pro
页面类型 vue
vue版本 vue3
打包方式 云端
项目创建方式 HBuilderX
App下载地址 https://sale-test.profly.com.cn/

操作步骤:

正常demo项目在app无法适配底部黑色条 H5是可以的

预期结果:

适配ios底部黑色条

实际结果:

无法 适配ios底部黑色条

bug描述:

在uni-app 开发的项目发布到app上后底部有一个小黑边没用完全沾满高度,我排查了一下不是我的代码样式导致的,希望官方可以修复这个问题,适配ios底部黑色条


更多关于uni-app 在ios 18无法 适配ios底部黑色条的实战教程也可以访问 https://www.itying.com/category-93-b0.html

1 回复

更多关于uni-app 在ios 18无法 适配ios底部黑色条的实战教程也可以访问 https://www.itying.com/category-93-b0.html


针对 iOS 18 底部黑色条未完全适配的问题,这通常是由于安全区域(Safe Area)未正确配置导致的。以下是解决方案:

  1. 检查 manifest.json 配置
    app-plussafearea 节点中确认配置:

    "safearea": {
      "bottom": {
        "offset": "none"
      }
    }
    

    若配置为 "offset": "auto",底部安全区域会被预留,导致黑边。

  2. 使用 CSS 环境变量
    在页面的样式表中添加:

    page {
      padding-bottom: constant(safe-area-inset-bottom); /* iOS < 11.2 */
      padding-bottom: env(safe-area-inset-bottom); /* iOS >= 11.2 */
    }
    

    或对特定元素应用 padding-bottom: env(safe-area-inset-bottom)

  3. 检查页面结构
    确保页面根元素或滚动容器未设置固定高度(如 height: 100vh),建议改用 min-height: 100vh 并结合 box-sizing: border-box

  4. 更新 HBuilderX 与基座

    • 升级 HBuilderX 至最新版本(当前 4.76 可能未完全适配 iOS 18)。
    • 使用自定义基座测试,确保使用最新的 iOS 安全区域适配逻辑。
  5. 原生层配置
    若问题仍存在,在 pages.json 中全局或单独页面配置:

    "style": {
      "app-plus": {
        "safearea": "bottom"
      }
    }
回到顶部