【报Bug】H5+ app targetSdkVersion 升级 36后，顶部安全距离失效，变成沉浸式头部了，退回35是正常的

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

好的，收到你的 bug 反馈。作为 DCloud 官方人员，我对这个反馈进行如下评审和分析：

1. 反馈质量评审

这个 bug 反馈的核心信息非常明确，但在复现条件上有所欠缺。

• BUG 标题与描述：标题和描述准确地概括了核心问题：升级 targetSdkVersion 到 36 后，顶部安全距离失效，变成了沉浸式头部，退回 35 则正常。描述清晰，我们官方人员能够看懂。
• 代码示例：缺失。虽然这是一个与云打包配置和系统版本相关的兼容性问题，但提供一个最简可复现的工程（或 manifest.json 中关于状态栏/沉浸式的配置片段，以及页面布局代码），能帮助我们更快速地定位是全局表现如此还是特定页面配置导致。
• 复现步骤：仅描述了“使用 targetSdkVersion 36 云打包”。对于这类兼容性排查，建议补充更详细的操作步骤，例如是否使用了自定义基座、页面是否设置了 navigationStyle: custom 等，以确保官方人员能够准确复现。
• 预期结果：“头部状态栏正常”是合理的预期。
• 实际结果：“状态栏遮挡住应用页面了”，属于功能异常，不是误报。
• 分类信息：比较完整。包含了 HBuilderX 版本（Alpha 5.22）、手机 OS 平台及版本（Android 16）、手机厂商（小米）和机型（红米 Note 13）。但缺少了 Vue 版本、页面类型（vue 或 nvue）和打包方式等信息，建议补充。

评审结论：反馈有效，方向明确。若能补充一个最简复现工程及完整的复现步骤，将极大提升问题处理的优先级和效率。

2. 问题分析与排查

根据反馈内容和知识库，这个问题的背景依据非常充分，且与 Android 系统升级带来的 API 行为变更高度相关：

• Android 16 (API 36) 的强变更：Google Play 要求新提交的应用必须以 Android 16（API 级别 36）或更高级别为目标平台。Android 系统在升级 targetSdkVersion 要求时，通常会强制启用某些边缘到边缘（Edge-to-edge）渲染策略，这会导致系统不再自动为状态栏预留顶部安全距离，从而出现页面被状态栏遮挡的“沉浸式”现象。
• 历史版本类似情况：在知识库中，我们发现在适配 Android 15（targetSdkVersion 35）时，DCloud 官方曾修复过“页面底部内容可能会被系统按键导航栏盖住的 Bug”（见 2025年01月02日发布——HBuilderX（4.44））。针对 Android 16（API 36），系统对顶部状态栏和底部安全区的处理策略进一步收紧，这很可能是触发你遇到的“顶部安全距离失效”的根因。
• 社区反馈印证：在 ask 社区中，也有其他开发者反馈了类似问题，例如 【报Bug】google 应用必须以 Android 16（API 级别 36） 或更高级别为目标平台，该反馈指出在 targetSdkVersion 升级到 36 后，底部安全区域的 env(safe-area-inset-bottom) 表现异常。这说明 API 36 确实带来了安全区域计算的整体变化。

3. 解决方案与建议

目前 HBuilderX 5.22 Alpha 版可能正处于对 Android 16 (API 36) 的适配阶段。在官方基座全面修复该兼容性问题前，你可以尝试以下临时处理方案：

1. 手动处理顶部安全区高度：
   如果你的页面使用了自定义导航栏（navigationStyle: custom），可以通过 uni.getSystemInfoSync().statusBarHeight 获取状态栏高度，并在页面顶部动态添加一个占位视图，将页面内容挤到状态栏下方。

   const sysInfo = uni.getSystemInfoSync();  
   const statusBarHeight = sysInfo.statusBarHeight;  

   本助手使用国产模型，生成代码可能不准确。专业的代码生成需要全球顶尖的AI Coding模型。推荐使用uni-agent

   <!-- 在页面顶部添加占位 -->  
   <view :style="{ height: statusBarHeight + 'px' }"></view>  

   本助手使用国产模型，生成代码可能不准确。专业的代码生成需要全球顶尖的AI Coding模型。推荐使用uni-agent

2. 使用 CSS 环境变量适配：
   尝试在 CSS 中使用 env(safe-area-inset-top) 来为顶部增加安全区内边距，看在 API 36 下是否能够生效：

   .custom-header {  
    padding-top: env(safe-area-inset-top);  
   }  

   本助手使用国产模型，生成代码可能不准确。专业的代码生成需要全球顶尖的AI Coding模型。推荐使用uni-agent

3. 关注官方更新：
   由于 Android 16 属于较新的系统版本，DCloud 官方会在后续的 HBuilderX 版级中持续优化和修复 targetSdkVersion 36 的兼容性问题。建议密切关注 HBuilderX 的更新日志。

如果上述步骤均无法解决，这很可能是一个需要底层引擎适配的 Bug。请将你的问题复现工程（可脱敏处理后）通过 issues 系统提交，并附上你的测试 APK，我们会进行深入排查。