6***@qq.com
6***@qq.com
  • 发布:2026-07-30 23:45
  • 更新:2026-07-30 23:46
  • 阅读:45

【报Bug】小米15页面底部全部会有留白,其他安卓机型没有

分类:uni-app

产品分类: uniapp/App

PC开发环境操作系统: Windows

PC开发环境操作系统版本号: 26.2

HBuilderX类型: 正式

HBuilderX版本号: 5.14

手机系统: Android

手机系统版本号: Android 15

手机厂商: 小米

手机机型: 小米15pro

页面类型: vue

vue版本: vue3

打包方式: 云端

项目创建方式: HBuilderX

App下载地址或H5⽹址: https://m.malink.cn/s/UvUJbi

示例代码:

见下面的app下载链接

操作步骤:

预期结果:

无留白

实际结果:

bug描述:

HBuilderX为5.14,app-plus配置如下,targetSdkVersion为30

"app-plus" : {  
        "usingComponents" : true,  
        "nvueStyleCompiler" : "uni-app",  
        "compilerVersion" : 3,  
        "safearea" : {  
            "background" : "#fff7ed",  
            "bottom" : {  
                "offset" : "none"  
            }  
        },  
        "distribute" : {  
            "android" : {  
                "packagename" : "...",  
                "permissions" : [...],  
                "abiFilters" : [ "arm64-v8a" ],  
                "targetSdkVersion" : 30  
            }       
        }  
    },

相关页面也都使用了env(safe-area-inset-bottom) 来处理安全区

2026-07-30 23:45 负责人:无 分享
已邀请:
Ask小助手

Ask小助手 - Ask社区AI助手

欢迎到专业群( uni-app 官方技术交流群 1 ) 咨询,群中有相关专业的管理员和群友。

针对您反馈的 Bug,我们进行了评审分析,具体结论如下:

1. Bug 反馈内容完整性分析

  • BUG 描述:描述较为清晰,指出了特定机型(小米15 Pro)在 Android 15 系统下页面底部出现留白,且提供了 manifest.json 中的 app-plus 相关配置以及页面使用了 env(safe-area-inset-bottom) 的信息。
  • 代码示例:提供的配置代码片段有助于了解您的安全区配置方式,但缺少可直接运行复现问题的完整测试工程。由于底部留白问题往往与具体的页面结构、CSS 样式写法(如 height: 100vh 等)强相关,仅凭配置片段难以直接定位。
  • 复现步骤:填写为“无”。这会导致官方研发人员无法根据有效步骤快速复现该现象,建议补充详细的操作路径(如从哪个页面进入、具体操作动作等)。
  • 预期结果与实际结果:预期结果为“无留白”,实际结果填写为“无”,未能客观描述实际看到的留白现象(如留白颜色、大小、是否遮挡内容等)。
  • 分类信息:完整提供了 HBuilderX 版本、手机系统版本、机型、Vue 版本等信息,符合要求。

2. Bug 是否成立及原因分析

结合知识库信息,该问题有一定的平台背景原因,但也需要进一步验证您的项目配置:

  • Android 15 无边框画面特性影响:根据 Android 15 的系统特性,以 targetSdkVersion 35 为目标平台的应用在默认情况下都将采用无边框画面(Edge-to-edge),页面底部内容可能会被系统按键导航栏盖住。官方在 HBuilderX 4.44 版本的更新日志中提到:“修复配置 targetSdkVersion 为 35 后在安卓15设备页面底部内容可能会被系统按键导航栏盖住的 Bug”。
  • targetSdkVersion 版本过低:您当前项目配置的 targetSdkVersion 为 30。在 Android 15 系统中,由于系统强制启用了无边框显示策略,较低版本的 targetSdkVersion 可能会导致系统安全区与页面 env(safe-area-inset-bottom) 计算出现偏差,从而产生底部留白或被遮挡的现象。

3. 建议与改进方案

  • 补充复现工程:为了准确判断是框架渲染问题还是样式适配问题,请您提供一个最小化可复现的完整测试工程,并详细填写复现步骤和实际留白现象。
  • 升级 targetSdkVersion:建议您尝试将 manifest.json 中的 targetSdkVersion 升级至 35,并使用较新版本的 HBuilderX 重新打包测试,观察是否能够正确处理底部安全区。
  • 检查页面样式:请排查页面中是否使用了 height: 100vhposition: fixed 等可能导致在安全区计算时产生留白的样式,建议使用 flex 布局让内容自然撑满,配合 env(safe-area-inset-bottom) 进行动态 padding 计算。

请您补充完整的复现工程和步骤后再次提交,以便我们进一步排查确认。

内容为 AI 生成,仅供参考

要回复问题请先登录注册